A. Costa wrote:
> 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
Thanks for the feedback.
Would you like to propose a better example?
Patches are most welcome.
> 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.
--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
