home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / uucp / wCNews_1.0.30.lha / contrib / newsdaily / gsort.man < prev    next >
Encoding:
Text File  |  1993-03-05  |  7.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4. SORT(1L)          MISC. REFERENCE MANUAL PAGES           SORT(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      sort - sort lines of text files
  10.  
  11. SYNOPSIS
  12.      sort [-cmus]  [-t  separator]  [-o  output-file]  [-bdfiMnr]
  13.      [+POS1 [-POS2]] [-k POS1[,POS2]] [file...]
  14.  
  15. DESCRIPTION
  16.      This manual page documents the GNU version  of  sort.   sort
  17.      sorts,  merges,  or  compares  all  the lines from the given
  18.      files, or the standard input if no files are given.  A  file
  19.      name  of  `-' means standard input.  By default, sort writes
  20.      the results to the standard output.
  21.  
  22.      sort has three  modes  of  operation:  sort  (the  default),
  23.      merge,  and  check  for  sortedness.   The following options
  24.      change the operation mode:
  25.  
  26.      -¢4mc¢24m   Check whether the given files are  already  sorted:  if
  27.           they  are  not  all  sorted, print an error message and
  28.           exit with a status of 1.
  29.  
  30.      -¢4mm¢24m   Merge the given files by sorting them as a group.  Each
  31.           input  file  should already be individually sorted.  It
  32.           always works to sort instead of merge; merging is  pro-
  33.           vided because it is faster, in the case where it works.
  34.  
  35.      A pair of lines is compared as follows: if  any  key  fields
  36.      have  been  specified, sort compares each pair of fields, in
  37.      the order specified on the command line,  according  to  the
  38.      associated  ordering options, until a difference is found or
  39.      no fields are left.
  40.  
  41.      If any of the global options ¢4mMbdfinr¢24m are given  but  no  key
  42.      fields are specified, sort compares the entire lines accord-
  43.      ing to the global options.
  44.  
  45.      Finally, as a last resort when all keys compare equal (or if
  46.      no  ordering  options  were specified at all), sort compares
  47.      the lines byte by byte in machine collating  sequence.   The
  48.      -¢4ms¢24m  option disables this last resort comparison, producing a
  49.      stable sort.
  50.  
  51.      GNU sort has no limits on input line length or  restrictions
  52.      on  bytes  allowed  within lines.  In addition, if the final
  53.      byte of an input file is not a newline,  GNU  sort  silently
  54.      supplies  one.   In  some cases, such as exactly what the -¢4mb¢24m
  55.      and -¢4mf¢24m options do, BSD and System V  sort  programs  produce
  56.      different output; GNU sort follows the POSIX behavior, which
  57.      is usually like the System V behavior.
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sun Release 4.1           Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SORT(1L)          MISC. REFERENCE MANUAL PAGES           SORT(1L)
  71.  
  72.  
  73.  
  74.      If the environment variable TMPDIR is set, sort uses  it  as
  75.      the directory in which to put temporary files instead of the
  76.      default, /tmp.
  77.  
  78.      The following options affect the ordering of  output  lines.
  79.      They  may be specified globally or as part of a specific key
  80.      field.  If no key fields are specified, global options apply
  81.      to  comparison of entire lines; otherwise the global options
  82.      are inherited by key fields that do not specify any  special
  83.      options of their own.
  84.  
  85.      -¢4mb¢24m   Ignore leading blanks when finding sort  keys  in  each
  86.           line.
  87.  
  88.      -¢4md¢24m   Sort  in  `dictionary  order':  ignore  all  characters
  89.           except letters, digits and blanks when sorting.
  90.  
  91.      -¢4mf¢24m   Fold lower case characters into  the  equivalent  upper
  92.           case  characters when sorting so that, for example, `b'
  93.           is sorted the same way `B' is.
  94.  
  95.      -¢4mi¢24m   Ignore characters  outside  the  ASCII  range  040-0176
  96.           (inclusive) when sorting.
  97.  
  98.      -¢4mM¢24m   An initial string, consisting of any  amount  of  white
  99.           space,  followed  by three letters abbreviating a month
  100.           name, is folded to lower case and compared in the order
  101.           `jan' < `feb' < ... < `dec.'  Invalid names compare low
  102.           to valid names.  This option implies -¢4mb¢24m.
  103.  
  104.      -¢4mn¢24m   Compare  according  to  arithmetic  value  an   initial
  105.           numeric  string  consisting of optional white space, an
  106.           optional - sign, and zero or  more  digits,  optionally
  107.           followed  by  a  decimal point and zero or more digits.
  108.           This option implies -¢4mb¢24m.
  109.  
  110.      -¢4mr¢24m   Reverse the result of comparison, so  that  lines  with
  111.           greater key values appear earlier in the output instead
  112.           of later.
  113.  
  114.      Other options are:
  115.  
  116.      -¢4mo¢24m ¢4moutput¢24m-¢4mfile¢24m
  117.           Write output to ¢4moutput¢24m-¢4mfile¢24m instead of to the  standard
  118.           output.  If ¢4moutput¢24m-¢4mfile¢24m is one of the input files, sort
  119.           copies it to a temporary file before sorting and  writ-
  120.           ing the output to ¢4moutput¢24m-¢4mfile¢24m.
  121.  
  122.      -¢4mt¢24m ¢4mseparator¢24m
  123.           Use character ¢4mseparator¢24m as  the  field  separator  when
  124.           finding the sort keys in each line.  By default, fields
  125.           are separated  by  the  empty  string  between  a  non-
  126.  
  127.  
  128.  
  129. Sun Release 4.1           Last change:                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SORT(1L)          MISC. REFERENCE MANUAL PAGES           SORT(1L)
  137.  
  138.  
  139.  
  140.           whitespace  character and a whitespace character.  That
  141.           is to say, given the input line ` foo bar', sort breaks
  142.           it  into fields ` foo' and ` bar'.  The field separator
  143.           is not considered  to  be  part  of  either  the  field
  144.           preceding or the field following it.
  145.  
  146.      -¢4mu¢24m   For the default case or the -¢4mm¢24m option, only output  the
  147.           first  of  a sequence of lines that compare equal.  For
  148.           the -¢4mc¢24m option, check that no pair of consecutive  lines
  149.           compares equal.
  150.  
  151.      +¢4mPOS1¢24m [-¢4mPOS2¢24m]
  152.           Specify a field within each line to use  as  a  sorting
  153.           key.   The  field  consists  of the portion of the line
  154.           starting at POS1 and up to (but not including) POS2 (or
  155.           to  the  end  of  the  line if POS2 is not given).  The
  156.           fields and character positions  are  numbered  starting
  157.           with 0.
  158.  
  159.      -¢4mk¢24m ¢4mPOS1¢24m[,¢4mPOS2¢24m]
  160.           An alternate syntax for specifying sorting  keys.   The
  161.           fields  and  character  positions are numbered starting
  162.           with 1.
  163.  
  164.      A position has the form ¢4mf¢24m.¢4mc¢24m, where ¢4mf¢24m is the  number  of  the
  165.      field to use and ¢4mc¢24m is the number of the first character from
  166.      the beginning of the field (for +¢4mpos¢24m) or from the end of the
  167.      previous field (for -¢4mpos¢24m).  The .¢4mc¢24m part of a position may be
  168.      omitted in which case it is taken to be the first  character
  169.      in  the field.  If the -¢4mb¢24m option has been given, the .¢4mc¢24m part
  170.      of a field specification is counted from the first  nonblank
  171.      character of the field (for +¢4mpos¢24m) or from the first nonblank
  172.      character following the previous field (for -¢4mpos¢24m).
  173.  
  174.      A +¢4mpos¢24m or -¢4mpos¢24m argument may also  have  any  of  the  option
  175.      letters  ¢4mMbdfinr¢24m  appended  to  it, in which case the global
  176.      ordering options are not used  for  that  particular  field.
  177.      The  -¢4mb¢24m  option  may  be independently attached to either or
  178.      both of the +¢4mpos¢24m and -¢4mpos¢24m parts of  a  field  specification,
  179.      and  if  it  is inherited from the global options it will be
  180.      attached to both.  If a -¢4mn¢24m or -¢4mM¢24m option is used, thus imply-
  181.      ing a -¢4mb¢24m option, the -¢4mb¢24m option is taken to apply to both the
  182.      +¢4mpos¢24m and the -¢4mpos¢24m parts of a key  specification.   Keys  may
  183.      span multiple fields.
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Sun Release 4.1           Last change:                          3
  196.  
  197.  
  198.  
  199.