INTRODUCTION


             This is an instruction sheet with appendices for the program
         TYPET.  TYPET is a BASIC program written to aid anyone in
         processing a file for a typesetter.  This documentation contains
         the function of the program, a brief explanation of the methods
         used, some hints on early preparation, how to process a file,
         and a list of a special case.  There are several appendices
         included to aid in seeing what this program really does.


                                    FUNCTION

             The purpose of TYPET is to allow a person who is untrained
         in typesetting to accurately prepare a body of text for
         typesetting.  The concept used is one of substitution, that is,
         a complicated typesetting code is substituted for a simple user
         installed code.  The program also processes each line of the
         text to make sure that the text does not contain any undesirable
         characteristics such as a double space or leading blanks.


                            WHAT DOES IT DO AND HOW?

             The program processes each line of the text in three ways:
         1) the text is pulled over to the left margin; 2) all double
         spaces are reduced to a single space; and, 3) each line is
         examined for typesetting code flags.  Any flag is simply
         something designed to get your attention.  We use flags to mark
         buried cable, road hazards, and special sales on used cars.
         In this case, a flag is no different.  TYPET searches for a
         specific flag and when this flag gets the program's attention,
         it is processed.  The flag used here is the "close square
         bracket" (]).  When ever TYPET finds a "]" in the text it
         examines the character immediately to the right of the flag.
         If the character has a meaning, it is processed.  Otherwise,
         that flag is ignored,and searching for more flags proceeds.  If
         the character behind the flag means something, then both the
         flag and the character behind it will be substituted with a
         typesetting code.

             There are some limitations that must be followed while using
         this program.  First of all, the character following the flag
         must be limited to the digits (1 through 9), upper case letters
         (A through Z), and lower case letters (a through z).  This
         allows 64 codes to be entered.  Any other character following
         the flag will be ignored.  Perhaps an example will prove
         helpful at this point.  Suppose that the following line was
         being processed by TYPET:

             The quick brown fox [really he was red] bumped the lazy dog.



                                     ******




         TYPET Documentation                                        - 2 -
         User instructions




         After processing the line would look like this:

         The quick brown fox [really he was red] bumped the lazy dog.

         But wait, there was a "]" in that line, it should be processed
         with something right?  Wrong.  Notice that the character
         immediately behind the "]" is a space, not a digit or letter.
         Therefore, just ignore it and go on.  Do notice that the line
         was pulled over to the left margin.  If the sentence had read:

             "]1Now here this]2",  [the captain always yelled].

         After processing it would read:

         "*FT4Now here this*FT3", [the captain always yelled].

         Notice that *FT4 and *FT3 were substituted for ]1 and ]2, the
         text is on the left margin, and the double space between the
         first comma and [ is now a single space.  The "]." was ignored.
         This assumes that the codes for ]1 and ]2 were previously
         defined as *FT4 and *FT3, respectively.

             The term "previously defined" implies that some
         preparation and forethought have gone into what you want
         typeset.  First of all, you need to know the typesetting codes,
         what they do and where they need to go.  This does not mean you
         need to know everything about typesetting, just visit your
         friendly typesetting institution and they will tell you what
         you need to know.  Secondly, you need to assign the flags to
         various codes so that they will be substituted in the right
         fashion.  So, now let's go through a typical example of getting
         all of the knowledge we need first, then apply it.


                                EARLY PREPARATION

             If you visit your friendly typesetting person, you will learn
         some wonderful things.  First, some things have to be done on                                                     ____
         their machine.  Things like placing figures, photos, page lay
         out, etc., are left for them to do, TYPET will not attempt to do
         that.  Secondly, you will learn that the typesetting codes can
         be kind of complicated and confusing.  Listed below are some
         codes that have been used:

         *SZ12*LS130*FT7*LL4200  -- this means start with size 12 point,
         a line size of 130 something-or-others, font 7, and a line
         length of 4200 something-elses;



                                     ******




         TYPET Documentation                                        - 3 -
         User instructions




         *QR -- move the text to the right margin;

         *SZ18*LS200*FT7 -- size 18 point, line size 200, font 7;

         *SZ14*LS150*FT7 -- size 14 point, line size 150, font 7.

         These codes plus many more can used frequently within a single
         document.  It would be very tedious to have to type each one of
         these codes in the right spot without making an error.  But now
         that you have them, you can substitute them where necessary.

             Next, you must determine the flags that will be translated
         into these codes.  TYPET will determine this for you.  From the
         AMOS dot, type RUN TYPET and you will be placed in the
         typesetting code input mode.  You will be asked to enter these
         codes starting with ]1 and going through ]9, followed by ]A
         going through ]Z, and ]a going through ]z.  You need not enter
         all 64 codes, if you only have four, just enter a return at the
         prompt for the next code and the entry session will be ended.
         Upon completion of the input session, you will be asked if you
         want a printout of the codes.  If this is the first time these
         codes have been entered (and you should only have to enter them
         once), answer "y" to this question.  TYPET will now do two
         things for you.  First it will create a file called "CODES.LST"
         (see Appendix A.) that you can use for your reference while you
         go through the text file adding flags.  It is suggested that
         you describe what these flags are to do in the white space
         following the flag number.  Secondly, TYPET creates a file
         called "CODES.CMD" that has all of these codes plus the
         commands necessary to invoke TYPET from AMOS (See Appendix B.).
         In other words, entering the codes is now automated so you
         don't have to type them.

             After the order of the codes has been assigned, go through
         your text file and place the flags in the appropriate locations
         to do what is desired.


                                PROCESSING A FILE

             Now that the codes and flags have been assigned, and you
         have edited your text file to insert the appropriate flags in
         the right spots, you are ready to process your file for
         typesetting. Appendix C is an example of a text file before
         processing.  Before processing this file, the .LST file must be
         created.  TYPET asks for the name of the file to be processed
         and assumes that .LST is the extension.  This is critical on



                                     ******




         TYPET Documentation                                        - 4 -
         User instructions



         SuperVUE files since the .T file is not a format that can be
         processed.  To invoke processing, simply type CODES from the
         AMOS dot (remember the CODES.CMD file?) and processing will
         begin.  First all of the codes will be entered, you will be
         asked if you want a printout of the codes (you don't need it if
         CODES.CMD exists), upon a negative answer, the program changes
         modes to the text processing mode.  Enter the file name
         (excluding the extension) and processing will begin.....if it
         finds the file and if it is compatible.  The number of lines
         processed will be displayed as it zips through your file.

             Upon completion, TYPET will produce two more files in your
         directory.  One is a file called "READY.DAT" which contains the
         name of the file processed and the number of lines that have
         been processed.  The second file is filename.SAV which is the
         processed list file.  Appendix D contains a listing of a
         processed file.  By comparing it with Appendix C, you can see
         what the program does to the text.

             The .SAV file is now ready for typesetting with the
         exception of the special codes for figure placement and page lay
         out.  Those have to be performed by the typesetting operator.


                                 A SPECIAL CASE

             There is one special case for the codes.  All of the codes
         can be entered from the keyboard exactly as they will be
         substituted EXCEPT for the leading blanks of a paragraph.  In
         order to enter those blanks, you must use the following flag:

               SP(*) -- where * is the number of spaces to indent

         This can be any number you wish but anything greater than 4 is
         rejected by some typesetters (check your with your local machine
         operator on this one).


                           A HINT FOR MORE EFFICIENCY

             You may have several different types of files to be typeset.
         For example, you may have a set of codes for a newsletter,
         another set for a quarterly report, and yet another set for a
         series of publications.  It would become very unhandy to have
         each on of these in a separate account all with the same command
         file that invokes TYPET, namely CODES.CMD.  Therefore, you may
         find it beneficial to RENAME the file CODES.CMD to something
         that will be associated with the final document.  For example,



                                     ******




         TYPET Documentation                                        - 5 -
         User instructions



         if the product to be produced was a newsletter, you could use
         the following command from AMOS to help you out:

          .RENAME NEWLET.CMD=CODES.CMD (return)

         This would rename CODES.CMD to NEWLET so when you want to
         process a newsletter file you would enter NEWLET from the AMOS
         dot to invoke TYPET.  This would also save you from the
         potential headache of entering a new set of codes and asking for
         a printout, only to over-write the existing set of codes that
         were designed for a different task.








































                                     ******




         TYPET Documentation                                        - 6 -
         User instructions



         Appendix A.  Codes.LST:  an explanitory list of the typesetting
         codes.  Further explanations may be added by the user for their
         own reference.



         *SZ12*LS130*FT7*LL4200              ; code flag ]1
         *QR                                 ; code flag ]2
         *SZ18*LS200*FT7                     ; code flag ]3
         *QC                                 ; code flag ]4
         *SZ14*LS150*FT7                     ; code flag ]5
         *SZ10*LS120*FT3                     ; code flag ]6
         SP(4)                               ; code flag ]7
         *FT4                                ; code flag ]8
         *FT3                                ; code flag ]9
         *SZ14*LS150*FT3                     ; code flag ]A
         *QL                                 ; code flag ]B





         Appendix B.  CODES.CMD:  a command file created by TYPET that
         invokes the TYPET program and pre-defines some typesetting
         codes


         :R
         RUN TYPET
         *SZ12*LS130*FT7*LL4200
         *QR
         *SZ18*LS200*FT7
         *QC
         *SZ14*LS150*FT7
         *SZ10*LS120*FT3
         SP(4)
         *FT4
         *FT3
         *SZ14*LS150*FT3
         *QL











                                     ******




         TYPET Documentation                                        - 7 -
         User instructions



         Appendix C.  An example of a text file before processing by
         TYPET.  (Note the flags proceded by the "]", doublespacing, and
         the left margin).


                            ]1January/February 1985]2



                              ]3DIRECTOR'S REPORT]4

                 ]6]7A National Conference on Water Resources Research
         was held February 4-6, 1985 in Chevy Chase, Maryland.   The
         conference was sponsored by the Universities Council on Water
         Resources under a grant from the National Science Foundation.
         It was organized by a planning committee composed of a number of
         universities and water agencies, with the assistance of the UNL
         Water Resources Center.

                 ]7The objectives of the conference were: (1) to seek a
         renewed effort to re-establish a national water resources
         research agenda; (2) to re-state research priorities; and (3) to
         develop alternative working arrangements of the research
         community, including federal, state, university and private
         sector interests.

                 ]7A conference proceedings is being prepared in which
         preconference working papers will be revised as a result of
         conference workshop discussions.

                        ]51985 NEBRASKA WATER CONFERENCE]4

         ]6]7    The 1985 Nebraska Water Conference with the theme "Water
         Management Implementation" will be held March 19-20, 1985 at the
         Nebraska Center for Continuing Education in Lincoln.

                 ]A]7The conference is divided into three main sessions:
         (1) Implementing Legislation and Plans; (2) Economics and
         Financing of Water Projects; and (3) Implementing Groundwater

  Protection











                           ******




TYPET Documentation                                        - 8 -
User instructions



         Appendix D.  The processed file (renamed .SAV) ready for being
         typeset.


*SZ12*LS130*FT7*LL4200January/February 1985*QR



*SZ18*LS200*FT7DIRECTOR'S REPORT*QC


*SZ10*LS120*FT3    A National Conference on Water Resources Research was held
February 4-6, 1985 in Chevy Chase, Maryland. The conference was
sponsored by the Universities Council on Water Resources under a
grant from the National Science Foundation. It was organized by a
planning committee composed of a number of universities and water
agencies, with the assistance of the UNL Water Resources Center.

   The objectives of the conference were: (1) to seek a renewed
effort to re-establish a national water resources research agenda;
(2) to re-state research priorities; and (3) to develop alternative
working arrangements of the research community, including federal,
state, university and private sector interests.

   A conference proceedings is being prepared in which pre-
conference working papers will be revised as a result of conference
workshop discussions.

*SZ14*LS150*FT71985 NEBRASKA WATER CONFERENCE*QC

*SZ10*LS120*FT3    The 1985 Nebraska Water Conference with the theme "Water
Management Implementation" will be held March 19-20, 1985 at
the Nebraska Center for Continuing Education in Lincoln.

*SZ10*LS120*FT3    The conference is divided into three main sessions: (1)
Implementing Legislation and Plans; (2) Economics and Financing
of Water Projects; and (3) Implementing Groundwater Protection














                           ******