subj(1)                                                   subj(1)



     NAME
          subj - generate a list of subjects from a document

     SYNOPSIS
          subj file ...

     DESCRIPTION
          subj searches files for subjects that might be appropriate
          in a subject-page index and prints the list of subjects on
          the standard output.  The document should contain formatting
          commands (from nroff, troff, and mm among others) to make
          the best use of subj.

     FILES
          /usr/bin/subj

     SEE ALSO
          mm(1), ndx(1), troff(1).

     WARNINGS
          subj selects sequences of capitalized words as subjects ex-
          cept the first word in each sentence.  Thus, if a sentence
          begins with a proper noun, the capitalization rule will not
          select this word as a subject.  On the other hand, since
          each sentence is expected to begin on a newline, the first
          word of a sentence that begins in the middle of a line may
          be erroneously selected.

          The output of subj may not be appropriate for your needs and
          should be edited accordingly.

     BUGS
          subj also selects as subjects modifier-noun sequences from
          the abstract, headings, and topic sentences (the first sen-
          tence in each paragraph), and occasionally a word is in-
          correctly categorized as a noun or adjective.



















     April, 1990                                                     1