manual/gnumaniak/original/man1/tsort.1

   1 .\" You may copy, distribute and modify under the terms of the LDP General
   2 .\" Public License as specified in the LICENSE file that comes with the
   3 .\" gnumaniak distribution
   4 .\"
   5 .\" The author kindly requests that no comments regarding the "better"
   6 .\" suitability or up-to-date notices of any info documentation alternative
   7 .\" is added without contacting him first.
   8 .\"
   9 .\" (C) 2002 Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>
  10 .\"
  11 .\"     GNU tsort man page
  12 .\"     man pages are NOT obsolete!
  13 .\"     <ragnar@ragnar-hojland.com>
  14 .TH TSORT 1 "7 October 2002" "GNU textutils 2.1"
  15 .SH NAME
  16 \fBtsort\fR \- print byte, word, and line counts
  17 .SH SYNOPSIS
  18 .B tsort
  19 .RI [ FILE ]
  20
  21 .BR tsort " [" \-\-help "] [" \-\-version ]
  22 .SH DESCRIPTION
  23 \fBtsort\fR topologically sorts a given
  24 .IR FILE ".  If " FILE
  25 is omitted or if it is a
  26 .RB ` \- ',
  27 standard input is used for reading.
  28
  29 String pairs, each element separated by blanks, are read from \fIFILE\fR.
  30 The total order in relation with the partial order indicated by
  31 the elements of the string pairs is then printed to standard output.  If any
  32 cycle is detected, it'll write the first one found to standard error.
  33 .SH OPTIONS
  34 .TP
  35 .B "\-\-help"
  36 Print a usage message on standard output and exit successfully.
  37 .TP
  38 .B "\-\-version"
  39 Print version information on standard output then exit successfully.
  40 .SH EXAMPLES
  41 We will give \fBtsort\fR a list of "X happened before Y" pairs,
  42 and see if it can sort it.  Note that for a given partial order there may be
  43 no unique total order.
  44 .sp
  45 .RS
  46 .nf
  47 tsort << EOF
  48 neolitic bronze
  49 greeks linux
  50 pyramids greeks
  51 bronze pyramids
  52 bronze greeks
  53 EOF
  54 .fi
  55 .RE
  56 .sp
  57 outputs
  58 .sp
  59 .RS
  60 .nf
  61 neolitic
  62 bronze
  63 pyramids
  64 greeks
  65 linux
  66 .fi
  67 .RE
  68 .SH NOTES
  69 Report bugs to bug-textutils@gnu.org.
  70 .br
  71 Man page by Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>
  72
  73