CVS log for src/bin/ls/ls.1

Up to [cvs.NetBSD.org] / src / bin / ls

Request diff between arbitrary revisions

Keyword substitution: kv
Default branch: MAIN

Correct details around when '-s' prints 'total': this is controlled by
whether we are using multi-column output (-C, -x) or single column output
(-1, -m) with the rationale being that multi-column output is intended
for human consumption.

Based on input from kre@

Note that when '-s' is combined with '-1', the 'total' is _not_ printed.

Add ACL support for FFS. From FreeBSD.

Ooops, restore accidently removed files from merge mishap

Sync with HEAD

Remove workaround for ancient HTML generation code.

ls was there from v1.
Confirmed from the TUHS & cat-v.org hosted copies of man pages

Remove the confusing reference to 'file sizes' in the short description of
the '-l' flag.  As explained in the Long Format section, the total is of
the blocks used by the files, and only applies to directories.

Rebase to HEAD as of a few days ago.

sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs.  ("Protocol error: too many arguments")

Wording improvement for previous.
From jmc@OpenBSD via Igor Sobrado.

Apply diff from Igor Sobrado <isd@orion.ciencias.uniovi.es>:

We have written a diff to our ls(1) to recover the traditional behaviour
of -f implying -a.  This change does not only accommodates POSIX.1
but also matches traditional UNIX.

OpenBSD commit message:

CVSROOT:        /cvs
Module name:    src
Changes by:     sobrado@cvs.openbsd.org 2014/03/31 14:54:37

Modified files:
        bin/ls         : ls.1 ls.c

Log message:
restore the traditional behavior of -f implying -a; apparently Keith Bostic
forgot to restore it when the -f flag was put back on 2nd of September 1989,
after being removed on 16th of August as a consequence of issues getting it
working over NFS, so deviation from traditional UNIX behavior in all BSDs
looks like an historical accident; as a side effect, this change accommodates
behavior of this option to IEEE Std 1003.1-2008 (``POSIX.1'').

joint work with jmc@ (who found the inaccuracy in our implementation),
schwarze@ (who provided a detailed tracking of historical facts) and millert@

ok millert@, schwarze@

Add -X (don't cross mount points when recursing) from tls@

Use .Nm for 'ls'.

Add -O (only leaf files) and -P (print full path), from tls@

resync with head

sync with (a bit old) head

PR/47167
ls.1:
- Sort options in `SYNOPSIS', the option list, and texts within
  the man page;
- improve wording;
- improve macro usage;
- use more consistency regarding (locations for) information about
  which options override which;
- cross-reference `-d' and `-R';
- simplify description of `-k', removing redundant and unneeded
  information;
- sort entry type list (but leave `-a' and `-A' as they are, given
  their meaning);
- correct / augment description of `BLOCKSIZE' environment variable
  in `ENVIRONMENT' section;
- bump date.

ls.c:
- Sort options in `usage';
- augment comment about when to figure out block size.

Resync to 2012-11-19 00:00:00 UTC

sync with head

Use more markup.

clarify that BLOCKSIZE also influences the total in long output

Wording fixes from Ryo HAYASAKA, thanks.

Remove trailing whitespace. Add -M to usage.

PR#7540, add a -M option to ls which causes sizes (and number of blocks) to be
displayed with comma separators (or a locale specific separator).

Fix cross-reference, dir(5) -> dirent(3).

Reorder sections to canonical order. Use .Ex -std

\\ -> \e

Change '-n' so that it implies '-l' rather than requires '-l'.
Brings ls(1) closer to POSIX.1 2004.
Per discussion with Thomas Klausner and Igor Sobrado.

PR/33635: Anne Bennett: Document 'a' and 'A' flags in ls(1).
strmode(3) already documented these, so use the description from there.

Pull up following revision(s) (requested by christos in ticket #53):
	bin/df/df.c: revision 1.71
	bin/mv/mv.c: revision 1.36
	bin/ls/ls.1: revision 1.61
	bin/ls/ls.c: revision 1.60
-h and -[mgk] are mutually exclusive. Only use the last specified. [from zafer]
Use one variable instead of 3 flags to hold the scale, so that we don't have
to reset each flag.
from zafer: you can have either -k or -h but not both since it does not make
sense.
- detect buffer overflow.
- if we have a trailing slash, don't add another one.

from zafer: you can have either -k or -h but not both since it does not make
sense.

Fix date (no leading zero), fix xref: sticky(7) not (8).

Address PR 30374 as suggested in there:

"Modify the man page to match the behaviour of "ls -q",

(done by yamt@ previously)

...
modify both the behaviour and documentation for "ls -b" and "ls -B" to
make spaces readily apparent.  This could be done by adding VIS_WHITE
to the flags passed to strvis(3) in the safe_print() function in
src/bin/ls/util.c."

'ls -b' now yields foo\sbar (whitespace) foo\tbar (tab) foo\rbar (CR).
'ls -B' now yields foo\040bar foo\011bar foo\015bar.

s/non-graphic/non-printable/ to match with the code.

Rather than '-h' suppressing '-s' when using '-l', make it display
the blocks used in human readable form, as suggested by Alan Barrett
and Daniel Carosone.

document that -h makes -l suppress -s.
(Ie 'ls -lhs' == 'ls -lh')

Bump date for previous.

Document that '-g' overrides -1, -C, -m, and -x, but is _always_
overridden by '-l', even if '-g' was specified last.

Document -L correctly. PR #30430.

Sort options (description).

Clarify the description for -s to include a pointer to an explanation
on how BLOCKSIZE affects the parameter.

The '-l' option *always* prints a total, not only if output is to a
terminal.

Clarify meaning of '-c' flag by using similar wording as for '-u' flag.

Crossreference -h and -k. Use Aq instead of \*[Lt]\*[Gt].

implement -h(umanize).

from David P. Reese Jr. in PR bin/23870.

Bump date for previous; comma cleanup.

After last weeks addition of the '-b' flag, add '-B' and '-w' flags,
suggested by uwe@, inspired by FreeBSD.  The three flags override
each other (and the '-q' flag) and behave as follows:

     -B      Force printing of non-printable characters in file names as
	     \xxx, where xxx is the numeric value of the character in octal.

     -b      As -B, but use C escape codes whenever possible.

     -w      Force raw printing of non-printable characters.  This is the
             default when output is not to a terminal.

Bump date for previous.

Implement '-b' option, which, following FreeBSD, Linux and (I think) Solaris
prints octal escapes for nongraphic characters.

Sort options (AaBb...).

From FreeBSD bug report 54294, via Jonathan Gray and then jmc@openbsd:
-l option to ls(1) gives all permissions, not just owner and group.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22249, verified by myself.

make -g behave as it should according to SUSv3 (long listing without
owner).

ok'd by kleink@.

.Nm does not need a dummy argument ("") before punctuation or
for correct formatting of the SYNOPSIS any longer.

some mdoc improvements.

ok'd by wiz.

Default .Ar arugment is sufficient.

New policy: New sentences start on a new line.
Patches by Robert Elz <kre at munnari oz au>, with minimal changes by me.

Pull up revision 1.34 (requested by kleink in ticket #360):
Note that -T is to be used with -l; synced with FreeBSD via Michal
Pasternak on current-users.

Note that -T is to be used with -l; synced with FreeBSD via Michal
Pasternak on current-users.

Add missing -p to synopsis; from Ryan Younce in PR misc/16555.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Add explanation of directory sizes, and a reference to dir(5),
per PR 14291.

Use standard headers.

Whitespace nits.

Xref getbsize(3).

For commands and utilities, use EXIT STATUS rather than RETURN VALUES as
appropriate (and documented in mdoc(7)).

Pull up to netbsd-1-5 branch, OK'd by thorpej:

Log Message:
 > Add 'RETURN VALUE' section header.

Files & Revisionis:
 > cvs rdiff -r1.19 -r1.20 basesrc/bin/cat/cat.1
 > cvs rdiff -r1.12 -r1.13 basesrc/bin/chmod/chmod.1
 > cvs rdiff -r1.14 -r1.15 basesrc/bin/cp/cp.1
 > cvs rdiff -r1.8 -r1.9 basesrc/bin/dd/dd.1
 > cvs rdiff -r1.9 -r1.10 basesrc/bin/echo/echo.1
 > cvs rdiff -r1.11 -r1.12 basesrc/bin/expr/expr.1
 > cvs rdiff -r1.25 -r1.26 basesrc/bin/ls/ls.1
 > cvs rdiff -r1.10 -r1.11 basesrc/bin/mkdir/mkdir.1
 > cvs rdiff -r1.23 -r1.24 basesrc/bin/mt/mt.1
 > cvs rdiff -r1.12 -r1.13 basesrc/bin/mv/mv.1
 > cvs rdiff -r1.16 -r1.17 basesrc/bin/pwd/pwd.1
 > cvs rdiff -r1.9 -r1.10 basesrc/bin/rm/rm.1
 > cvs rdiff -r1.11 -r1.12 basesrc/bin/rmdir/rmdir.1
 > cvs rdiff -r1.35 -r1.36 basesrc/bin/sh/sh.1
 > cvs rdiff -r1.11 -r1.12 basesrc/bin/sleep/sleep.1
 > cvs rdiff -r1.20 -r1.21 basesrc/bin/stty/stty.1

Add 'RETURN VALUE' section header.

Sync w/ netbsd-1-5-base.

Add Ev tag to COLUMNS

Add description of FIFOs in long display (was commented out).

Add support for the XCU5 -p option (-F restricted to directories).

Implement 1003.2 -m option (stream output format).

update date

refer to chflags(1) for more info on file flags.
split up explanation of long format into a list

Document ls -F's output for sockets;
per PR 5520 by Matt Debergalis <deberg@big-veronica.ai.mit.edu>

correct HISTORY section of ls(1) to note that Ls(1) exited in 5th Edition UNIX from Bell Labs; add that version to At macro in  mdoc, all per PR#4790

* implement -x; sort columns across the page rather than down the page
* in printcol(), don't bother building an index to the linked list if
  only printing one column with printscol()...
* implement -n; prevent [gu]id->name mapping in long listings.
  inspired by openbsd, but does *not* imply -l by itself.
* fix sorting with -d (or mismatched types in general).  (from openbsd).
* document -g. (from openbsd).

Fix .Nm usage.

Changed order of STANDARDS and HISTORY subheads to conform with
specification in mdoc(7).

ENVIRONMENTAL -> ENVIRONMENT

Uncomment text that describes that a vertical bar is printed after each
pathname that is a FIFO when the -F option is used.

imported from 44lite2

Use "utility" instead of "command".  Modern definitions of these terms
are distinct (See POSIX.2 glossary).

A utility is a executable, script or shell builtin; while a command
can be any of those things plus lists, pipelines, compound commands
(if, for, while) and shell function definitions.

convert to new RCS id conventions.

Sync with CSRG.

Merge with 4.4-Lite version.

Import original 4.4-Lite version.

added missing -A and -o to options summary list.

Fix spelling errors.

Patches from Thomas Eberhardt <thomas@mathematik.uni-Bremen.de> to allow
sorting by size.

New version from uunet, with -k option readded, and 4.4 ffs--specific stuff
in `#ifdef notyet'.

Add RCS indentifiers.

changed "Id" to "Header" for rcsids

added rcs ids to all files

initial import of 386bsd-0.1 sources

Initial revision