Re: let's beef up the tsort info page

[Paul Eggert]

> From: Dan Jacobson <address@hidden>
> Date: 04 Feb 2002 12:06:22 +0800
> 
> Conclusion: if you guys were to add a little introduction to what this stuff
> is all about, then maybe many more folks could get a handle on it.

Hmm, could you propose some wording for that?  Please bear in mind
that, if the reader doesn't know what a topological sort is, or what
total ordering and partial orderings are, then it's unlikely that the
reader will need 'tsort'.


> By the way, "`sort': Sort text files"
> Well, this should be modified, as I bet sort can be used on "non-text
> files" as long as they have newlines [^J] in them.

That sounds reasonable.  Please see the proposed patch below.

You're generating some helpful bug reports.  To make them even more
helpful, can you please generate proposed patches in the usual format
used in GNU projects, as shown below?  That will simplify the
maintainer's job and will help make your bug reports clearer.  Thanks.


2002-02-04  Paul Eggert  <address@hidden>

        * doc/coreutils.texi: Change `Sort text files' to `Sort files',
        since sort's input files need not be text.

--- textutils-20020204/doc/coreutils.texi       Wed Jan 30 23:03:30 2002
+++ textutils/doc/coreutils.texi        Mon Feb  4 10:49:33 2002
@@ -85,7 +85,7 @@ START-INFO-DIR-ENTRY
 * seq: (coreutils)seq invocation.               Print numeric sequences
 * shred: (coreutils)shred invocation.           Remove files more securely.
 * sleep: (coreutils)sleep invocation.           Delay for a specified time.
-* sort: (coreutils)sort invocation.             Sort text files.
+* sort: (coreutils)sort invocation.             Sort files.
 * split: (coreutils)split invocation.           Split into fixed-size pieces.
 * stty: (coreutils)stty invocation.             Print/change terminal settings.
 * su: (coreutils)su invocation.                 Modify user and group id.
@@ -230,7 +230,7 @@ Summarizing files
 
 Operating on sorted files
 
-* sort invocation::             Sort text files.
+* sort invocation::             Sort files.
 * uniq invocation::             Uniquify files.
 * comm invocation::             Compare two sorted files line by line.
 * ptx invocation::              Produce a permuted index of file contents.
@@ -2681,7 +2681,7 @@ are valid.
 These commands work with (or produce) sorted files.
 
 @menu
-* sort invocation::             Sort text files.
+* sort invocation::             Sort files.
 * uniq invocation::             Uniquify files.
 * comm invocation::             Compare two sorted files line by line.
 * ptx invocation::              Produce a permuted index of file contents.
@@ -2690,7 +2690,7 @@ These commands work with (or produce) so
 
 
 @node sort invocation
address@hidden @code{sort}: Sort text files
address@hidden @code{sort}: Sort files
 
 @pindex sort
 @cindex sorting files