midfavila/sbase
1
0
Fork 0
Code Issues Pull Requests Projects Releases 1 Wiki Activity
f3d05ffd0a
sbase/cp.1

75 lines
1.1 KiB
Groff
Raw Normal View History

Use ISO-date-format in manpages The one specified by mdoc is hard to read for non-native speakers from countries which read the date day-first (like Germany, Greece, North-Korea, Swamp,...). This is also consistent with how we generally specify dates at suckless.org.
2015-10-08 11:15:08 -04:00
.Dd 2015-10-08
remove sbase-VERSION from man page, fix sponge.1 date
2015-01-31 08:20:02 -05:00
.Dt CP 1
Add .Os sbase and sed replace to .Os sbase $(VERSION) in make install
2015-01-31 14:37:03 -05:00
.Os sbase
cp.1: convert to mandoc, add mv(1) to SEE ALSO
2015-01-30 16:07:17 -05:00
.Sh NAME
.Nm cp
.Nd copy files and directories
.Sh SYNOPSIS
.Nm
cp: Update program usage and manpages Do not document the non-standard -r flag as it is highly discouraged. It is still silently accepted and treated the same as -R.
2015-02-17 11:13:45 -05:00
.Op Fl afpv
.Oo
.Fl R
.Op Fl H | L | P
.Oc
cp.1: source and dest are not optional Signed-off-by: Mattias Andrée <maandree@kth.se>
2017-01-29 16:17:09 -05:00
.Ar source ...
.Ar dest
cp.1: convert to mandoc, add mv(1) to SEE ALSO
2015-01-30 16:07:17 -05:00
.Sh DESCRIPTION
.Nm
Audit cp(1) 1) Refactor the manpage, which has been a bloody mess, documenting fantasy-flags (-d for example) and add a STANDARDS section 2) fix usage() 3) sort ARG-block 4) Check return-value of stat() separately, so a lack of permissions doesn't tell the user "the directory doesn't exist", which could be a bit confusing. 5) Add empty line before return.
2015-03-02 13:15:19 -05:00
copies
.Ar source
to
.Ar dest .
If more than one
.Ar source
is given
.Ar dest
has to be a directory.
cp.1: convert to mandoc, add mv(1) to SEE ALSO
2015-01-30 16:07:17 -05:00
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl a
Audit cp(1) 1) Refactor the manpage, which has been a bloody mess, documenting fantasy-flags (-d for example) and add a STANDARDS section 2) fix usage() 3) sort ARG-block 4) Check return-value of stat() separately, so a lack of permissions doesn't tell the user "the directory doesn't exist", which could be a bit confusing. 5) Add empty line before return.
2015-03-02 13:15:19 -05:00
Preserve block devices, character devices, sockets and FIFOs. Implies
.Fl p ,
.Fl P
cp.1: convert to mandoc, add mv(1) to SEE ALSO
2015-01-30 16:07:17 -05:00
and
Audit cp(1) 1) Refactor the manpage, which has been a bloody mess, documenting fantasy-flags (-d for example) and add a STANDARDS section 2) fix usage() 3) sort ARG-block 4) Check return-value of stat() separately, so a lack of permissions doesn't tell the user "the directory doesn't exist", which could be a bit confusing. 5) Add empty line before return.
2015-03-02 13:15:19 -05:00
.Fl R .
man pages: improve consistency
2015-02-01 14:52:28 -05:00
.It Fl f
Audit cp(1) 1) Refactor the manpage, which has been a bloody mess, documenting fantasy-flags (-d for example) and add a STANDARDS section 2) fix usage() 3) sort ARG-block 4) Check return-value of stat() separately, so a lack of permissions doesn't tell the user "the directory doesn't exist", which could be a bit confusing. 5) Add empty line before return.
2015-03-02 13:15:19 -05:00
If an existing
.Ar dest
cannot be opened, remove it and try again.
cp: Update program usage and manpages Do not document the non-standard -r flag as it is highly discouraged. It is still silently accepted and treated the same as -R.
2015-02-17 11:13:45 -05:00
.It Fl p
Preserve mode, timestamp and permissions.
.It Fl v
Audit cp(1) 1) Refactor the manpage, which has been a bloody mess, documenting fantasy-flags (-d for example) and add a STANDARDS section 2) fix usage() 3) sort ARG-block 4) Check return-value of stat() separately, so a lack of permissions doesn't tell the user "the directory doesn't exist", which could be a bit confusing. 5) Add empty line before return.
2015-03-02 13:15:19 -05:00
Write "'source' -> 'dest'" for each
.Ar source
to stdout.
cp.1: symlink dereferencing flags
2015-02-09 16:11:06 -05:00
.It Fl H
Audit cp(1) 1) Refactor the manpage, which has been a bloody mess, documenting fantasy-flags (-d for example) and add a STANDARDS section 2) fix usage() 3) sort ARG-block 4) Check return-value of stat() separately, so a lack of permissions doesn't tell the user "the directory doesn't exist", which could be a bit confusing. 5) Add empty line before return.
2015-03-02 13:15:19 -05:00
Dereference
.Ar source
if it is a symbolic link.
cp.1: symlink dereferencing flags
2015-02-09 16:11:06 -05:00
.It Fl L
Audit cp(1) 1) Refactor the manpage, which has been a bloody mess, documenting fantasy-flags (-d for example) and add a STANDARDS section 2) fix usage() 3) sort ARG-block 4) Check return-value of stat() separately, so a lack of permissions doesn't tell the user "the directory doesn't exist", which could be a bit confusing. 5) Add empty line before return.
2015-03-02 13:15:19 -05:00
Dereference all symbolic links.
cp: Default to -P when -R is specified POSIX only specifies the -H, -L, and -P options for use with -R, and the default is left to the implementation. Without -R, symlinks must be followed. Most implementations use -P as the default with -R, which makes sense to me as default behavior (the source and destination trees are the same). Since we use the same code for -R and without it, and we allow -H, -L, and -P without -R, set the default based on the presence of -R. Without it, use -L as before, as required by POSIX, and with it, use -P to match the behavior of other implementations.
2019-12-22 00:08:36 -05:00
This is the default without
.Fl R .
cp.1: convert to mandoc, add mv(1) to SEE ALSO
2015-01-30 16:07:17 -05:00
.It Fl P
Audit cp(1) 1) Refactor the manpage, which has been a bloody mess, documenting fantasy-flags (-d for example) and add a STANDARDS section 2) fix usage() 3) sort ARG-block 4) Check return-value of stat() separately, so a lack of permissions doesn't tell the user "the directory doesn't exist", which could be a bit confusing. 5) Add empty line before return.
2015-03-02 13:15:19 -05:00
Preserve symbolic links.
cp: Default to -P when -R is specified POSIX only specifies the -H, -L, and -P options for use with -R, and the default is left to the implementation. Without -R, symlinks must be followed. Most implementations use -P as the default with -R, which makes sense to me as default behavior (the source and destination trees are the same). Since we use the same code for -R and without it, and we allow -H, -L, and -P without -R, set the default based on the presence of -R. Without it, use -L as before, as required by POSIX, and with it, use -P to match the behavior of other implementations.
2019-12-22 00:08:36 -05:00
This is the default with
.Fl R .
Audit cp(1) 1) Refactor the manpage, which has been a bloody mess, documenting fantasy-flags (-d for example) and add a STANDARDS section 2) fix usage() 3) sort ARG-block 4) Check return-value of stat() separately, so a lack of permissions doesn't tell the user "the directory doesn't exist", which could be a bit confusing. 5) Add empty line before return.
2015-03-02 13:15:19 -05:00
.It Fl R
Traverse directories recursively. If this flag is not specified, directories
are not copied.
cp.1: convert to mandoc, add mv(1) to SEE ALSO
2015-01-30 16:07:17 -05:00
.El
.Sh SEE ALSO
.Xr mv 1
Audit cp(1) 1) Refactor the manpage, which has been a bloody mess, documenting fantasy-flags (-d for example) and add a STANDARDS section 2) fix usage() 3) sort ARG-block 4) Check return-value of stat() separately, so a lack of permissions doesn't tell the user "the directory doesn't exist", which could be a bit confusing. 5) Add empty line before return.
2015-03-02 13:15:19 -05:00
.Sh STANDARDS
The
.Nm
utility is compliant with the
POSIX 2013 audit Mostly manpage-shuffling according to the changes in the corrigendum, wording changes and more idiomatic expressions. All this is finished up by marking the POSIX 2013 conformant tools with .St -p1003.1-2013 which is not available in older mandoc builds or nroff, but which reflects what we actually did, so who cares? This is a huge step and it's not far until we can release sbase 0.1.
2015-03-27 12:22:48 -04:00
.St -p1003.1-2013
Audit cp(1) 1) Refactor the manpage, which has been a bloody mess, documenting fantasy-flags (-d for example) and add a STANDARDS section 2) fix usage() 3) sort ARG-block 4) Check return-value of stat() separately, so a lack of permissions doesn't tell the user "the directory doesn't exist", which could be a bit confusing. 5) Add empty line before return.
2015-03-02 13:15:19 -05:00
specification except from the
.Op Fl i
flag.
.Pp
POSIX 2013 audit Mostly manpage-shuffling according to the changes in the corrigendum, wording changes and more idiomatic expressions. All this is finished up by marking the POSIX 2013 conformant tools with .St -p1003.1-2013 which is not available in older mandoc builds or nroff, but which reflects what we actually did, so who cares? This is a huge step and it's not far until we can release sbase 0.1.
2015-03-27 12:22:48 -04:00
The
Audit cp(1) 1) Refactor the manpage, which has been a bloody mess, documenting fantasy-flags (-d for example) and add a STANDARDS section 2) fix usage() 3) sort ARG-block 4) Check return-value of stat() separately, so a lack of permissions doesn't tell the user "the directory doesn't exist", which could be a bit confusing. 5) Add empty line before return.
2015-03-02 13:15:19 -05:00
.Op Fl av
POSIX 2013 audit Mostly manpage-shuffling according to the changes in the corrigendum, wording changes and more idiomatic expressions. All this is finished up by marking the POSIX 2013 conformant tools with .St -p1003.1-2013 which is not available in older mandoc builds or nroff, but which reflects what we actually did, so who cares? This is a huge step and it's not far until we can release sbase 0.1.
2015-03-27 12:22:48 -04:00
flags are an extension to that specification.
Reference in New Issue Copy Permalink