Package: coreutils
Version: 8.4-1
Severity: normal

The 'info' examples are not too helpful. For instance:

zgrep -n -A 21 "reads its input" /usr/share/info/coreutils.info.gz
4139:   `tsort' reads its input as pairs of strings, separated by blanks,
4140-indicating a partial ordering.  The output is a total ordering that
4141-corresponds to the given partial ordering.
4142-
4143-   For example
4144-
4145-     tsort <<EOF
4146-     a b c
4147-     d
4148-     e f
4149-     b c d e
4150-     EOF
4151-
4152-will produce the output
4153-
4154-     a
4155-     b
4156-     c
4157-     d
4158-     e
4159-     f
4160-

I applaud the abstraction of using letters, but that result isn't
special enough:

    { tr ' ' '\n' <<EOF
    a b c
    d
    e f
    b c d e
    EOF
     } | sort -u
     a
     b
     c
     d
     e
     f

Of course the above code is a coincidental replacement, not a true
'tsort'.  It's as though we had an elite new command  "mul" (short for
"multiply") and our example was:

    % mul 2 2
    4

Novices might wonder if "mul" added 2 & 2.  The example would be
clearer if it showed a more distinctive result that wasn't trivial to
simulate.

The 'info' page's later "more realistic example" is an obscure C code
puzzle, of historic interest, and is perhaps informative to the small
minority that appreciates the puzzle.


-- System Information:
Debian Release: squeeze/sid
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: i386 (i686)

Kernel: Linux 2.6.31-1-686 (SMP w/1 CPU core)
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968) (ignored: LC_ALL set to C)
Shell: /bin/sh linked to /bin/dash

Versions of packages coreutils depends on:
ii  libacl1                       2.2.49-2   Access control list shared library
ii  libc6                         2.10.2-5   Embedded GNU C Library: Shared lib
ii  libselinux1                   2.0.89-4   SELinux runtime shared libraries

coreutils recommends no packages.

coreutils suggests no packages.

-- no debconf information



-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org

Reply via email to