Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
mpage(1)
Edit
PageHistory
Diff
Info
LikePages
You are viewing an old revision of this page.
View the current version
.
MPAGE !!!MPAGE NAME SYNOPSIS DESCRIPTION ENVIRONMENT FILES BUGS VERSION AUTHORS ---- !!NAME mpage - print multiple pages per sheet on PostScript printer !!SYNOPSIS __mpage__ [[__-1248aAcEfHloOrRStUvxX__] [[__-b__ ''papersize''] [[__-B__[[''num''[[__lrtb__]*] [[__-C__ [[''encoding'']] [[__-da__''|''__p__'']'' [[__-D__ ''dateformat''] [[__-F__ ''fontname''] [[__-h__ ''header''] [[__-j__ ''first''[[''-last''][[%''interval'']] [[__-L__ ''lines''] [[__-m__[[''num''[[__lrtb__]*] [[__-M__[[''num''[[__lrtb__]*] [[__-p__[[''prprog'']] [[__-P__[[''printer'']] [[__-s__ ''tabstop''] [[__-W__ ''width''] [[__-z__ ''printcmd''] [[__-Z__ ''printcmd_args''] [[''file''...]] !!DESCRIPTION ''mpage'' reads plain text files or PostScript documents and prints them on a PostScript printer with the text reduced in size so that several pages appear on one sheet of paper. This is useful for viewing large printouts on a small amount of paper. It uses ISO 8859.1 to print 8-bit characters. The following options are recognized (note that arguments to options may be separated from the option by spaces, except for __-B__, __-m__, __-M__, __-p__ and __-P__): __-1__ Print 1 normal page per sheet (included for symmetry). __-2__ Print 2 normal pages per sheet. __-4__ Print 4 normal pages per sheet ''(default)''. __-8__ Print 8 normal pages per sheet. __-a__ Toggle layout of the pages on the sheet so that successively numbered pages run down the sheet, as opposed to left to right. (''default'' updown) . __-A__ This option is deprecated, see __-b__. Prepare output for European A4 sized paper. For default see 'mpage -x'. __-b__''papertype'' Prepare output for selected paper type. ''Papersize'' can be ''A3'' for European A3, ''A4'' for European A4, ''Letter'' for US Letter or ''Legal'' for Legal sized paper. For default see 'mpage -x'. To see the list of currently available types, just give the 'mpage -bl' or 'mpage -b?' command (Note: mpage exits after finding such option use.) __-B__[[''''[[__lrtb__]*] Setup a box around a particular part of your page. Specify text box margins and line thickness. The default is 0 columns (lines) for both left and right (top and bottom) margins and 0 line thickness. Specifying __-B__ solely toggles printing of the box. ''l'', ''r'', ''t'' or ''b'' set the left, right, top or bottom margin respectively to '''' columns (lines). Not specifying any of the sides, will set the line thickness when '''' is given. For example __-B__''1'' sets the line thickness to 1. Sides with negative margins will not print. __-c__ Toggle concatenation off pages from different files on single sheets (''default'' off). __-C__[[''encodingfile''] Specify the character encoding file. The file should be in the mpage library directory (''/usr/lib/mpage''). ''Mpage'' has an internal default encoding based on Latin-1 or IBM codepage 850. Depending on compile time option this encoding definition is on or not. Not specifying an encodingfile will toggle the usage of the internal encoding. __-d__''a''|''p'' Force input to be taken as ascii (''a'') or postscript (''p'') text. This way you can print your postscript code as text, or print postscript code that mpage does not recognise. When using __-d__''p'', make sure that the the postscript code contains ''%Page'' page separators or else things will probably look odd. __-D__''dateformat'' Set the date format as in strftime(3) to be used in date/time representations (e.g. in headers). __-E__ Print 2 normal pages per sheet. However, this option will print every second and third page of every set of four pages. This option will ignore __-a__ and __-l__. __-f__ Toggles folding lines longer than page width (''default'' off) . __-F__''fontname'' Specify font. (''default'' Courier). __-h__''header'' This is used only when the __-p__ or __-H__ switch is used and is passed as the __-h__ ''header''''pr__(__1__) or as the header for __-H__. __-H__ Create header line for each logical page separated from page text by a horizontal line. Unless __-h__ is given, the header consist of last file changetime, filename and page number, all in bold and slightly larger font. This option only applies to non-postscript files. __-I__''indent'' Indent text by ''indent'' characters. __-j__''first''[[''-last''][[''%interval''] Print just the selected sheets, specified by number, starting at 1. Here ''last'' defaults to the end of data, ''interval'' to 1. Thus __-j__''1-10'' selects the first 10 sheets, while __-j__ ''1%2'' prints just the odd-numbered sheets and __-j__ ''2%2'' prints just the even ones. You can do double-sided printing, in two passes, as follows. If you use 3-hole punched paper, put it in the printer such that the holes will appear at the top of the page -- on the right as you pull out the printer tray, in our Laser writer II NTX. Print the odd-numbered sheets with mpage ... -j 1%2 ... Note the number of pages it reports. (Only half this many will really be printed). When printing finishes, if mpage reported an ''odd'' number of pages, remove the last one from the stack, since there will be no even-numbered sheet to match it. Then arrange the stack of paper for printing on the other side. (If it's punched, the holes will now be on the left.) On our II NTX, the paper comes out blank-side up; replace it in the tray still blank-side up but rotated 180 degrees. For other printers, you figure it out. Now print the even-numbered sheets in reverse order with mpage ... -r -j 2%2 ... hoping no one else reaches the printer before you do. __-k__ When mapge finds a %%TRailer or %%PSTrailer in the postscript input file it normally assumes this is the end of the postscript file and stops reading the input file. But when the PS file includes EPS files, %%Trailers might be anywhere. Using this option ignores the %%TRailer and %%PSTRailer lines. __-l__ Toggle printing landscape or portrait mode. Landscape pages are 55 lines long by 132 characters wide by default. Portrait pages are 66 lines long by 80 characters wide by default. (''default'' portrait.) __-L__''lines'' Adjust the page reduction parameters so that ''lines'' lines will fit in the space of one page. This overrides the default values normally supplied. (See __-l__.) If used in conjunction with __-p__ then this value is passed to the pr(1) as well. As a side effect this changes the font size as well (as will the __-W__ option.) So while there is an option to change font family, there is no explicit option to change font size! __-m__[[''''[[__lrtb__]*] Specify sheet margin. The default margin is 20 points. Only specifying __-m__ sets left margin to 40 points. ''l'', ''r'', ''t'' or ''b'' set left, right, top or bottom margin respectively to '''' points. Not specifying any of the sides will set all sides when '''' is given. '''' defaults to 40 points. For example __-m__''10'' sets all margins to 10 points. __-m__''l50tb'' sets left margin to default 40 and top and bottom margin to 50 points. __-m__''50l25bt30r'' set bottom and top margin to 25, left margin to 50 and right margin to 30 points. Margins can have negative numbers. Very large values have funny effects. This is left as an exercise to the user. __-M__[[''''[[__lrtb__]*] Specify logical page margins. For syntax, see __-m__ option. Defaults are 4 for __-M__ solely, and 8 for ''''. Margins can be negative. This way large white borders in your (postscript) documents can be reduced. Very large values have funny effects. This is left as an exercise to the user. __-o__ Toggle printing of outlines around each reduced page (''default'' on). __-O__ Print 2 normal pages per sheet. However, this option will print every first and forth page of every set of four pages. This option will ignore __-a__ and __-l__. __-p__[[''prprog''] Pipe input through ''prprog'' command (including specified options) before printing (assumes the input is a text file). When no command is specified, it defaults to pr(1). __-P__[[''printer''] Specify the printer to which the PostScript output will be sent (e.g.lpr -P''printer''). Using __-P__ with no printer specified will send the PostScript to the default printer queue (e.g. lpr). Using -P- will return output to stdout, useful in combination with MPAGE environment variable. Without __-P__ output will be send to standard output. __-r__ Reverse printing. The last sheet is printed first. The way of arranging reduced pages on the sheets doesn't change. __-R__ Switch to left to right mode, starting first page on left bottom corner. This might be useful for landscape postscript files. (Note: using __-l__ after __-R__ undoes __-R__, and switches to normal landscape mode. __-s__''tabstop'' Set tabstop width (''default'' 8 characters). Should by '' __-S__ Accept non-square page reduction. By default, pages are shrunk equally in X and Y, even if this wastes some space on the sheet. With __-S__, reduced pages are larger but slightly distorted. (only used when printing postscript files.) __-t__ Toggle printing on both sides of the paper. This option has 3 states: nop, yes, no, which mean: __NOP__: dont do anything on PostScript, so printer default will be used; __YES__: force printer to do duplex; __NO__: force printer not to do it. If there is no -t, then the duplex is NOP. If you put some -t on the command line, the state toggles as __default'' NOP). __-T__ +Toggle tumble of every second pages. +This option has 3 states: nop, yes, no (with behaviour similar to -t). +So, if your printer is set to print, by default, in duplex mode, +with tumble on, +you will use __-U__ This option is deprecated, see __-b__. Prepare output for US Letter sized paper. For default see 'mpage -x'. __-v__ Toggle printing a count of the number of sheets produced for printing (''default'' off.) __-W__''width'' Adjust the page reduction parameters so that a line with ''width'' characters long will fit in the space of one page. This overrides the default values normally supplied. (See __-l__.) If used in conjunction with __-p__ then this value is passed to the s pr(1) program as well. See also the __-L__ option on font sizes. __-x__ Force usage display, which also shows current defaults. __-X [[header]__ Print header centered on each physical page (sheet). If no header is given, the default is the current filename (note __-c__) on the left and the page number on the right. __-z__''printcommand'' Specify command to use to send output to. Default is __lpr__ (1) for BSD style spooler, __lp__ (1) for SYSV style spooler. You can specify command line options, but note __-Z__. For example __-zlp__ for system V Unix. __-Z__''printprog_queuename_arg'' Specify what option to use for the -z__ ''printcommand'' ''-zlp -Z-d__ for system V Unix. Default is __-P__ for BSD style spooler, __-d__ for SYSV style spooler. !!ENVIRONMENT ''mpage'' examines the __PRINTER__ (or __LPDEST__ for SYSV style spooler) environment variable to override its default printer. The __MPAGE_LIB__ environment variable can be used to control where the character encoding files (__-C__) can be found. ''mpage'' also examines the __MPAGE__ environment variable for default option settings. Any option or combination of options can be specified in the __MPAGE__ environment variable. For example, if MPAGE is set to the string: __-2oPqms -L60__ it would (in the absence of other command line arguments) print 2 pages per sheet, 60 lines per page, with outlines, on the printer named __qms__ (overriding the __PRINTER__/__LPDEST__ environment variable, if it exists.) In the environment variable, white space is used as an option delimiter, and no quoting is recognized. Any command line options will override both the __PRINTER__ and __MPAGE__ environment variables. !!FILES /usr/tmp/mpageXXXXXX /usr/lib/mpage !!BUGS Suffers under the burden of far too many switches. (But __you__ wanted the choices!) NULL characters in a postscript input file will cause mpage to crash! Many others, w're sure. Mpage is year 2000 compliant, as long as the underlying operating system is!!! !!VERSION Version 2.5.1 pre, Released March 1998. Location: http://www.mesa.nl/pub/mpage ftp://ftp.mesa.nl/pub/mpage !!AUTHORS Marcel Mol Mark P. Hahn (Original author) ----
2 pages link to
mpage(1)
:
Man1m
PrintingNotes
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.