home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / PDP-11 / Trees / V6 / usr / man / man1 / sort.1 < prev    next >
Encoding:
Text File  |  1975-06-26  |  3.0 KB  |  144 lines
  1. .th "SORT" I 5/13/75
  2. .sh NAME
  3. sort, usort \*- sort or merge files
  4. .sh SYNOPSIS
  5. .bd sort
  6. [
  7. .if t \fB\*-abdnrt\fIx\fR
  8. .if n -abdnrt______x
  9. ]
  10. [ \fB+\fIpos \fR [ \fB\*-\fIpos \fR]
  11. ] . . .
  12. [ 
  13. .bd \*-mo 
  14. ]
  15. [ name ] . . .
  16. .br
  17. .bd usort
  18. [
  19. .bd \-umo
  20. ] [ name ] . . .
  21. .sh DESCRIPTION
  22. .it Sort
  23. sorts
  24. all the named files together
  25. and writes the result on
  26. the standard output.
  27. The name `\*-' means
  28. the standard input.
  29. The standard input is also used if no input file names are given.
  30. Thus
  31. .it sort
  32. may be used as a filter.
  33. .s3
  34. The default sort key is an entire line.
  35. Default ordering is lexicographic in ASCII collating sequence,
  36. except that lower-case letters are considered
  37. the same as the corresponding upper-case letters.
  38. Non-ASCII bytes are ignored.
  39. The ordering is affected by the flags
  40. .if t \fB\*-abdnrt\fR,
  41. .if n .it abdnrt,
  42. one or more of which may appear:
  43. .s3
  44. .lp +4 4
  45. \fBa\fR    Do not map lower case letters.
  46. .s3
  47. .lp +4 4
  48. \fBb\fR    Leading blanks (spaces and tabs) are not included in fields.
  49. .s3
  50. .lp+4 4
  51. \fBd\fR    `Dictionary' order: only letters, digits and blanks
  52. are significant in ASCII comparisons.
  53. .s3
  54. .lp +4 4
  55. \fBn\fR    An initial numeric string,
  56. consisting of optional minus sign,
  57. digits and optionally included decimal point,
  58. is sorted by arithmetic value.
  59. .s3
  60. .lp+4 4
  61. \fBr\fR    Reverse the sense of comparisons.
  62. .s3
  63. .lp +4 4
  64. \fBt\fIx\fR    Tab character between fields is
  65. .it x.
  66. .s3
  67. .i0
  68. Selected parts of the line, specified by
  69. \fB+\fIpos\fR
  70. and
  71. \fB\*-\fIpos\fR,
  72. may be used as sort keys.
  73. .it Pos 
  74. has the form
  75. .it m.n,
  76. where
  77. .it m
  78. specifies a number of fields to skip,
  79. and 
  80. .it n
  81. a number of characters to skip further into the next field.
  82. A missing
  83. .it \\.n
  84. is taken to be 0.
  85. \fB+\fIpos\fR denotes the beginning of the key;
  86. \fB\*-\fIpos\fR denotes the first position after the key
  87. (end of line by default).
  88. The ordering rule may be overridden for a particular key
  89. by appending one or more of the flags
  90. .bd abdnr
  91. to
  92. \fB+\fIpos\fR.
  93. .s3
  94. When no tab character has been specified,
  95. a field consists of
  96. nonblanks and any preceding blanks.
  97. Under the
  98. .bd \*-b
  99. flag, leading blanks are excluded from a field.
  100. When a tab character has been specified,
  101. a field is a
  102. string ending with a tab character.
  103. .s3
  104. .i0
  105. When keys are specified,
  106. later keys are compared only when all earlier ones compare equal.
  107. Lines that compare equal are ordered
  108. with all bytes significant.
  109. .s3
  110. These flag arguments are also understood:
  111. .s3
  112. .lp +4 4
  113. \fB\*-m\fR    Merge only, the input files are already sorted.
  114. .s3
  115. .lp +4 4
  116. \fB\*-o\fR    The next argument is the name of an output file
  117. to use instead of the standard output.
  118. This file may be the same as one of the inputs,
  119. except under the merge flag \fB\*-m\fR.
  120. .i0
  121. .s3
  122. .it Usort
  123. is a somewhat specialized version of
  124. .it sort
  125. which accepts no collating sequence options:
  126. order is always
  127. plain ASCII.
  128. It also strips out the second and following copies
  129. of duplicated lines.
  130. A
  131. .it u
  132. flag prevents this stripping.
  133. .it Usort
  134. also understands
  135. the
  136. .it m
  137. and
  138. .it o
  139. options in the same way as
  140. .it sort.
  141. .sh FILES
  142. /usr/tmp/stm???
  143. .sh BUGS
  144.