Category : Printer Utilities
Archive   : SMALLDOC.ZIP
Filename : SMALLDOC.DOC

"SMALLDOC" documentation and CONFIGURATION file combination

SMALLDOC.exe makes "SMALL" pages of ascii "DOC"umentation (.DOC) files.

As stated in the line above, the reason the program exists is to take those
".DOC" and ".TXT" files that accompany the SHAREWARE and PUBLIC DOMAIN
programs and to produce a small-sized document that will fit in the three ring
notebooks which are the same size as the IBM BASIC book or many of the other
same size small book/slip cover sets. SMALLDOC provides the lines to cut on
and marks the positions where to punch the three holes.

For document files that are ALREADY formatted, SMALLDOC simply REDUCES the
size and adds the margin on the left side for the holes to be punched.

SMALLDOC will convert any Unprintable, Justify characters (FF) to blanks (20).

For those document files that seem to go ON and ON FOREVER without formatting
then SMALLDOC will allow you to put a HEADER on each page and then each page
can be NUMBERED or NOT as you choose. This file is one of those ".DOC" files
that are not formatted and seem to go ON and ON forever. If you run
"SMALLDOC" and process this file, you probably would want to have a HEADER and
NUMBER the pages, too.

While you are printing, if you touch the "P" key then you can halt printing.
This feature is to provide you the ability to stop the printer so you can
answer the phone.

If you enter the letters "Q" or "q" when you're prompted to enter a file name
then you will QUIT.

If you enter the words "MAKE FORMAT" or "make format" when asked for a file
name, then a sample format will be made so that you can use it to change the
numbers in the CONFIGURATION part below (between the star-lines *****). It is
a guide only and you should not use it as the final authority. It is better
to use TRIAL and ERROR in the star-line variables in order to fine tune.

NOTE: You can put the name of the file to print and most of the options after
the filename SMALLDOC on the command line. For more instructions, enter the
following at your prompt [example] C:>SMALLDOC HELP and you will
get a small screen of instructions for future sessions. First, though, you
should attempt to run the program "plain vanilla" by typing just SMALLDOC at
the prompt [example] A:>SMALLDOC and then follow the MENU options.

SMALLDOC will NOT handle WORDSTAR or Binary files where ASCII characters have
values above 127 (the famous HIGH BIT). If you want to produce a SMALLDOC
page of a WORDSTAR or any NON "low-ASCII" file, then use a suitable program to
accomplish that feat first (no pun intended).

--------------------------------------NOTE--------------------------------------

If this file, SMALLDOC.DOC, cannot be found when the main program SMALLDOC.EXE
is run (heavens forbid!) then EPSON printer codes will be used and you will
have to use the values that are hard-coded in the program. This SMALLDOC.DOC
file is an ASCII file can be editted by almost any WORD PROCESSOR so that you
can easily change the values to suit yourself and your printer. If you HAVE
TO, then use the DOS "EDLIN" program to edit SMALLDOC.DOC (arghhhhh!!!!!!).

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


HERE ARE THE STAR-LINES

*****************************24*numbered*lines**************starline#1********
1- THE NUMBER OF LINES FOR THE TOP MARGIN = 3
2- THE NUMBER OF LINES FOR THE BOTTOM MARGIN = 2
3- THE WIDTH OF PAGE = 96
4- THE NUMBER OF LINES PER PAGE = 66
5- THE LINE NUMBER OF THE TOP PUNCH HOLE = 12
6- THE LINE NUMBER OF THE MIDDLE HOLE = 35
7- THE LINE NUMBER OF THE BOTTOM HOLE = 57
8- ASCII CODE FOR THE HOLE DESIGN (PLUS MARK +) = 43
9- ASCII CODE FOR THE HEADER LINE (DASH -) = 45
10- ASCII CODE FOR VERTICAL LINE TO CUT ON AT THE RIGHT EDGE (PERIOD .) = 46
11- ASCII CODE FOR HORIZONTAL LINE TO CUT ON AT THE BOTTOM EDGE (PERIOD .) = 46
12- THE NUMBER OF LINES OF SPACING BETWEEN RIGHT EDGE DESIGN, #10 ABOVE = 4
13- THE NUMBER OF SPACES BETWEEN THE BOTTOM EDGE DESIGN, #11 ABOVE = 5
14- THE WIDTH OF THE LEFT MARGIN = 10
15- WHERE IN THE LEFT MARGIN TO PUT HOLES (must be less than value in #14) = 2
16- PRINTER CODE(S) TO MAKE COMPRESSED PRINT (use commas if needed) = 15
17- PRINTER CODES FOR VERTICAL SPACING CLOSER (use commas) = 27, 51, 26
18- PRINTER CODES TO TURN DOUBLE WIDE PRINT ON (use commas) = 27, 87, 1
19- PRINTER CODES TO TURN DOUBLE WIDE PRINT OFF (use commas) = 27, 87, 0
20- PRINTER CODES TO RESET PRINTER TO NORMAL CONDITION (use commas) = 27, 64
21- DURATION (in seconds) FOR THE INITIAL "READING SMALLDOC.DOC" MESSAGE = 2
22- YOUR NAME IN THE FINAL MESSAGE, "COMPLIMENTS OF" =DAVID ROPER
23- SOUND EFFECTS SWITCH (ON or OFF) = ON
24- AUTOMATIC CAPS LOCK KEY (ON or OFF) = ON
************************************************************starline#2********

DO NOT REMOVE THE ABOVE 2 "STARLINES" OF STARS (*****).

KEEP READING....

CHANGE THE ABOVE VALUES AND CODES BETWEEN THE TWO STARLINES TO SUIT YOU AND TO
SUIT YOUR PRINTER. WHEN THESE VALUES ARE READ BY THE "SMALLDOC.EXE" PROGRAM,
IT USES LOGIC TO FIND THE EQUALS MARK "=" AND THE COMMAS "," TO KNOW HOW TO
FIND THE VALUES. DO NOT CHANGE THE ORDER OF THE LINES. THERE ARE 24 ITEMS.

FOR EXAMPLE, IF YOU DON'T WANT SOUND EFFECTS, USE ANY WORD PROCESSOR TO MAKE
THE LINE 23 ABOVE TO READ:

23- SOUND EFFECTS SWITCH (ON or OFF) = OFF

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

NEXT, COMES THE EXPLANATION OF THE 24 VALUES, CODES, or VARIABLES:


Variable #1 is how many blank lines to put at the top of the small page before
you start printing anything. It is the Top Margin.

Variable #2 is how many blank lines do you want to put at the bottom between
the text and the bottom edge of the small document page.

Variable #3 is the width of the page after it has been put into compressed
print. A small page is about 6 inches wide. At 17 cpi, it will hold 102
characters which is more than enough to make a small page.

Variable #4 is the number of Lines Per Page. Typically, this number is 66.

Variables #5, #6, and #7 define which lines must print the three hole marks to
help you punch the three holes for use in a binder.

Variable #8 defines the DESIGN for the "hole marks". An ASCII 43 is "+".

Variable #9 defines the ASCII character (45) used for printing the Header Line
(------) . Another character you might like to use is the Equals Mark (======)
which is 61.

Variables #10 and #11 are the characters (originally periods ".") that are
used to print the document edges so you will know where to cut.

Variable #12 defines how frequently to print the character defined by #10 at
the RIGHT edge of the small page to be made (i.e. 4 means every 4 lines).

Variable #13 defines how frequently to print the character defined by #11 at
the bottom of the small page (i.e. 5 means every 5 spaces).

Variable #14 is the Width of the Left Margin, i.e. how thick to make a margin
so you can punch holes in it safely without having a hole in the text.

Variable #15 is Where, inside the Width of the Left Margin, that you want the
HOLE design to print. Example: If the Left Margin is 10 and you want the HOLE
DESIGN (+) to print in the middle of it, then make this variable = 5.

Variable #16 is the code(s) to make the printer print in compressed print of
about 17 characters per inch (17 cpi). Some printers go 16.66 cpi which will
be fine. Refer to your Printer Manual for this code or codes.

Variable #17 is the code (or codes) for the printer to use to make the printer
print lines closer together than the normal 6 or 8 lines per inch vertically.
You must obtain these codes from your Printer Manual.

Variables #18 and #19 turn the double wide printing on/off. You should use
the set of codes for your printer that allows this feature to be turned both
ON and OFF on a SINGLE line, WITHIN the line. If your printer does not have
this feature then use 32, 32 for the codes since printers can print the space
character 32. If you use 32, of course, you will not get DOUBLE WIDE printing
of the HEADER.

Variable #20 cannot be used on some printers. Most printers, however, can
be RESET to normal after printing "fancy". EPSON uses ESC,"@" or 27, 64.
IF YOUR PRINTER CANNOT DO A RESET THEN MAKE THE CODE EQUAL TO 255 (i.e. = 255)
SINCE MOST PRINTERS CANNOT PRINT ASCII 255. IF THAT STILL DOES NOT WORK, YOU
COULD USE 32 (WHICH IS A SPACE).

Variable #21 is the duration in seconds for the FIRST MESSAGE seen. This may
be set to zero if you read fast.

Variable #22 is where you will put YOUR name if you want to give away
SMALLDOC.EXE and this combination DOCUMENTATION/CONFIGURATION file. SMALLDOC
comes from the author with the author's name in it.

Variable #23 lets you have SOUND EFFECTS or NOT. (Nelson Ford will have this
set to OFF.)

Variable #24 turns on (or off) the CAPS LOCK KEY so that you will be typing
your Headers automatically in all CAPITAL LETTERS instead of having to
remember to press the CAPS LOCK KEY before you type. I recommend that you
leave this variable set to ON. (it uses DEF SEG=64:poke 23,64 for you
programmers out there.)

HERE IS A "PICTURE" OF WHERE SOME OF THE VARIABLES ARE - ON A SMALLDOC-ed PAGE

"#1" IS THE "TOP MARGIN", ETC. Look between the starlines (*****) above
to reference the numbers #1 thru #24.

-------------------------------------#3---------> #3 is width of page
: #1 . #1 is top margin
: xxxxxxxxtextxxxxxxxxxxxxxxtextxxxxxxxx (how many lines)
: #5 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
: + <--- the "+" marks a punch hole xxxxxx . #5 is top hole line
: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx number
: xxxtextxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx .<------- Right Edge Dot(.)
: #6 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
: + xxxxxxxxxxxxxxxxxxxxxxxxxxtextxxxxxxxx #6 is middle hole line
: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx . number
: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
: xxxxxxxxxxxxtextxxxxxxxxxxxxxxxxxxxxxx
: #7 xxxxxxxxxxxxxxxxxxxxxxxxxxxtextxxxxxxx .
: + xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx #7 is bottom hole line
: xxtextxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx number
: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx .
: #2
:. . . . . . . . . . . .#2 is bottom margin
^ (how many lines)
^
^Bottom Edge (.)


The variables should be untouched until you have run the program a few times
and have decided that you really can't stand the ASCII symbols and the spacing
that I have chosen.

---------------------------------- WARE TYPE ---------------------------------

This is not SHAREWARE. This is LUNCHWARE. If you like this program, then put
YOUR name in the "COMPLIMENTS OF" SECTION (item #22) and take a friend to
lunch, give them a copy, and discuss how "wonderful" it is. That is enough
payment for me. I hope you can use it.

SMALLDOC.EXE was written in BASICA and compiled with QUICK BASIC version 2.0.

-------------- DAVID ROPER - P. O. BOX 680 - GARNER, N. C. 27529 -------------

The following line is put at the end of this file for those people with MODEMS
THE END - You have received all of SMALLDOC.DOC - THE END