10/20/86  create_wordlist, cwl


Syntax as a command:  cwl path {-control_args}


Function:  produces an alphabetized list of all distinct words found in
the specified text segment.  This list is saved in a wordlist segment
that is created in the working directory.  The wordlist segment is
given the entryname of the text segment with a suffix of wl added.  The
total number of words in the text segment and the number of words put
into the wordlist segment are displayed.


Arguments:
where path is the pathname of the text segment or MSF.


Control arguments:
-brief, -bf
   suppresses the display of the total number of words in the text
   segment and the number of words put into the wordlist segment.
-from n, -fm n
   words are processed in the text segment starting from the line
   number specified by n.  If this control argument is not specified,
   then the text segment is processed starting from the first line.
-header, -he
   displays the pathname of the text segment.
-no_control_lines, -ncl
   suppresses the display of the control lines.


-no_exclude, -ne
   specifies that words containing only special characters or
   punctuation are not to be excluded from the wordlist.
-no_sort, -ns
   specifies that the words in the wordlist segment are not to be
   sorted into alphabetical order.  They are put into the wordlist
   segment in the order in which they are found in the text segment and
   duplications are not eliminated.  (This control argument is intended
   for special application and should not be used for normal wordlist
   segment creation.)
-temp_dir path, -td path
   path holds the temporary segment if the input file is an MSF.
   (Default is the process directory.)


-to n
   words are processed in the text segment up to and including the line
   number specified by n.  If this control argument is not specified,
   then the text segment is processed to the last line.


Notes:  Words in the text segment are separated by the following
delimiter (white space) characters:

   space
   horizontal tab
   vertical tab
   newline
   form feed


Punctuation characters are removed from the word.  The characters "([{
are removed from the left side of the word.  The characters ")]}.,;:?!
are removed from the right side of the word.  Also, PAD characters
(octal 177) are removed from the left side of the word.  Additional
special processing is performed on each word after all punctuation is
removed.  A summary of this special processing is given below:

     if the entire word is underscored, then the underscores are
     removed.  If only part of a word is underscored, then the
     underscores remain.

     if the word contains no letters, i.e., consists entirely of
     punctuation characters or other special characters, then the word
     is excluded from the wordlist.  The -no_exclude control argument
     disables the automatic exclusion of such words.


                                          -----------------------------------------------------------


Historical Background

This edition of the Multics software materials and documentation is provided and donated
to Massachusetts Institute of Technology by Group BULL including BULL HN Information Systems Inc. 
as a contribution to computer science knowledge.  
This donation is made also to give evidence of the common contributions of Massachusetts Institute of Technology,
Bell Laboratories, General Electric, Honeywell Information Systems Inc., Honeywell BULL Inc., Groupe BULL
and BULL HN Information Systems Inc. to the development of this operating system. 
Multics development was initiated by Massachusetts Institute of Technology Project MAC (1963-1970),
renamed the MIT Laboratory for Computer Science and Artificial Intelligence in the mid 1970s, under the leadership
of Professor Fernando Jose Corbato. Users consider that Multics provided the best software architecture 
for managing computer hardware properly and for executing programs. Many subsequent operating systems 
incorporated Multics principles.
Multics was distributed in 1975 to 2000 by Group Bull in Europe , and in the U.S. by Bull HN Information Systems Inc., 
as successor in interest by change in name only to Honeywell Bull Inc. and Honeywell Information Systems Inc. .

                                          -----------------------------------------------------------

Permission to use, copy, modify, and distribute these programs and their documentation for any purpose and without
fee is hereby granted,provided that the below copyright notice and historical background appear in all copies
and that both the copyright notice and historical background and this permission notice appear in supporting
documentation, and that the names of MIT, HIS, BULL or BULL HN not be used in advertising or publicity pertaining
to distribution of the programs without specific prior written permission.
    Copyright 1972 by Massachusetts Institute of Technology and Honeywell Information Systems Inc.
    Copyright 2006 by BULL HN Information Systems Inc.
    Copyright 2006 by Bull SAS
    All Rights Reserved