midfavila/sbase
1
0
Fork 0
Code Issues Pull Requests Projects Releases 1 Wiki Activity
57c9cab849
sbase/chown.1

61 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 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 CHOWN 1
Add .Os sbase and sed replace to .Os sbase $(VERSION) in make install
2015-01-31 14:37:03 -05: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 15:17:58 -05:00
.Sh NAME
.Nm chown
.Nd change file ownership
.Sh SYNOPSIS
.Nm
chown: Update program usage and manpage
2015-02-17 11:41:58 -05: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 13:37:10 -05: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 15:17:58 -05: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 13:37:10 -05: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 19:37:34 -04: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 13:37:10 -05: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 19:37:34 -04: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 15:17:58 -05:00
.Sh OPTIONS
.Bl -tag -width Ds
chown: Update program usage and manpage
2015-02-17 11:41:58 -05: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 19:37:34 -04: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 15:17:58 -05: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 19:37:34 -04:00
Change file ownerships recursively.
chown.1: add symlink dereferencing flags to manpage
2015-02-09 16:25:58 -05: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 19:37:34 -04:00
Dereference
.Ar file
if it is a symbolic link.
chown.1: add symlink dereferencing flags to manpage
2015-02-09 16:25:58 -05: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 19:37:34 -04:00
Dereference all symbolic links.
chown.1: add symlink dereferencing flags to manpage
2015-02-09 16:25:58 -05:00
.It Fl P
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 19:37:34 -04: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 15:17:58 -05: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 19:37:34 -04:00
.Xr chmod 1 ,
.Xr chown 2 ,
.Xr getgrnam 3 ,
.Xr getpwnam 3
chown: Update program usage and manpage
2015-02-17 11:41:58 -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
chown: Update program usage and manpage
2015-02-17 11:41:58 -05:00
specification.
Reference in New Issue Copy Permalink