suckless
/
sbase
mirror of git://git.suckless.org/sbase
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
sbase/chown.1

62 lines
839 B
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 15:15:08 +00:00
.Dd 2015-10-08
remove sbase-VERSION from man page, fix sponge.1 date
2015-01-31 13:20:02 +00:00
.Dt CHOWN 1
Add .Os sbase and sed replace to .Os sbase $(VERSION) in make install
2015-01-31 19:37:03 +00:00
.Os sbase
add some mandoc pages and fix some warnings - add .Os, it is mandatory. - don't redeclare .Nm when it's not needed. - fix some warnings (checked with mandoc -Tlint). - remove some leftover old stuff.
2015-01-30 20:17:58 +00:00
.Sh NAME
.Nm chown
.Nd change file ownership
.Sh SYNOPSIS
.Nm
chown: Update program usage and manpage
2015-02-17 16:41:58 +00:00
.Op Fl h
.Oo
.Fl R
.Op Fl H | L | P
.Oc
chown: fix user:group option parsing Check that either user or group is correctly passed, and adapt documention according to that.
2015-12-21 18:37:10 +00:00
.Ar owner Ns Op Pf : Op Ar group
.Op Ar file ...
.Nm
.Op Fl h
.Oo
.Fl R
.Op Fl H | L | P
.Oc
.Pf : Ar group
add some mandoc pages and fix some warnings - add .Os, it is mandatory. - don't redeclare .Nm when it's not needed. - fix some warnings (checked with mandoc -Tlint). - remove some leftover old stuff.
2015-01-30 20:17:58 +00:00
.Op Ar file ...
.Sh DESCRIPTION
.Nm
chown: fix user:group option parsing Check that either user or group is correctly passed, and adapt documention according to that.
2015-12-21 18:37:10 +00:00
sets the user and/or group id of each
Audit chown(1) Similar to the chgrp(1)-audit: 1) Refactor manpage so it's actually fun to read 2) BUGFIX: Call (l)chown properly when the H-flag is specified (only when depth > 0) 3) BUGFIX: Call (l)chown properly when the h-flag is specified (only when depth = 0). 4) BUGFIX: Only recurse() in chgrp() when the initial chownf() succeeds. 5) Style fixes, argv-basing. 6) Rename status to ret for consistency. 7) Add blank line before return.
2015-03-08 23:37:34 +00:00
.Ar file
to the uid of
.Ar owner
chown: fix user:group option parsing Check that either user or group is correctly passed, and adapt documention according to that.
2015-12-21 18:37:10 +00:00
and/or the gid of
Audit chown(1) Similar to the chgrp(1)-audit: 1) Refactor manpage so it's actually fun to read 2) BUGFIX: Call (l)chown properly when the H-flag is specified (only when depth > 0) 3) BUGFIX: Call (l)chown properly when the h-flag is specified (only when depth = 0). 4) BUGFIX: Only recurse() in chgrp() when the initial chownf() succeeds. 5) Style fixes, argv-basing. 6) Rename status to ret for consistency. 7) Add blank line before return.
2015-03-08 23:37:34 +00:00
.Ar group
respectively.
add some mandoc pages and fix some warnings - add .Os, it is mandatory. - don't redeclare .Nm when it's not needed. - fix some warnings (checked with mandoc -Tlint). - remove some leftover old stuff.
2015-01-30 20:17:58 +00:00
.Sh OPTIONS
.Bl -tag -width Ds
chown: Update program usage and manpage
2015-02-17 16:41:58 +00:00
.It Fl h
Audit chown(1) Similar to the chgrp(1)-audit: 1) Refactor manpage so it's actually fun to read 2) BUGFIX: Call (l)chown properly when the H-flag is specified (only when depth > 0) 3) BUGFIX: Call (l)chown properly when the h-flag is specified (only when depth = 0). 4) BUGFIX: Only recurse() in chgrp() when the initial chownf() succeeds. 5) Style fixes, argv-basing. 6) Rename status to ret for consistency. 7) Add blank line before return.
2015-03-08 23:37:34 +00:00
Preserve
.Ar file
if it is a symbolic link.
add some mandoc pages and fix some warnings - add .Os, it is mandatory. - don't redeclare .Nm when it's not needed. - fix some warnings (checked with mandoc -Tlint). - remove some leftover old stuff.
2015-01-30 20:17:58 +00:00
.It Fl R
Audit chown(1) Similar to the chgrp(1)-audit: 1) Refactor manpage so it's actually fun to read 2) BUGFIX: Call (l)chown properly when the H-flag is specified (only when depth > 0) 3) BUGFIX: Call (l)chown properly when the h-flag is specified (only when depth = 0). 4) BUGFIX: Only recurse() in chgrp() when the initial chownf() succeeds. 5) Style fixes, argv-basing. 6) Rename status to ret for consistency. 7) Add blank line before return.
2015-03-08 23:37:34 +00:00
Change file ownerships recursively.
chown.1: add symlink dereferencing flags to manpage
2015-02-09 21:25:58 +00:00
.It Fl H
Audit chown(1) Similar to the chgrp(1)-audit: 1) Refactor manpage so it's actually fun to read 2) BUGFIX: Call (l)chown properly when the H-flag is specified (only when depth > 0) 3) BUGFIX: Call (l)chown properly when the h-flag is specified (only when depth = 0). 4) BUGFIX: Only recurse() in chgrp() when the initial chownf() succeeds. 5) Style fixes, argv-basing. 6) Rename status to ret for consistency. 7) Add blank line before return.
2015-03-08 23:37:34 +00:00
Dereference
.Ar file
if it is a symbolic link.
chown.1: add symlink dereferencing flags to manpage
2015-02-09 21:25:58 +00:00
.It Fl L
Audit chown(1) Similar to the chgrp(1)-audit: 1) Refactor manpage so it's actually fun to read 2) BUGFIX: Call (l)chown properly when the H-flag is specified (only when depth > 0) 3) BUGFIX: Call (l)chown properly when the h-flag is specified (only when depth = 0). 4) BUGFIX: Only recurse() in chgrp() when the initial chownf() succeeds. 5) Style fixes, argv-basing. 6) Rename status to ret for consistency. 7) Add blank line before return.
2015-03-08 23:37:34 +00:00
Dereference all symbolic links.
chown.1: add symlink dereferencing flags to manpage
2015-02-09 21:25:58 +00:00
.It Fl P
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 22:37:31 +00:00
Preserve symbolic links.
This is the default.
add some mandoc pages and fix some warnings - add .Os, it is mandatory. - don't redeclare .Nm when it's not needed. - fix some warnings (checked with mandoc -Tlint). - remove some leftover old stuff.
2015-01-30 20:17:58 +00:00
.El
.Sh SEE ALSO
Audit chown(1) Similar to the chgrp(1)-audit: 1) Refactor manpage so it's actually fun to read 2) BUGFIX: Call (l)chown properly when the H-flag is specified (only when depth > 0) 3) BUGFIX: Call (l)chown properly when the h-flag is specified (only when depth = 0). 4) BUGFIX: Only recurse() in chgrp() when the initial chownf() succeeds. 5) Style fixes, argv-basing. 6) Rename status to ret for consistency. 7) Add blank line before return.
2015-03-08 23:37:34 +00:00
.Xr chmod 1 ,
.Xr chown 2 ,
.Xr getgrnam 3 ,
.Xr getpwnam 3
chown: Update program usage and manpage
2015-02-17 16:41:58 +00: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 16:22:48 +00:00
.St -p1003.1-2013
chown: Update program usage and manpage
2015-02-17 16:41:58 +00:00
specification.