home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
World of Shareware - Software Farm 2
/
wosw_2.zip
/
wosw_2
/
PRINTING
/
MPAGE113.ZIP
/
MPAGE.DOC
next >
Wrap
Text File
|
1991-08-19
|
10KB
|
236 lines
NAME
mpage - print Multiple PAGEs per sheet on a POSTSCRIPT printer
SYNOPSIS
mpage [-abcdfisuv] [-e fontname] [-g o|e ] [-h header]
[-l lines] [-m margin] [-n number] [-o orientation]
[-p pages] [-r file] [-t tabs] [-w width] files...
DESCRIPTION
MPAGE reads one or more plain ASCII text files and prints them on a
POSTSCRIPT printer with the text reduced in size so that 1, 2, or 4
pages are fitted on one sheet of paper. (Up to 8 pages on one sheet
when printing on both sides).
It is also possible to set your default MPAGE options in the
environment variable MPAGE. If this variable exist, its options
will be scanned in and placed in front of parameters given on
the command-line. This makes it possible to override default
configuration.
The following options are recognized:
-a When printing 4 pages on the same sheet, one has to decide
where to place succesively numbered pages. This option will
place page N in the upper left quadrant, page N+1 in the upper
right quadrant, page N+2 in the lower left quadrant, and page
N+3 in the lower right quadrant. This is also the default way
of layout.
-b MPAGE will separate the individual pages on a sheet by drawing
a border round each page. Use this option if you do not want
this border to be printed.
-c The default action when a line exceeds the right margin is to
continue on the next line. If you instead want to clip the line
then use this option.
-d When printing 4 pages on the same sheet, one has to decide
where to place succesively numbered pages. This option will
place page N in the upper left quadrant, page N+1 in the lower
left quadrant, page N+2 in the upper right quadrant, and page
N+3 in the lower right quadrant.
-f Each file printed by MPAGE will be preceeded by a frontpage to
specify which file that follows. This is mainly to ease the
separation of several files printed in the same batch. It's
also a great way of spending paper, so feel free to turn it
off with this option.
-i Many DOC-files contains <FF>-codes to split pages at the right
place. This option will force MPAGE to take no notice of such
codes.
-s By default, MPAGE will reserve the last 3 lines of a page to
print the name of the file and the pagenumber. By using this
option this can be turned off, and you gain 3 lines per page.
-u Use this when using US papersize and not A4 which is default.
-v Unless an error occurs, MPAGE will normally not give any hint
at what it is doing at the moment. When used with this verbose
option, MPAGE will print the number of each sheet it has
finished processing.
-e fontname
Allow user-selected font to be used instead of the default
Courier. Please note that no verification is made before
using this font so take care.
-g o|e
I'm running out of letters, so I call this the Grumpf-option.
What it does is simply giving you a option of printing only
odd or even numbered pages. This is useful if you want to
use both sides of the paper; then simply use -g o to print
page 1,3,5,7... - reload the paper and use -g e to print the
other pages. Because of the complexity of this option, it
might be wise of you to experiment a little before starting
a _major_ printjob with several files and prefaces.
-h header
Sometimes it can be useful to print a header on top of each
page. This option let you do exactely that - at the cost of
loosing 2 lines of print per page. Please note that the text
given as header-text must be encapsuled by "" if it contains
more than one word.
-l lines
The default number of lines per page is set to 52 for the
landscape orientation, and 66 for the normal (or portrait)
orientation. By specifying another number of lines the
text fill be scaled to accommodate such a choice. Note that
this number is reduced by 2 when using headers and by 3 when
using stamp. So when using both these options, specifying 66
lines really means you get 61 printable lines.
-m margin
If you plan to bind the sheets produced by MPAGE together,
you may find the margins a bit to narrow. This option will
let you specify a new value for the margin. The default
value is 20, and 40 should be suitable for binding.
-n number
When printing code-listings, I sometimes find linenumbers
for each N'th line usefull. So, to suit myself I included
this as an option in MPAGE. When used, the pagewidth will
be enlarged enough to make room for linenumbers at the end
of the textline. Numbers specify the value of N. Please
observe that this option will also invoke the -i option.
-o orientation
The default orientation of the sheet is to use landscape
when printing 2 pages per sheet, and normal (or portrait)
when printing 1 or 4 pages per sheet. To override this
default orientation, use the -o option followed by a l for
landscape and a n for normal orientation.
-p pages
MPAGE lets you print 1, 2 or 4 pages per sheet. The
default is 4, but with this option you may specify any
of the available choices.
-r file
Not everyone is fortunate enough to have a Postscript
printer on their desk. By using this option MPAGE let
you temporarely store the output on a file for later
dumping it to the printer. If not used, MPAGE will
assume you mean to write directly to PRN:
-t n
By default MPAGE assumes a tab is equal to 8 spaces,
which seems to be the most used value for text-documents.
If you prefer another value, use this option.
-w width
The default number of columns per page is set to 132 for
the landscape orientation, and 80 for the normal (portrait)
orientation. By specifying another number of columns the
text fill be scaled to accommodate such a choice.
files...
All other commandline arguments will be taken as filenames
of files to print. Wildcards are now supported.
VERSIONS
Version 1.00, Not released
- initial version, only 4 pages per sheet in portrait
Version 1.01, Not released
- added support for 1 and 2 pages per sheet
- added support for landscape orientation
- added support for frontpage
- added support for stamp (filename/page)
- added support for ignoring <FF> codes
- added support for headertext
- added support for marginsettings
- added support for norwegian characters
- fixed bug regarding pagelenght and pagewidth
- fixed bug regarding '(', ')', and '\'
- fixed bug regarding bad clipregion
- changed default values to more 'obvious' values
Version 1.02, Not released
- added support for linenumbering
Version 1.03, Not released
- fixed bug regarding linenumbering
- optimized code
Version 1.04, Not released
- OS/2 support, MPAGE now works for MS-DOS and OS/2
Version 1.05, Relased March 1991
- added support for clipping of lines exceeding rightmargin
- added support for US papersizes
Version 1.05e, Released March 1991
- added support for selecting font
Version 1.06, Not released
- added support for environment-variable MPAGE
Version 1.07, Not released
- removed support for selecting font
- added support for boldfacing specific words
Version 1.08, Not released
- added support for wildcards
- fixed bug regarding boldfacing
Version 1.09, Not released
- several bugfixes
Version 1.10, Not released
- still more bugfixes
- added support for printing only odd or even pages
Version 1.11, Released April 1991
- re-added support for selecting font
- removed support for boldfacing
Version 1.12, Released April 1991
- changed some default values
Version 1.13, Released August 1991
- added support for Finnish/Swedish characters as well
BUGS
No bugs are known to me at the time, but several features
might be living in the dark areas of the code.
SPECIAL THANKS
goes to Mark Hahn for his UNIX version of MPAGE, which output
I used as a model for coordinate-calculations.
AUTHOR
Trond Brande Internet: brande@idt.unit.no
Oernetua 4 brande@[129.241.103.1]
N-6009 AALESUND
NORWAY
LICENCE
MPAGE is the copyrighted property of Trond Brande. You are
granted a limited license to use MPAGE, and to copy it and
distribute it, provided the following conditions are met :
1) No fee may be charged for such copying and distribution.
2) MPAGE may ONLY be distributed in its original, unmodified
state.
Any voluntary contributions for the use of this program will
be appreciated, and should be sent to the above adress.