Instructions for AUTOPAGE
=========================

AUTOPAGE is a DOS utility that allows you to automatically number the pages
of any ASCII text file you have.

Here is how it works:

AUTOPAGE reads a text file and uses the number you give it along with other
data you will enter and produces a NEW file whose pages are now numbered.

Example:

          autopage myfile.txt myfile2.txt 70 page

In the above example, AUTOPAGE reads MYFILE.TXT and creates a NEW FILE,
MYFILE2.TXT.  The number 70 tells AUTOPAGE you want a PAGE # placed every 70
lines in the text.  This number is important:  this will determine how long
each page is.  The "page" entry above is NOT a command--it is what is called
"optional text," text that will preceed the PAGE #.  This text can be anything
you want (as long as there are no spaces in it).  If you simply want your
pages numbered without any text, do not specify any "optional text":

          autopage myfile.txt myfile2.txt 70

In this case, AUTOPAGE will simply number the pages using no "optional text."

After you correctly enter the AUTOPAGE command, you will be presented with
several prompts:

1.   WHERE would you like the [OPTIONAL TEXT] PAGE # placed horizontally
     on the page?

     Would you like it CENTERED?  Enter C.
     Left justified?  Enter L [or ENTER].
     Right justified?  Enter R.

2.   How many lines do you want to skip between the last line of text on
     each page and the actual [OPTIONAL TEXT] PAGE #?

     Example:

          This is a sample paragraph consisting of a bunch
          of meaningless words put here for the sake of
          illustrating the use of the SKIP LINE feature in
          the program now being described (AUTOPAGE).

          Page 10

     In this example, 1 LINE was skipped between the line reading "the
     program now being described (AUTOPAGE)." and the line reading "Page 10."

     One line is recommended, but you could skip several or many.  The more
     lines you skip, the more attention you should pay to the PAGE SIZE #
     you give to AUTOPAGE when you first invoke the program.  A little simple
     math--1 LINE SKIPPED + 70 LINES PER PAGE for this example--will produce
     a page of 71 lines per page.  Be sure your printer can handle the number
     of lines.  If you are not certain of this number, 60 is a good number to
     begin with:

          autopage myfile.txt myfile2.txt 60

     This will set the page length at 60 lines per page.  If you feel there
     is too much empty space at the end of your printed page, experiment with
     higher numbers.

     For your information, AUTOPAGE does not output a PAGE # for PAGE ONE,
     following the established standard for paging a document.  All
     [optional text] PAGE #'s begin with PAGE TWO.

3.   What is the PAGE NUMBER you wish to start with?  Normally, under any
     other circumstances, you would use the DEFAULT, beginning with PAGE ONE.
     *BUT* Say you have a book or long text file broken up into several files
     and you want to AUTOPAGE these files so they occur in numeric succession.
     For sake of example, say you had three book chapter text files:

               chapter1.txt
               chapter2.txt
               chapter3.txt

     You would AUTOPAGE CHAPTER1.TXT as normal, beginning with PAGE 1.  Before
     you AUTOPAGE the next file, you would examine CHAPTER1.TXT to see what
     the LAST page number was in that file.  Let's say that the last page was
     20.  You would then AUTOPAGE CHAPTER2.TXT beginning with page 21.  You
     would repeat this process for CHAPTER3.TXT.  In the end, all three files
     would be numbered in succession.


AUTOPAGE places what's called a FORMFEED CHARACTER after every PAGE # it
places in the new file.  This special character instructs your printer, when
printing your document, that the page it is printing has now ended, causing
the printer to advance to the next page.  When you open up/view your new
file, you will see the special character after the page # (or you may NOT,
if you are using a DOS wordprocessor that "hides" such characters).

If you find that your NEW file is not paged as you like, simply rerun
AUTOPAGE and answer Y (for YES) at the "OVERWRITE?" prompt--AUTOPAGE also
automatically checks to see if there is any danger in overwriting existing
files.  For the new filename, use ANY name you want, conforming to the DOS
standards for filenames.

Whenever you need help, type AUTOPAGE /? and you will see the HELP SCREEN.

I suggest you place AUTOPAGE in your DOS directory or somewhere in your PATH
so you can access it any time you want.  By placing it elsewhere you will
need to CD to that directory and run the program from there.

AUTOPAGE is shareware: $1.00 is the registration fee.  If you like AUTOPAGE,
please PRINT the form AUTOPAGE.REG I have included in this archive,
complete it, and mail it with your registration fee ($1.00 U.S. currency) to:

                    Robert J. Tiess
                    44a Rockwood Gardens
                    Middletown, New York 10940

By supporting the shareware concept, programmers like myself can continue
to bring you quality software.  Enjoy the program and take care.


                                                                 *rjt1994*