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

76 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
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command.
2020-03-01 17:37:31 -05:00
Preserve block devices, character devices, sockets and FIFOs.
Implies
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 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
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command.
2020-03-01 17:37:31 -05:00
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.