diff options
author | Peter Breitenlohner <peb@mppmu.mpg.de> | 2011-02-07 09:10:40 +0000 |
---|---|---|
committer | Peter Breitenlohner <peb@mppmu.mpg.de> | 2011-02-07 09:10:40 +0000 |
commit | 5d5723a8324653e6a6f410823477dea7356f0dc5 (patch) | |
tree | eafe7f61589dce1ecae9d5d3f4aa57cf4871b64a /Master/texmf | |
parent | 09f59333ebe07c811ffc67a163a0609b7b76a3dc (diff) |
update/add manpages
git-svn-id: svn://tug.org/texlive/trunk@21333 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf')
40 files changed, 555 insertions, 332 deletions
diff --git a/Master/texmf/doc/man/man1/bbox.1 b/Master/texmf/doc/man/man1/bbox.1 index 9efc9e05c2d..64696f32645 100644 --- a/Master/texmf/doc/man/man1/bbox.1 +++ b/Master/texmf/doc/man/man1/bbox.1 @@ -3,12 +3,13 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "BBOX" "1" "21 April 2004" "" "" +.TH "BBOX" "1" "31 August 2010" "" "" + .SH NAME bbox \- prints out the bounding box of a rawppm or rawpbm image .SH SYNOPSIS -\fBbbox\fR [ \fB-l\fR] [ \fB-r\fR] [ \fB-h\fR] [ \fB-V\fR] [ \fB\fIrawpbmfile\fB\fR] +\fBbbox\fR [ \fB-l\fR ] [ \fB-r\fR ] [ \fB-h\fR ] [ \fB-V\fR ] [ \fB\fIrawpbmfile\fB\fR ] .SH "DESCRIPTION" .PP @@ -41,7 +42,7 @@ resolution of picture in dpi .TP \fB-l \fR loose bounding box (integer bounding box is expanded by 1 -point, hires bounding box is not widened) +point, hires bounding box is expanded by 0.5 points) .SH "SEE ALSO" .PP ps2eps (1) @@ -50,6 +51,9 @@ ps2eps (1) \fBbbox\fR was written by Roland Bless. .SS "ACKNOWLEDGMENTS" .PP +Special thanks goes to Michael Sharpe from UCSD who suggested a lot of improvements for +bbox to become more precise and robust, especially for small drawings. +.PP An earlier version of this manual page was originally written by Rafael Laboissiere <rafael@debian.org> for the Debian system. Thank you Rafael! Permission is diff --git a/Master/texmf/doc/man/man1/disdvi.1 b/Master/texmf/doc/man/man1/disdvi.1 new file mode 100644 index 00000000000..e59ce5ce46b --- /dev/null +++ b/Master/texmf/doc/man/man1/disdvi.1 @@ -0,0 +1,27 @@ +.TH DISDVI 1 "27 October 2010" +.SH NAME +disdvi \- `disassemble' a (p)TeX or XeTeX DVI file +.SH SYNOPSIS +.B disdvi +.RB [ \-p ] +.RI [ dvi_file [ \fB.dvi\fP ]] +.br +.B disdvi \-x +.RI [ xdv_file [ \fB.xdv\fP ]] +.br +.B disdvi \-h +.SH DESCRIPTION +.I disdvi +interprets the contents of +.IR dvi_file +or +.IR xdv_file +printing the DVI commands and text in a human-readable ASCII format on +the standard output. +.SH "SEE ALSO" +.BR dvi2tty (1) +.SH AUTHOR +Marcel J.E. Mol, Delft University of Technology, The Netherlands +.br +marcel@mesa.nl, MESA Consulting + diff --git a/Master/texmf/doc/man/man1/dvi2tty.1 b/Master/texmf/doc/man/man1/dvi2tty.1 index 168a073373d..443308ccd57 100644 --- a/Master/texmf/doc/man/man1/dvi2tty.1 +++ b/Master/texmf/doc/man/man1/dvi2tty.1 @@ -1,36 +1,38 @@ -.TH DVI2TTY Local "7 June 1986" +.TH DVI2TTY 1 "13 November 1990" .SH NAME -dvi2tty \- preview a dvi\-file on an ordinary ascii terminal +dvi2tty \- preview a TeX DVI\-file on an ordinary ascii terminal .SH SYNOPSIS .B dvi2tty [ options ] dvi\-file .SH DESCRIPTION .I dvi2tty -converts a TeX DVI\-file to a format that is apprporiate for terminals -and lineprinters. The program is intended to be used for +converts a TeX DVI\-file to a format that is appropriate for terminals +and line printers. The program is intended to be used for preliminary proofreading of TeX-ed documents. By default the output is directed to the terminal, possibly through a pager (depending on how the program was installed), but it can be directed to a file or a pipe. .PP The output leaves much to be desired, but is still -usefull if you want to avoid walking to the -laserprinter (or whatever) for each iteration of your +useful if you want to avoid walking to the +laser printer (or whatever) for each iteration of your document. .br Since .I dvi2tty -produces output for terminals and lineprinters the +produces output for terminals and line printers the representation of documents is naturally quite primitive. -Fontchanges are totally ignored, which implies that -special symbols, such as mathematical symbols, get mapped into the -characters at the corresponding positions in the "standard" fonts. +In principle Font Changes are totally ignored, but +.I dvi2tty +recognizes +a few mathematical and special symbols that can be be displayed on an +ordinary ascii terminal, such as the '+' and '-' symbol. .PP If the width of the output text requires more columns than fits in one line (c.f. the \-w option) it is broken into several lines by .I dvi2tty although they will be printed as one line on regular TeX output -devices (e.g. laserprinters). To show that a broken line is really +devices (e.g. laser printers). To show that a broken line is really just one logical line an asterisk (``*'') in the last position means that the logical line is continued on the next physical line output by @@ -39,7 +41,7 @@ Such a continuation line is started with a a space and an asterisk in the first two columns. .PP Options may be specified in the environment variable DVI2TTY. -Any option on the commandline, conflicting with one in the +Any option on the command line, conflicting with one in the environment, will override the one from the environment. .PP .B Options: @@ -54,7 +56,7 @@ Numbers refer to TeX\-page numbers (known as \\count0). An example of format for list is ``1,3:6,8'' to choose pages 1, 3 through 6 and 8. Negative numbers can be used exactly as in TeX, -e g \-1 comes before \-4 as in ``\-p-1:-4,17''. +e g \-1 comes before \-4 as in ``\-p\-1:\-4,17''. .TP .B \-P list Like \-p except that page numbers refer to @@ -71,61 +73,93 @@ be a good idea to use \-w132 and toggle the terminal into this mode as output will probably look somewhat better. .TP +.B \-v +Specify height of lines. Default value 450000. Allows to adjust linespacing. +.TP .B \-q Don't pipe the output through a pager. This may be the default on some systems -(depending on the whims of the SA installing the program). +(depending on the whims of the person installing the program). +.TP +.B \-e n +This option can be used to influence the spacing between words. +With a negative value the number of spaces +between words becomes less, with a positive value it becomes more. +\-e\-11 seems to worked well. .TP .B \-f -Pipe through a pager, $PAGER if defined, or whatever your SA compiled +Pipe through a pager, $PAGER if defined, or whatever the installer of +the program compiled in (often ``more''). This may be the default, but it is still okay to redirect output with ``>'', the pager will not be used if output is not going to a terminal. .TP .B \-F Specify the pager program to be used. -This overides the $PAGER and the default pager. +This overrides the $PAGER and the default pager. .TP .B \-Fprog Use ``prog'' as program to pipe output into. Can be used to choose an alternate pager (e g ``-Fless''). .TP +.B \-t +\\tt fonts were used (instead of cm) to produce dvi file. (screen.sty +is a powerfull mean to do that with LaTeX). +.TP +.B \-a +Dvi2tty normally tries to output accented characters. With the -a option, +accented characters are output without the accent sign. +.TP .B \-l -Mark pagebreaks with the two-character sequence ``^L''. The default is -to mark them with a formfeed character. +Mark page breaks with the two-character sequence ``^L''. The default is +to mark them with a form-feed character. +.TP +.B \-c +Do not attempt to translate any characters (like the Scandinavion/latin1 mode) +except when running in tt-font. .TP .B \-u -Don't make any attempts to find special Scandinavian characters. -If such characters are in the text they will map to ``a'' and ``o''. -This is probably the default outside of Scandinavia. (The SA made -the decision when the program was installed.) +Toggle option to process certain latin1 characters. Use this if your output +devices supports latin1 cahracters. +Note this may interfere with -s. Best not to use -u and -s together. .TP .B \-s -Try to find the special Scandinavian characters that on most (?) +Toggle option to process the special Scandinavian characters that on most (?) terminals in Scandinavia are mapped to ``{|}[\\]''. -This can be the default, and output from files not containing these -special characters will be identical regardless of this option. +Note this may interfere with -u. Best not to use -u and -s together. +.TP +.B \-J +Auto detect NTT JTeX and ASCII pTeX dvi format. +.TP +.B \-N +Display NTT JTeX dvi. +.TP +.B \-A +Display ASCII pTeX dvi. +.TP +.B \-bdelim +Print the name of fonts when switching to it (and ending it). The delim +argument is used to delimit the fontname. .SH FILES -/usr/ucb/more \ \ \ \ +/bin/more \ \ \ \ probably the default pager. .SH ENVIRONMENT PAGER \ \ \ \ \ \ \ \ \ \ \ \ the pager to use. .br DVI2TTY \ \ \ \ \ \ \ \ \ \ \ -can be set to hold commandline options. +can be set to hold command-line options. .SH "SEE ALSO" TeX, dvi2ps .SH AUTHOR -Svante Lindahl, Royal Institute of Technology, Stockholm +Original Pascal verion: Svante Lindahl, Royal Institute of Technology, Stockholm .br Improved C version: Marcel Mol .br -{seismo, mcvax}!enea!ttds!zap -.br -marcel@duteca.UUCP +marcel@mesa.nl, MESA Consulting .SH BUGS Blanks between words get lost quite easy. This is less likely if you are using a wider output than the default 80. .PP -Only one file may be specified on the commandline. +Only one file may be specified on the command line. + diff --git a/Master/texmf/doc/man/man1/dvidvi.1 b/Master/texmf/doc/man/man1/dvidvi.1 index e9906a6e874..0e464f4d3e0 100644 --- a/Master/texmf/doc/man/man1/dvidvi.1 +++ b/Master/texmf/doc/man/man1/dvidvi.1 @@ -1,4 +1,4 @@ -.TH DVIDVI L "March 1994" +.TH DVIDVI L "February 2011" .SH NAME .PP dvidvi \- selects and/or re-arranges pages in a TeX dvi file @@ -6,8 +6,6 @@ dvidvi \- selects and/or re-arranges pages in a TeX dvi file .PP dvidvi [param] infile outfile .SH DESCRIPTION -.SS Copyright -dvidvi 1.0, Copyright (C) 1988-91, Radical Eye Software .SS Introduction .PP The dvidvi program converts a dvi file into another dvi file, with perhaps @@ -88,6 +86,10 @@ a decimal number with an optional unit of measure. The default unit of measure is inches, or the last unit of measure used. All units are in true dimensions. Allowable units of measure are the same that TeX allows: in, mm, cm, pt, pc, dd, and cc. +.SS Copyright +dvidvi 1.0, Copyright (C) 1988-2011, Radical Eye Software +Anyone may freely use, modify and/or distribute this program and +documentation, or any portion thereof, without limitation. .SH EXAMPLES .PP .in +10 @@ -124,4 +126,3 @@ letters. Print a four-page card on one sheet. Print the first, rotate the paper 180 degrees and feed it again. (PostScript people can do funny tricks with PostScript so this isn't necessary.) - diff --git a/Master/texmf/doc/man/man1/dvipng.1 b/Master/texmf/doc/man/man1/dvipng.1 index 228ba202046..934a7c9aac5 100644 --- a/Master/texmf/doc/man/man1/dvipng.1 +++ b/Master/texmf/doc/man/man1/dvipng.1 @@ -132,7 +132,7 @@ .\" ======================================================================== .\" .IX Title "DVIPNG 1" -.TH DVIPNG 1 "2010-05-07" "dvipng 1.13" "User commands" +.TH DVIPNG 1 "2010-12-15" "dvipng 1.14" "User commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -205,9 +205,11 @@ TeX color \especial syntax, e.g., 'rgb 1.0 0.0 0.0'. Setting the fallback color makes the default border width 1 px. .IP "\fB\-\-bdpi\fR \fInum\fR" 4 .IX Item "--bdpi num" -Set the base (Metafont) resolution, both horizontal and vertical, to -\&\fInum\fR dpi (dots per inch). This option is necessary when manually -selecting Metafont mode with the \-\-mode option (see below). +This option only has an effect when using bitmapped (\s-1PK\s0) fonts. The +option sets the base (Metafont) resolution, both horizontal and +vertical, to \fInum\fR dpi (dots per inch). This option is necessary +when manually selecting Metafont mode with the \-\-mode option (see +below). .IP "\fB\-bg\fR \fIcolor_spec\fR" 4 .IX Item "-bg color_spec" Choose background color for the images. This option will be ignored if @@ -289,12 +291,12 @@ available if the FreeType2 font library was present at compilation time. If this is the case, dvipng will have direct support for PostScript Type1 and TrueType fonts internally, rather than using \fBgsftopk\fR for rendering the fonts. If you have PostScript versions of Computer -Modern installed, there will be no need to generate bitmapped variants -on disk of these. Then, you can render images at different (and unusual) -resolutions without cluttering the disk with lots of bitmapped fonts. -Note that if you have both FreeType and T1lib on your system, FreeType -will be preferred by dvipng. If you for some reason would want to use -T1lib rendering, use this option. +Modern installed, there will be no need to generate bitmapped (\s-1PK\s0) +variants on disk of these. Then, you can render images at different (and +unusual) resolutions without cluttering the disk with lots of bitmapped +fonts. Note that if you have both FreeType and T1lib on your system, +FreeType will be preferred by dvipng. If you for some reason would want +to use T1lib rendering, use this option. .IP "\fB\-\-gamma\fR \fInum\fR" 4 .IX Item "--gamma num" Control the interpolation of colors in the greyscale anti-aliasing @@ -328,20 +330,20 @@ Thus, using \fB\-l =9\fR will end with the ninth page of the document, no matter what the pages are actually numbered. .IP "\fB\-\-mode\fR \fImode\fR" 4 .IX Item "--mode mode" -Use \fImode\fR as the Metafont device name for the \s-1PK\s0 fonts (both for -path searching and font generation). This needs to be augmented with the -base device resolution, given with the \fB\-\-bdpi\fR option. See the -file <\fBftp://ftp.tug.org/tex/modes.mf\fR> for a list of resolutions and -mode names for most devices. +This option only has an effect when using bitmapped (\s-1PK\s0) fonts. Use +\&\fImode\fR as the Metafont device name for the \s-1PK\s0 fonts (both for path +searching and font generation). This needs to be augmented with the base +device resolution, given with the \fB\-\-bdpi\fR option. See the file +<\fBftp://ftp.tug.org/tex/modes.mf\fR> for a list of resolutions and mode +names for most devices. .IP "\fB\-M*\fR" 4 .IX Item "-M*" -Turns off automatic \s-1PK\s0 font generation (\fImktexpk\fR). This will have -no effect when using PostScript fonts, since no \s-1PK\s0 font generation will -be done anyway. -.IP "\fB\-\-noghostscript*\fR" 4 -.IX Item "--noghostscript*" +This option only has an effect when using bitmapped (\s-1PK\s0) fonts. It turns +off automatic \s-1PK\s0 font generation (\fImktexpk\fR). +.IP "\fB\-\-nogs*\fR" 4 +.IX Item "--nogs*" This switch prohibits the internal call to GhostScript for displaying -PostScript specials. \fB\-\-noghostscript0\fR turns the call back on. +PostScript specials. \fB\-\-nogs0\fR turns the call back on. .IP "\fB\-\-nogssafer*\fR" 4 .IX Item "--nogssafer*" Normally, if GhostScript is used to render PostScript specials, the @@ -350,6 +352,12 @@ GhostScript interpreter is run with the option \fB\-dSAFER\fR. The \&\fB\-dSAFER\fR option in Ghostscript disables PostScript operators such as deletefile, to prevent possibly malicious PostScript programs from having any effect. +.IP "\fB\-\-norawps*\fR" 4 +.IX Item "--norawps*" +Some packages generate raw PostScript specials, even non-rendering such +specials. This switch turns off the internal call to GhostScript +intended to display these raw PostScript specials. \fB\-\-norawps0\fR +turns the call back on. .IP "\fB\-o\fR \fIname\fR" 4 .IX Item "-o name" Send output to the file \fIname\fR. A single occurrence of \fB\f(CB%d\fB\fR or @@ -375,14 +383,13 @@ a value to compare with the TeX \fB\ecount0\fR values stored in the the document, no matter what the pages are actually numbered. .IP "\fB\-\-palette*\fR" 4 .IX Item "--palette*" -Starting from \fBdvipng\fR 1.8, the output \s-1PNG\s0 will be a truecolor -png when an external image is included, to avoid unnecessary delay and -quality reduction, and enable the \s-1EPS\s0 translator to draw on a -transparent background and outside of the boundingbox. This switch -will force palette (256\-color) output and make \fBdvipng\fR revert to -the old behaviour, where included images were opaque and always -clipped to the boundingbox. This will also override the -\&\fB\-\-truecolor\fR switch if present. +When an external image is included, \fBdvipng\fR will automatically +switch to truecolor mode, to avoid unnecessary delay and quality +reduction, and enable the \s-1EPS\s0 translator to draw on a transparent +background and outside of the boundingbox. This switch will force +palette (256\-color) output and make \fBdvipng\fR revert to opaque +clipped image inclusion. This will also override the \fB\-\-truecolor\fR +switch if present. .IP "\fB\-\-picky*\fR" 4 .IX Item "--picky*" No images are output when a warning occurs. Normally, dvipng will @@ -422,10 +429,10 @@ output; report no warnings (only errors) to standard error. .IP "\fB\-Q\fR \fInum\fR" 4 .IX Item "-Q num" Set the quality to \fInum\fR. That is, choose the number of antialiasing -levels for \s-1PK\s0 and T1lib rendering to be \fInum\fR*\fInum\fR+1. The default -value is 4 which gives 17 levels of antialiasing for antialiased fonts -from these two. If FreeType is available, its rendering is unaffected by -this option. +levels for bitmapped fonts (\s-1PK\s0) and fonts rendered using T1lib, to be +\&\fInum\fR*\fInum\fR+1. The default value is 4 which gives 17 levels of +antialiasing for antialiased fonts from these two. If FreeType is +available, its rendering is unaffected by this option. .IP "\fB\-r*\fR" 4 .IX Item "-r*" Toggle output of pages in reverse/forward order. By default, the first @@ -449,17 +456,17 @@ the left in the produced image. The value \fBtight\fR will make dvipng only include all ink put on the page, producing neat images. .IP "\fB\-\-t1lib*\fR" 4 .IX Item "--t1lib*" -Enable/disable T1lib font rendering (default on). This option is -available if the T1lib font library was present at compilation time. If -this is the case, dvipng will have direct support for PostScript Type1 -fonts internally, rather than using \fBgsftopk\fR for rendering the -fonts. If you have PostScript versions of Computer Modern installed, -there will be no need to generate bitmapped variants on disk of these. -Then, you can render images at different (and unusual) resolutions -without cluttering the disk with lots of bitmapped fonts. Note that if -you have both FreeType and T1lib on your system FreeType will be -preferred by dvipng, and if you for some reason rather want to use -T1lib, give the option \fB\-\-freetype0\fR (see above). +Enable T1lib font rendering (default on). This option is available if +the T1lib font library was present at compilation time. If this is the +case, dvipng will have direct support for PostScript Type1 fonts +internally, rather than using \fBgsftopk\fR for rendering the fonts. If +you have PostScript versions of Computer Modern installed, there will be +no need to generate bitmapped variants on disk of these. Then, you can +render images at different (and unusual) resolutions without cluttering +the disk with lots of bitmapped fonts. Note that if you have both +FreeType and T1lib on your system, FreeType will be preferred by dvipng, +and if you for some reason rather want to use T1lib, give the option +\&\fB\-\-freetype0\fR (see above). .IP "\fB\-\-truecolor*\fR" 4 .IX Item "--truecolor*" This will make \fBdvipng\fR generate truecolor output. Note that @@ -477,12 +484,14 @@ Report the width of the image. See also \fB\-\-height\fR and \&\fB\-\-depth\fR. .IP "\fB\-x\fR \fInum\fR" 4 .IX Item "-x num" -Set the x magnification ratio to \fInum\fR/1000. Overrides -the magnification specified in the \s-1DVI\s0 file. Must be between 10 and -100000. It is recommended that you use standard magstep values (1095, -1200, 1440, 1728, 2074, 2488, 2986, and so on) to help reduce the total -number of \s-1PK\s0 files generated. \fInum\fR may be a real number, not an -integer, for increased precision. +This option is deprecated; it should not be used. It is much better to +select the output resolution directly with the \fB\-D\fR option. This +option sets the magnification ratio to \fInum\fR/1000 and +overrides the magnification specified in the \s-1DVI\s0 file. Must be between +10 and 100000. It is recommended that you use standard magstep values +(1095, 1200, 1440, 1728, 2074, 2488, 2986, and so on) to help reduce the +total number of \s-1PK\s0 files generated. \fInum\fR may be a real number, not +an integer, for increased precision. .IP "\fB\-z\fR \fInum\fR" 4 .IX Item "-z num" Set the \s-1PNG\s0 compression level to \fInum\fR. This option is enabled if @@ -498,7 +507,7 @@ considerably fewer calculations. In the future, these values may not correspond directly to the zlib compression levels.\*(R" .SH "NOTES" .IX Header "NOTES" -The full manual is accessible in the info format, on most systems by typing +The full manual is accessible in info format, on most systems by typing .PP .Vb 1 \& info dvipng diff --git a/Master/texmf/doc/man/man1/dvisvgm.1 b/Master/texmf/doc/man/man1/dvisvgm.1 index 6f51f38e1fa..13970ac2de4 100644 --- a/Master/texmf/doc/man/man1/dvisvgm.1 +++ b/Master/texmf/doc/man/man1/dvisvgm.1 @@ -1,13 +1,13 @@ '\" t .\" Title: dvisvgm .\" Author: [see the "AUTHOR" section] -.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/> -.\" Date: 11/09/2009 +.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> +.\" Date: 08/06/2010 .\" Manual: dvisvgm Manual -.\" Source: dvisvgm 0.8.7 +.\" Source: dvisvgm 1.0.3 .\" Language: English .\" -.TH "DVISVGM" "1" "11/09/2009" "dvisvgm 0\&.8\&.7" "dvisvgm Manual" +.TH "DVISVGM" "1" "08/06/2010" "dvisvgm 1\&.0\&.3" "dvisvgm Manual" .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- @@ -25,19 +25,27 @@ dvisvgm \- converts DVI files to the XML\-based SVG format \fBdvisvgm\fR [ \fIoptions\fR ] \fIfile\fR [\&.dvi] .SH "DESCRIPTION" .sp -The program \fBdvisvgm\fR generates an SVG file from a given DVI file\&. DVI is the device independent output format produced by TeX and some other typesetting systems\&. Output from groff can be converted to DVI using grodvi\&. +The command\-line utility \fBdvisvgm\fR converts DVI files, as generated by TeX/LaTeX, to the XML\-based scalable vector graphics format SVG\&. Since the current SVG standard 1\&.1 doesn\(cqt specify multi\-page graphics, \fBdvisvgm\fR creates separate SVG files for each DVI page\&. Because of compatibility reasons, only the first page is converted by default\&. In order to select a different page or arbitrary page sequences, use option \fB\-p\fR which is described below\&. .sp -The recent version of \fBdvisvgm\fR provides advanced conversion functionality but currently only one page can be converted even if the DVI file is made up of multiple pages\&. You can select the page to be processed with option \fB\-p\fR\&. \fBdvisvgm\fR should properly convert all pages that are made up of fonts and rules only\&. Additionally, some sets of specials are understood as well\&. For a more detailed overview, see section \fBsupport of specials\fR below\&. +\fBdvisvgm\fR should properly convert all pages that are made up of fonts and rules only\&. However, the utility also supports a couple of DVI extensions defined in terms of \fIDVI specials\fR\&. For a more detailed overview, see section \fBsupport of specials\fR below\&. .sp -Since SVG is a vector based graphics format, \fBdvisvgm\fR tries to convert the glyph outlines of all used fonts into scalable path descriptions\&. The fastest way to do that is to extract the path information from PFB (PostScript Type 1) files\&. So if \fBdvisvgm\fR is able to find a PFB file for a used font, it will read the necessary information from it\&. +As SVG is a vector based graphics format, \fBdvisvgm\fR tries to convert the glyph outlines of all used fonts into scalable path descriptions\&. The fastest way to do that is to extract the path information from PFB (PostScript Type 1) files\&. So, if \fBdvisvgm\fR is able to find a PFB file for a required font, it will read the necessary information from it\&. .sp -TeX\(cqs main source for font descriptions is Metafont which produces bitmap output \&.That\(cqs why not all obtainable TeX fonts are available in PFB format\&. In these cases \fBdvisvgm\fR tries to vectorize Metafont\(cqs output by tracing the glyph bitmaps\&. The results are not as perfect as most (manually optimized) PFB outlines but are nonetheless really nice in most cases\&. +TeX\(cqs main source for font descriptions is Metafont though, which produces bitmap output\&. That\(cqs why not all obtainable TeX fonts are available in PFB format\&. In these cases \fBdvisvgm\fR tries to vectorize Metafont\(cqs output (GF fonts) by tracing the glyph bitmaps\&. The results are not as perfect as most (manually optimized) PFB outlines but are nonetheless really nice in most cases\&. .SH "OPTIONS" .PP -\fB\-a, \-\-trace\-all\fR +\fB\-a, \-\-trace\-all\fR=[\fIretrace\fR] .RS 4 This option forces dvisvgm to trace not just the actually needed glyphs but all glyphs of all bitmap fonts used in the DVI file\&. Since the tracing results are stored in the font cache, all following DVI conversions (without option -\fB\-\-trace\-all\fR) where these fonts are involved will be much faster\&. By default, dvisvgm traces only the actually needed glyphs and adds them to the cache\&. +\fB\-\-trace\-all\fR) where these fonts are involved will be much faster\&. By default, dvisvgm traces only the actually needed glyphs and adds them to the cache\&. The boolean option +\fIretrace\fR +determines how to handle glyphs that are already stored in the cache\&. By default, these glyphs are skipped\&. Setting argument +\fIretrace\fR +to +\fIyes\fR +or +\fItrue\fR +forces dvisvgm to trace the corresponding bitmaps again\&. .if n \{\ .sp .\} @@ -69,6 +77,9 @@ takes either one of the format specifiers listed below or a sequence of four com and \fIy2\fR\&. The latter define two diagonal corners of the bounding box\&. Each length value consists of a floating point number and an optional length unit (pt, bp, cm, mm, in, or pc)\&. If the unit is omitted, TeX points (pt) are assumed\&. .sp +It\(cqs also possible to give only one length value +\fIl\fR\&. In this case the minimal bounding box is computed and enlarged by adding (\-\fIl\fR,\-\fIl\fR) to the upper left and (\fIl\fR,\fIl\fR) to the lower right corner\&. +.sp Alternatively, the following format specifiers are supported: .PP \fBInternational DIN/ISO paper sizes\fR @@ -157,7 +168,8 @@ only affects the bounding box and does not transform the page content\&. Hence i Scales page content horizontally by \fIsx\fR and vertically by -\fIsy\fR\&. This option is equivalent to *\-TS*\fIsx\fR,\fIsy\fR\&. +\fIsy\fR\&. This option is equivalent to +\fB\-TS\fR\fIsx\fR,\fIsy\fR\&. .RE .PP \fB\-C, \-\-cache\fR[=\fIdir\fR] @@ -172,6 +184,30 @@ to overwrite the default\&. Furthermore, it is also possible to disable the font is omitted, dvisvgm prints the path of the default cache directory and some information about the stored fonts\&. .RE .PP +\fB\-\-color\fR +.RS 4 +Enables colorization of messages printed during the conversion process\&. +.RE +.PP +\fB\-e, \-\-exact\fR +.RS 4 +If this option is given, dvisvgm computes the precise bounding box of each character\&. By default, the values stored in the font\(cqs TFM file are used to determine a glyph\(cqs extent\&. As these values are intended to realize optimal character placements and are not designed to represent the exact dimensions, they don\(cqt necessarily correspond with the bounds of the visual glyphs\&. Thus, the width and/or height of some glyphs may be larger than the respective TFM values\&. As a result, this can lead to clipped characters at the bounds of the SVG graphic\&. With option +\fB\-\-exact\fR, dvisvgm analyzes the actual shape of each character and derives a usually tight bounding box\&. +.RE +.PP +\fB\-h, \-\-help\fR +.RS 4 +Prints a short summary of all available command\-line options\&. +.RE +.PP +\fB\-\-libgs=filename\fR +.RS 4 +This option is only available if the Ghostscript library is not directly linked to dvisvgm and PostScript support was not completely disabled\&. In this case, dvisvgm tries to load the shared GS library dynamically during runtime\&. By default, it expects the library\(cqs name to be libgs\&.so (on Unix\-like systems) or gsdll32\&.dll (Windows)\&. Option +\fB\-\-libgs\fR +can be used to give a different name\&. Alternatively, the GS library name can also be set by the environment variable +\fBLIBGS\fR\&. The latter has a less precedence than the command\-line option\&. +.RE +.PP \fB\-l, \-\-list\-specials\fR .RS 4 Prints a list of registered special handlers and exits\&. Each handler processes a set of special statements belonging to the same category\&. The categories are identified by the prefix of the special statements\&. It\(cqs usually a leading word separated from the rest of the statement by a colon or a blank, e\&.g\&. @@ -180,6 +216,11 @@ or \fIps\fR\&. .RE .PP +\fB\-\-keep\fR +.RS 4 +Disables the removal of temporary files as created by Metafont (usually \&.gf, \&.tfm, and \&.log files)\&. +.RE +.PP \fB\-m, \-\-map\-file\fR=\fIfile\fR .RS 4 Sets the map file that is used to look up font names and encodings\&. @@ -245,23 +286,51 @@ Suppresses the generation of missing font files\&. If can\(cqt find a font file through the kpathsea lookup mechanism, it calls the external tools mktextfm or mktexmf by default\&. This option disables these calls\&. .RE .PP -\fB\-o, \-\-output\fR=\fIfile\fR +\fB\-o, \-\-output\fR=\fIpattern\fR .RS 4 -Sets the name of the output file\&. -.RE -.PP -\fB\-p, \-\-page\fR=\fInumber\fR -.RS 4 -With this option you can choose the page to be processed\&. Please consider that the parameter of this option don\(cqt refer to the page numbers printed on the page\&. Instead the physical page count is expected, where the first page always gets number 1\&. If this option is omitted, the first page will be selected\&. +Sets the name pattern of the output file\&. The parameter +\fIpattern\fR +is a string that may contain the variables +\fB%f\fR +and +\fB%p\fR\&. +\fB%f\fR +stands for the base name of the DVI file, i\&.e\&. the DVI filename without suffix, and +\fB%p\fR +is the current page number\&. By default, the pattern is +\fB%f\-%p\&.svg\fR +if the DVI file consists of more than one page, and +\fB%f\&.svg\fR +otherwise\&. That means, a DVI file +\fIfoo\&.dvi\fR +is converted to +\fIfoo\&.svg\fR +if +\fIfoo\&.dvi\fR +is a single\-page document\&. Otherwise, multiple SVG files +\fIfoo\-01\&.svg\fR, +\fIfoo\-02\&.svg\fR, etc\&. are produced\&. In Windows environments, the percent sign is used to get the value of environment variables, and must therefore be protected by a second percent sign, e\&.g\&. +\fB\-\-output=%%f\-%%p\fR\&. +.RE +.PP +\fB\-p, \-\-page\fR=\fIranges\fR +.RS 4 +This option sets the pages to be processed\&. Parameter +\fIranges\fR +consists of a comma\-separated list of single page numbers and/or page ranges\&. A page range is a pair of numbers separated by a hyphen, e\&.g\&. 5\-12\&. Thus, a page sequence might look like this: 2\-4,6,9\-12,15\&. It doesn\(cqt matter if a page is given more than once or if page ranges overlap\&. +\fBdvisvgm\fR +always extracts the page numbers in ascending order and converts them only once\&. In order to stay compatible with previous versions, the default page sequence is 1\&. dvisvgm therefore converts only the first page and not the whole document in case option +\fB\-\-page\fR +is not given\&. Usually, page ranges consist of two numbers denoting the first and last page to be converted\&. If the conversion is to be started at page 1, or if it should continue up to the last DVI page, the first or second range number can be omitted, respectively\&. Example: +\fB\-\-page=\-10\fR +converts all pages up to page 10, +\fB\-\-page=10\-\fR +converts all pages starting with page 10\&. Please consider that the page values don\(cqt refer to the page numbers printed on the page\&. Instead, the physical page count is expected, where the first page always gets number 1\&. .RE .PP -\fB\-P, \-\-progress\fR[=\fIskip\fR] +\fB\-P, \-\-progress\fR[=\fIdelay\fR] .RS 4 -Enables a simple progress indicator shown when DVI specials are processed, since this can be a time\-consuming operation, especially when PostScript specials are involved\&. The optional non\-negative parameter -\fIskip\fR -controls the indicator length: Every time a set of -\fIskip\fR -specials has been processed, an indicator character is printed\&. Therefore, smaller values lead to a longer, more frequently updated progress indicator\&. +Enables a simple progress indicator shown when time\-consuming operations like PostScript specials are processed\&. The indicator doesn\(cqt appear before the given delay (in seconds)\&. The default delay value is 0\&.5 seconds\&. .RE .PP \fB\-r, \-\-rotate\fR=\fIangle\fR @@ -507,6 +576,22 @@ and must be given as plain floating point numbers in TeX point units (1in = 72\&.27pt)\&. .RE .PP +\fBdvisvgm:bbox\fR n[ew] \fIname\fR +.RS 4 +Defines or resets a local bounding box called +\fIname\fR\&. The name may consist of letters and digits\&. While processing a DVI page, dvisvgm continuously updates the (global) bounding box of the current page in order to determine the minimal rectangle containing all visible page components (characters, images, drawing elements etc\&.)\&. Additionally to the global bounding box, the user can request an arbitrary number of named local bounding boxes\&. Once defined, these boxes are updated together with the global bounding box starting with the first character that follows the definition\&. Thus, the local boxes can be used to compute the extent of parts of the page\&. This is useful for scenarios where the generated SVG file is post\-processed\&. In conjunction with special dvisvgm:raw, the macro +\fB{?bbox \fR\fB\fIname\fR\fR\fB}\fR +expands to the four values +\fIx\fR, +\fIy\fR, +\fIw\fR, and +\fIh\fR +(separated by spaces) specifying the coordinates of the upper left corner, width, and height of the local box +\fIname\fR\&. If box +\fIname\fR +wasn\(cqt previously defined, all four values equal zero\&. +.RE +.PP \fBdvisvgm:bbox\fR \fIwidth\fR \fIheight\fR [\fIdepth\fR] .RS 4 Updates the bounding box of the current page by embedding a virtual rectangle (\fIx\fR, @@ -568,7 +653,7 @@ introduced its own set of specials in order to embed PostScript code into DVI fi \fBdvisvgm\fR is to completely evaluate the PostScript code and to convert a large amount of it to SVG\&. Since PostScript is a rather complex language, \fBdvisvgm\fR -does not try to implement its own PostScript interpreter but uses Ghostscript instead\&. The Ghostscript shared library (libgs\&.so on Linux systems, gsdll32\&.dll on Windows) is loaded dynamically during runtime\&. For this reason, it must be installed and reachable through the PATH environment variable\&. If the Ghostscript library cannot be found, the evaluation of PostScript specials is disabled\&. Use option +does not try to implement its own PostScript interpreter but uses Ghostscript instead\&. If the Ghostscript library was not linked while building dvisvgm, it is looked up and dynamically loaded during runtime\&. In this case, dvisvgm looks for libgs\&.so on Unix\-like systems, and gsdll32\&.dll on Windows\&. You can override these default file names with the environment variable LIBGS\&. The library must be installed and reachable through the ld search path (*nix) or the PATH environment variable (Windows)\&. If it cannot be found, the evaluation of PostScript specials is disabled\&. Use option \fB\-\-list\-specials\fR to check whether PS support is available, i\&.e\&. the entry \fIps\fR @@ -632,6 +717,8 @@ Converts first page of \fIfile\&.dvi\fR to \fIfile\&.svg\fR where three transfor .sp \fBdvisvgm\fR uses the \fBkpathsea\fR library for locating the files that it opens\&. Hence, the environment variables described in the library\(cqs documentation influence the converter\&. .sp +If dvisvgm was linked without the Ghostscript library and PostScript support has not been disabled, the shared Ghostscript library is looked up during runtime\&. The environment variable LIBGS can be used to specify the file name of library\&. +.sp The pre\-compiled Windows version of \fBdvisvgm\fR requires a working installation of MiKTeX 2\&.7 or above\&. To enable evaluation of PostScript specials, the original Ghostscript DLL must be present\&. .SH "FILES" .sp @@ -733,4 +820,4 @@ http://sourceforge\&.net/projects/dvisvgm Written by Martin Gieseking <martin\&.gieseking@uos\&.de> .SH "COPYING" .sp -Copyright \(co 2005\-2009 by Martin Gieseking\&. Free use of this software is granted under the terms of the GNU General Public License (GPL) version 3 or, (at your option) any later version\&. +Copyright \(co 2005\-2010 by Martin Gieseking\&. Free use of this software is granted under the terms of the GNU General Public License (GPL) version 3 or, (at your option) any later version\&. diff --git a/Master/texmf/doc/man/man1/epsffit.1 b/Master/texmf/doc/man/man1/epsffit.1 index a74aecdad78..68da969661a 100644 --- a/Master/texmf/doc/man/man1/epsffit.1 +++ b/Master/texmf/doc/man/man1/epsffit.1 @@ -45,7 +45,7 @@ Add a \fIshowpage\fP at the end of the file to force the image to print. .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" - +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/extractres.1 b/Master/texmf/doc/man/man1/extractres.1 index 032a4191bd2..272b633794e 100644 --- a/Master/texmf/doc/man/man1/extractres.1 +++ b/Master/texmf/doc/man/man1/extractres.1 @@ -36,7 +36,7 @@ used for some programs which download fonts a bit at a time. .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" - +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/fixdlsrps.1 b/Master/texmf/doc/man/man1/fixdlsrps.1 index d392691cc83..c59bea2ad71 100644 --- a/Master/texmf/doc/man/man1/fixdlsrps.1 +++ b/Master/texmf/doc/man/man1/fixdlsrps.1 @@ -1,4 +1,4 @@ -.TH FIXDLSRPS 1 "PSUtils Release @RELEASE@ Patchlevel @PATCHLEVEL@" +.TH FIXDLSRPS 1 "PSUtils Release 1 Patchlevel 17" .SH NAME fixdlsrps \- filter to fix DviLaser/PS documents to work with PSUtils .SH SYNOPSIS @@ -18,7 +18,7 @@ package. .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" -@MAN@ +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/fixfmps.1 b/Master/texmf/doc/man/man1/fixfmps.1 index 2276cfd052e..1b7bbc060fe 100644 --- a/Master/texmf/doc/man/man1/fixfmps.1 +++ b/Master/texmf/doc/man/man1/fixfmps.1 @@ -1,4 +1,4 @@ -.TH FIXFMPS 1 "PSUtils Release @RELEASE@ Patchlevel @PATCHLEVEL@" +.TH FIXFMPS 1 "PSUtils Release 1 Patchlevel 17" .SH NAME fixfmps \- filter to fix Framemaker documents so PSUtils work .SH SYNOPSIS @@ -18,7 +18,7 @@ package. .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" -@MAN@ +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/fixpsditps.1 b/Master/texmf/doc/man/man1/fixpsditps.1 index 7ff19b34c51..87df4171ab5 100644 --- a/Master/texmf/doc/man/man1/fixpsditps.1 +++ b/Master/texmf/doc/man/man1/fixpsditps.1 @@ -1,4 +1,4 @@ -.TH FIXPSDITPS 1 "PSUtils Release @RELEASE@ Patchlevel @PATCHLEVEL@" +.TH FIXPSDITPS 1 "PSUtils Release 1 Patchlevel 17" .SH NAME fixpsditps \- filter to fix Transcript psdit documents so PSUtils work .SH SYNOPSIS @@ -18,7 +18,7 @@ package. .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" -@MAN@ +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/fixpspps.1 b/Master/texmf/doc/man/man1/fixpspps.1 index 9a6ed98c87c..7309574b43b 100644 --- a/Master/texmf/doc/man/man1/fixpspps.1 +++ b/Master/texmf/doc/man/man1/fixpspps.1 @@ -1,4 +1,4 @@ -.TH FIXPSPPS 1 "PSUtils Release @RELEASE@ Patchlevel @PATCHLEVEL@" +.TH FIXPSPPS 1 "PSUtils Release 1 Patchlevel 17" .SH NAME fixpspps \- filter to fix PSPrint PostScript so PSUtils work .SH SYNOPSIS @@ -18,7 +18,7 @@ package. .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" -@MAN@ +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/fixscribeps.1 b/Master/texmf/doc/man/man1/fixscribeps.1 index 68904461df1..18c24a56276 100644 --- a/Master/texmf/doc/man/man1/fixscribeps.1 +++ b/Master/texmf/doc/man/man1/fixscribeps.1 @@ -1,4 +1,4 @@ -.TH FIXSCRIBEPS 1 "PSUtils Release @RELEASE@ Patchlevel @PATCHLEVEL@" +.TH FIXSCRIBEPS 1 "PSUtils Release 1 Patchlevel 17" .SH NAME fixscribeps \- filter to fix Scribe documents so PSUtils work .SH SYNOPSIS @@ -18,7 +18,7 @@ package. .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" -@MAN@ +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/fixtpps.1 b/Master/texmf/doc/man/man1/fixtpps.1 index c6309f12cca..7b3991c7ad4 100644 --- a/Master/texmf/doc/man/man1/fixtpps.1 +++ b/Master/texmf/doc/man/man1/fixtpps.1 @@ -1,4 +1,4 @@ -.TH FIXTPPS 1 "PSUtils Release @RELEASE@ Patchlevel @PATCHLEVEL@" +.TH FIXTPPS 1 "PSUtils Release 1 Patchlevel 17" .SH NAME fixtpps \- filter to fix Tpscript documents to work with PSUtils .SH SYNOPSIS @@ -18,7 +18,7 @@ package. .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" -@MAN@ +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/fixwfwps.1 b/Master/texmf/doc/man/man1/fixwfwps.1 index 42810c26995..00d147bc39a 100644 --- a/Master/texmf/doc/man/man1/fixwfwps.1 +++ b/Master/texmf/doc/man/man1/fixwfwps.1 @@ -1,4 +1,4 @@ -.TH FIXWFWPS 1 "PSUtils Release @RELEASE@ Patchlevel @PATCHLEVEL@" +.TH FIXWFWPS 1 "PSUtils Release 1 Patchlevel 17" .SH NAME fixwfwps \- filter to fix Word for Windows documents so PSUtils work .SH SYNOPSIS @@ -18,7 +18,7 @@ package. .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" -@MAN@ +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/fixwpps.1 b/Master/texmf/doc/man/man1/fixwpps.1 index d6ab4a274ed..af2e2d87a14 100644 --- a/Master/texmf/doc/man/man1/fixwpps.1 +++ b/Master/texmf/doc/man/man1/fixwpps.1 @@ -1,4 +1,4 @@ -.TH FIXWPPS 1 "PSUtils Release @RELEASE@ Patchlevel @PATCHLEVEL@" +.TH FIXWPPS 1 "PSUtils Release 1 Patchlevel 17" .SH NAME fixwpps \- filter to fix WP documents so PSUtils work .SH SYNOPSIS @@ -18,7 +18,7 @@ package. .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" -@MAN@ +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/fixwwps.1 b/Master/texmf/doc/man/man1/fixwwps.1 index 1fb1aea4d9a..99165c8b4c3 100644 --- a/Master/texmf/doc/man/man1/fixwwps.1 +++ b/Master/texmf/doc/man/man1/fixwwps.1 @@ -1,4 +1,4 @@ -.TH FIXWWPS 1 "PSUtils Release @RELEASE@ Patchlevel @PATCHLEVEL@" +.TH FIXWWPS 1 "PSUtils Release 1 Patchlevel 17" .SH NAME fixwwps \- filter to fix Windows Write documents so PSUtils work .SH SYNOPSIS @@ -18,7 +18,7 @@ package. .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" -@MAN@ +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/getafm.1 b/Master/texmf/doc/man/man1/getafm.1 index 661c8c19f81..fd3e1d78e36 100644 --- a/Master/texmf/doc/man/man1/getafm.1 +++ b/Master/texmf/doc/man/man1/getafm.1 @@ -1,4 +1,4 @@ -.TH GETAFM 1 "PSUtils Release @RELEASE@ Patchlevel @PATCHLEVEL@" +.TH GETAFM 1 "PSUtils Release 1 Patchlevel 17" .SH NAME getafm \- create an AFM file for a PostScript font. .SH SYNOPSIS @@ -19,7 +19,7 @@ getafm Times-Roman | gsnd - >Times-Roman.afm .SH AUTHOR Robert Joop (rj@rainbow.in-berlin.de), Angus Duggan .SH "SEE ALSO" -@MAN@ +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/hbf2gf.1 b/Master/texmf/doc/man/man1/hbf2gf.1 index 1fdff00cee1..0ccb6648f56 100644 --- a/Master/texmf/doc/man/man1/hbf2gf.1 +++ b/Master/texmf/doc/man/man1/hbf2gf.1 @@ -1,6 +1,6 @@ .\" man page for hbf2gf .\" -.\" Copyright (C) 1994-2006 Werner Lemberg <wl@gnu.org> +.\" Copyright (C) 1994-2008 Werner Lemberg <wl@gnu.org> .\" .\" This program is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by @@ -18,7 +18,7 @@ .\" MA 02110-1301 USA .\" . -.TH HBF2GF 1 17-Oct-2006 "CJK Version 4.7.0" +.TH HBF2GF 1 29-Dec-2008 "CJK Version 4.8.2" .SH NAME hbf2gf \- convert a CJK bitmap font into subfonts usable by TeX and Omega. . @@ -27,27 +27,27 @@ hbf2gf \- convert a CJK bitmap font into subfonts usable by TeX and Omega. .na .nh .B hbf2gf -.RB [ -q ] +.RB [ \-q ] .IR \%configuration-file [ .cfg ] .br .B hbf2gf 'in +\n(.ku -.RB [ -q ] -.RB [ -p ] -.RB [ -g ] -.RB [ -n ] +.RB [ \-q ] +.RB [ \-p ] +.RB [ \-g ] +.RB [ \-n ] .I \%subfont-name \%x-resolution .RI [ \%y-scale \ | \ \%y-resolution ] .br .in .B hbf2gf -.B -t -.RB [ -q ] +.B \-t +.RB [ \-q ] .I \%subfont-name .br -.B "hbf2gf --version" +.B "hbf2gf \-\-version" | -.B --help +.B \-\-help .ad .hy . @@ -140,7 +140,7 @@ can be called in three modes: .PP .in +2m .B hbf2gf -.RB [ -q ] +.RB [ \-q ] .IR configuration-file [ .cfg ] .PP .in +5m @@ -183,7 +183,7 @@ files will be created too. . .PP .in +5m -.B -q +.B \-q makes .B hbf2gf quiet. @@ -193,10 +193,10 @@ quiet. .nh .B hbf2gf 'in +\n(.ku -.RB [ -q ] -.RB [ -p ] -.RB [ -g ] -.RB [ -n ] +.RB [ \-q ] +.RB [ \-p ] +.RB [ \-g ] +.RB [ \-n ] .I \%subfont-name \%x-resolution .RI [ \%y-scale \ | \ \%y-resolution ] .ad @@ -222,24 +222,24 @@ stripped to get the name for the configuration file (which must end with .C \&.cfg \(cq). No job file will be created. If option -.B -p +.B \-p is set, no .C PL file is created. If -.B -g +.B \-g is set, no .C GF file is created. The extension can be controlled with -.BR -n ; +.BR \-n ; if set, the extension is \(oq\c .C \&.gf \(cq, otherwise \(oq\c .C \&. <\c .IR resolution >\c .C gf \(cq. -.B -q +.B \-q makes .B hbf2gf quiet. @@ -250,8 +250,8 @@ quiet. .nh .B hbf2gf 'in +\n(.ku -.B -t -.RB [ -q ] +.B \-t +.RB [ \-q ] .I \%subfont-name .ad .hy @@ -264,7 +264,7 @@ it tests whether the specified subfont name leads to an configuration file. It returns 0 on success and prints out the name of that configuration file (provided the -.B -q +.B \-q switch isn't set). This test isn't a thorough one; it only removes the last two characters and checks whether a configuration file with that name exists. @@ -272,13 +272,13 @@ and checks whether a configuration file with that name exists. See the next section for more details about configuration files. .PP Specifying the option -.B --version +.B \-\-version returns the current version of .B hbf2gf and the used file search library (e.g.\ \c .BR kpathsea ). Usage information is shown with the -.B --help +.B \-\-help parameter. . . @@ -309,9 +309,9 @@ files: design_size 14.4 - y_offset -13 + y_offset \-13 - nmb_files -1 + nmb_files \-1 output_name gsfs14 @@ -439,7 +439,7 @@ A comment describing the font; default is none. .TP .B nmb_fonts The number of subfonts to create. -Default value is -1 for creating all fonts. +Default value is \-1 for creating all fonts. .TP .B unicode If \(oqyes\(cq, a two digit hexadecimal number will be used as a running number, @@ -562,7 +562,7 @@ fonts, thus we use the paths for PostScript related stuff if necessary for fonts resp. configuration files. The actual version of kpathsea is displayed on screen if you call .B hbf2gf -.BR --version . +.BR \-\-version . .PP Here is a table of the file type and the corresponding .B kpathsea @@ -630,22 +630,22 @@ hard-coded into the library. .PP .in +2m -.C "kpsewhich -progname=hbf2gf -expand-var='$MISCFONTS'" +.C "kpsewhich \-progname=hbf2gf \-expand\-var='$MISCFONTS'" .PP We select the program name also since it is possible to specify -variables which are searched only for a certain program -- in our +variables which are searched only for a certain program \(en in our example it would be .C MISCFONTS.hbf2gf . .PP A similar but not identical method is to say .PP .in +2m -.C "kpsewhich -progname=hbf2gf -show-path='misc fonts'" +.C "kpsewhich \-progname=hbf2gf \-show\-path='misc fonts'" .PP [A full list of format types can be obtained by saying \(oq\c -.C "kpsewhich --help" \(cq +.C "kpsewhich \-\-help" \(cq on the command line prompt.] -This is exactly the how +This is exactly how .B hbf2gf searches for files; the disadvantage is that all variables are expanded which can cause very long strings. @@ -703,7 +703,7 @@ which can be converted into a pretty-printed \*(TX document using .BR cweave . The CJK package also contains a preformatted -.C hbf2gf.dvi +.C hbf2gf.pdf file. .PP the @@ -715,7 +715,7 @@ the .B Hanzi Bitmap File .RB ( HBF ) standard version\ 1.3; available at -.C ftp.ifcss.org +.C \%ftp.ifcss.org . .PP the Omega documentation available at .C ftp.ens.fr @@ -727,7 +727,7 @@ and the CTAN hosts and mirrors. .C *.cfg The .B hbf2gf -configuration scripts +configuration scripts. .TP .C *.hbf HBF header files which describe fixed-width bitmap fonts. diff --git a/Master/texmf/doc/man/man1/includeres.1 b/Master/texmf/doc/man/man1/includeres.1 index 24a2615c396..e157716df36 100644 --- a/Master/texmf/doc/man/man1/includeres.1 +++ b/Master/texmf/doc/man/man1/includeres.1 @@ -1,4 +1,4 @@ -.TH INCLUDERES 1 "PSUtils Release @RELEASE@ Patchlevel @PATCHLEVEL@" +.TH INCLUDERES 1 "PSUtils Release 1 Patchlevel 17" .SH NAME includeres \- filter to include resources in a PostScript document .SH SYNOPSIS @@ -26,11 +26,10 @@ re-arrangement filters such as or .I pstops safely. -.SH FILES .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" -@MAN@ +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/kpseaccess.1 b/Master/texmf/doc/man/man1/kpseaccess.1 index 703be613f5a..c21f569288a 100644 --- a/Master/texmf/doc/man/man1/kpseaccess.1 +++ b/Master/texmf/doc/man/man1/kpseaccess.1 @@ -1,4 +1,4 @@ -.TH KPSEACCESS 1 "16 May 2010" "Kpathsea 6.0.0" +.TH KPSEACCESS 1 "16 May 2010" "Kpathsea 6.0.1dev" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/kpsereadlink.1 b/Master/texmf/doc/man/man1/kpsereadlink.1 index 36f16815be2..475ea7ca05f 100644 --- a/Master/texmf/doc/man/man1/kpsereadlink.1 +++ b/Master/texmf/doc/man/man1/kpsereadlink.1 @@ -1,4 +1,4 @@ -.TH KPSEREADLINK 1 "4 January 1998" "Kpathsea 6.0.0" +.TH KPSEREADLINK 1 "4 January 1998" "Kpathsea 6.0.1dev" .\"===================================================================== .SH NAME kpsereadlink \- print contents of symbolic link diff --git a/Master/texmf/doc/man/man1/kpsestat.1 b/Master/texmf/doc/man/man1/kpsestat.1 index 13971b2c508..8b1464c98bf 100644 --- a/Master/texmf/doc/man/man1/kpsestat.1 +++ b/Master/texmf/doc/man/man1/kpsestat.1 @@ -1,4 +1,4 @@ -.TH KPSESTAT 1 "7 April 2010" "Kpathsea 6.0.0" +.TH KPSESTAT 1 "7 April 2010" "Kpathsea 6.0.1dev" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/kpsewhich.1 b/Master/texmf/doc/man/man1/kpsewhich.1 index 65b7f3a5d9f..40418985364 100644 --- a/Master/texmf/doc/man/man1/kpsewhich.1 +++ b/Master/texmf/doc/man/man1/kpsewhich.1 @@ -1,4 +1,4 @@ -.TH KPSEWHICH 1 "7 January 2007" "Kpathsea 6.0.0" +.TH KPSEWHICH 1 "7 January 2007" "Kpathsea 6.0.1dev" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/lacheck.1 b/Master/texmf/doc/man/man1/lacheck.1 index f8c706a0e3b..11064b28e54 100644 --- a/Master/texmf/doc/man/man1/lacheck.1 +++ b/Master/texmf/doc/man/man1/lacheck.1 @@ -1,12 +1,9 @@ -.TH "LaCheck" "1" "2010-06-07" "Release 1.26" +.TH "LaCheck" "1" "2010-12-10" "Release 1.26" .SH NAME lacheck - A consistency checker for LaTeX documents. .SH SYNOPSIS .B lacheck -.I filename -[ -.I .tex -] +.IR filename [ \fB.tex\fP ] .SH DESCRIPTION LaCheck is a general purpose consistency checker for LaTeX documents. It reads a LaTeX document and displays warning messages, if it finds diff --git a/Master/texmf/doc/man/man1/makeindex.1 b/Master/texmf/doc/man/man1/makeindex.1 index 9476aebc58d..98316a65833 100644 --- a/Master/texmf/doc/man/man1/makeindex.1 +++ b/Master/texmf/doc/man/man1/makeindex.1 @@ -6,29 +6,29 @@ .if t .ds Uc \fIU\\h'-0.12m'C\\v'0.27m'\\h'-.23m'S\\h'-0.11m'F\\v'-0.27m'\fP .if n .ds Uc UCSF .ds Et \\f(boE\\h'-0.1667m'\\v'-0.20v'T\\v'0.20v'\\h'-0.125m'T\\fP -.TH MAKEINDEX 1L "10 December 1991" +.TH MAKEINDEX 1 "6 July 2010" "TeX Live" "TeX Live" .\"===================================================================== .SH NAME makeindex \- a general purpose, formatter-independent index processor .SH SYNOPSIS .B makeindex -.BR [ \-c ] -.BR [ \-g ] -.BR [ \-i ] -.BR [ \-l ] -.BR [ \-o +.RB [ \-c ] +.RB [ \-g ] +.RB [ \-i ] +.RB [ \-l ] +.RB [ \-o .IR ind ] -.BR [ \-p +.RB [ \-p .IR num ] -.BR [ \-q ] -.BR [ \-r ] -.BR [ \-s +.RB [ \-q ] +.RB [ \-r ] +.RB [ \-s .IR sfile ] -.BR [ \-t +.RB [ \-t .IR log ] -.BR [ \-L ] -.BR [ \-T ] -.BI [ idx0 +.RB [ \-L ] +.RB [ \-T ] +.RI [ idx0 .I idx1 .IR idx2 .\|.\|.] .\"===================================================================== @@ -183,14 +183,14 @@ using explicit range operators; see \s-2SPECIAL EFFECTS\s+2 below. By default, three or more successive pages are automatically abbreviated as a range (e.g. 1\(em5). .TP 10 -.BR \-s " sty" +.BI \-s " sty" Employ .I sty as the style file (no default). The environment variable \s-2INDEXSTYLE\s+2 defines the path where the style file should be found. .TP 10 -.BR \-t " log" +.BI \-t " log" Employ .I log as the transcript file. By default, the file name is diff --git a/Master/texmf/doc/man/man1/mktexlsr.1 b/Master/texmf/doc/man/man1/mktexlsr.1 index b6be6873351..a2697cf31bf 100644 --- a/Master/texmf/doc/man/man1/mktexlsr.1 +++ b/Master/texmf/doc/man/man1/mktexlsr.1 @@ -1,4 +1,4 @@ -.TH MKTEXLSR 1 "4 January 1998" "Kpathsea 6.0.0" +.TH MKTEXLSR 1 "4 January 1998" "Kpathsea 6.0.1dev" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/mktexmf.1 b/Master/texmf/doc/man/man1/mktexmf.1 index 063e679da62..bfc95b5234e 100644 --- a/Master/texmf/doc/man/man1/mktexmf.1 +++ b/Master/texmf/doc/man/man1/mktexmf.1 @@ -1,4 +1,4 @@ -.TH MKTEXMF 1 "4 January 1998" "Kpathsea 6.0.0" +.TH MKTEXMF 1 "4 January 1998" "Kpathsea 6.0.1dev" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/mktexpk.1 b/Master/texmf/doc/man/man1/mktexpk.1 index f081a373742..69a7d362ce1 100644 --- a/Master/texmf/doc/man/man1/mktexpk.1 +++ b/Master/texmf/doc/man/man1/mktexpk.1 @@ -1,4 +1,4 @@ -.TH MKTEXPK 1 "7 April 2010" "Kpathsea 6.0.0" +.TH MKTEXPK 1 "7 April 2010" "Kpathsea 6.0.1dev" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/mktextfm.1 b/Master/texmf/doc/man/man1/mktextfm.1 index 0ce843e7928..7a7d66804f5 100644 --- a/Master/texmf/doc/man/man1/mktextfm.1 +++ b/Master/texmf/doc/man/man1/mktextfm.1 @@ -1,4 +1,4 @@ -.TH MKTEXTFM 1 "7 April 2010" "Kpathsea 6.0.0" +.TH MKTEXTFM 1 "7 April 2010" "Kpathsea 6.0.1dev" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf/doc/man/man1/musixflx.1 b/Master/texmf/doc/man/man1/musixflx.1 new file mode 100644 index 00000000000..b94345f73c9 --- /dev/null +++ b/Master/texmf/doc/man/man1/musixflx.1 @@ -0,0 +1,40 @@ +.\" This manpage is licensed under the GNU Public License +.TH MUSIXFLX 1 2010-10-19 "musixflx-0.83.2" "" + +.SH NAME +musixflx \- process mx1 files (the second pass of 3-pass MusiXTeX typesetting) + +.SH SYNOPSIS +.B musixflx +.IR jobname [ .mx1 " | " .tex ] +[ +.I debugmode +] + +where +.I debugmode +can be +.br + d for debug information to the screen +.br + m for line numbers to the screen +.br + f for debug information to a log file jobname.mxl (not .mx1) +.br + s to get the computed lines immediately on the screen + +To allow for ease of use with a batch file, \fB musixflx\fR +can be fed with either \fI jobname.mx1\fP, \fI jobname.tex\fP, +or just \fI jobname\fP, any of which open \fI jobname.mx1\fP. + +.SH SEE ALSO +.BR musixtex (1) +.br +musixdoc.pdf + +.SH AUTHOR +This manual page was written by Andreas Tille +<tille@debian.org> for the Debian GNU/Linux system (but may be used +by others). Corrections to the synopsis were pointed out by Peter +Breitenlohner <peb@mppmu.mpg.de> and implemented by Bob Tennent +<rdt@cs.queensu.ca>. diff --git a/Master/texmf/doc/man/man1/ps2eps.1 b/Master/texmf/doc/man/man1/ps2eps.1 index 4c0c674ada8..d74e88ca34f 100644 --- a/Master/texmf/doc/man/man1/ps2eps.1 +++ b/Master/texmf/doc/man/man1/ps2eps.1 @@ -3,17 +3,17 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "PS2EPS" "1" "24 Januar 2007" "" "" +.TH "PS2EPS" "1" "31 August 2010" "" "" .SH NAME ps2eps \- convert PostScript to EPS (Encapsulated PostScript) files .SH SYNOPSIS -\fBps2eps\fR [ \fB-f\fR ] [ \fB-q\fR ] [ \fB-N\fR ] [ \fB-O\fR ] [ \fB-n\fR ] [ \fB-P\fR ] [ \fB-c\fR ] [ \fB-C\fR ] [ \fB-m\fR ] [ \fB-B\fR ] [ \fB-E\fR ] [ \fB-s \fIpagedim\fB\fR ] [ \fB-t \fIoffset\fB\fR ] [ \fB-r \fIresolution\fB\fR ] [ \fB-R \fI+|-|^\fB\fR ] [ \fB-l\fR ] [ \fB-g\fR ] [ \fB-H\fR ] [ \fB-d\fR ] [ \fB-h|--help\fR ] [ \fB-W\fR ] [ \fB-L\fR ] [ \fB-V|--version\fR ] [ \fB--\fR ] [ \fB\fIpsfile1\fB\fR ] [ \fB\fIpsfile2\fB\fR ] [ \fB\fI\&...\fB\fR ] +\fBps2eps\fR [ \fB-f\fR ] [ \fB-q\fR ] [ \fB-N\fR ] [ \fB-O\fR ] [ \fB-n\fR ] [ \fB-P\fR ] [ \fB-c\fR ] [ \fB-C\fR ] [ \fB-m\fR ] [ \fB-B\fR ] [ \fB-E\fR ] [ \fB-s \fIpagedim\fB\fR ] [ \fB-t \fIoffset\fB\fR ] [ \fB-r \fIresolution\fB\fR ] [ \fB-R \fI+|-|^\fB\fR ] [ \fB-l\fR ] [ \fB-g\fR ] [ \fB-H\fR ] [ \fB-d\fR ] [ \fB-h|--help\fR ] [ \fB-a\fR ] [ \fB-W\fR ] [ \fB-L\fR ] [ \fB-V|--version\fR ] [ \fB--\fR ] [ \fB\fIpsfile1\fB\fR ] [ \fB\fIpsfile2\fB\fR ] [ \fB\fI\&...\fB\fR ] .SH "DESCRIPTION" .PP -This manual page documents \fBps2eps\fR version 1.64. +This manual page documents \fBps2eps\fR version 1.68. .PP \fBps2eps\fR is a tool (written in Perl) to produce Encapsulated PostScript Files (EPS/EPSF) from usual one-paged Postscript @@ -140,6 +140,9 @@ See also environment variable PS2EPS_GSBBOX\&. \fB-H, --nohires \fR do not generate a %%HiResBoundingBox comment for output. .TP +\fB-a, --accuracy \fR +increase the accuracy by turning subsample antialiasing on (may be slower) +.TP \fB-L, --license \fR show licensing information. .TP @@ -284,6 +287,10 @@ for using a monochrome image. But this will probably result in wrongly determined bounding boxes with colored images, because ghostscript has to do black/white dithering and may thus suppress objects drawn in light colors. +.PP +Another option in case of memory problems and too long run times +is to use the much more memory efficient internal ghostscript bbox by using the +\fB-g\fR option. .SH "ENVIRONMENT VARIABLES" .PP Please note that a command line option always takes precedence over @@ -331,7 +338,9 @@ an additional point of white space around the tight bounding box. .PP Some people contributed code or suggestions to improve \fBps2eps\fR\&. Here are at least some names (sorry if I forgot your name): -Christophe Druet, Hans Ecke, Berend Hasselman, Erik Joergensen, Koji Nakamaru, Hans Fredrik Nordhaug +Christophe Druet, Hans Ecke, Berend Hasselman, Erik Joergensen, Koji Nakamaru, Hans Fredrik Nordhaug, Michael Sharpe. +Special thanks goes to Michael Sharpe from UCSD who suggested a lot of useful features for ps2eps and +who fixed bbox to become more precise and robust. .PP An earlier version of this manual page was originally written by Rafael Laboissiere <rafael at debian.org> for diff --git a/Master/texmf/doc/man/man1/psbook.1 b/Master/texmf/doc/man/man1/psbook.1 index 584764c6056..de88949e4b6 100644 --- a/Master/texmf/doc/man/man1/psbook.1 +++ b/Master/texmf/doc/man/man1/psbook.1 @@ -33,7 +33,7 @@ option suppresses this. .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" - +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/psmerge.1 b/Master/texmf/doc/man/man1/psmerge.1 index 4bce92da61b..55d95ff7d61 100644 --- a/Master/texmf/doc/man/man1/psmerge.1 +++ b/Master/texmf/doc/man/man1/psmerge.1 @@ -1,4 +1,4 @@ -.TH PSMERGE 1 "PSUtils Release @RELEASE@ Patchlevel @PATCHLEVEL@" +.TH PSMERGE 1 "PSUtils Release 1 Patchlevel 17" .SH NAME psmerge \- filter to merge several PostScript files into one .SH SYNOPSIS @@ -27,7 +27,7 @@ were in separate files. .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" -@MAN@ +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/psnup.1 b/Master/texmf/doc/man/man1/psnup.1 index 28784f5169e..06922e43575 100644 --- a/Master/texmf/doc/man/man1/psnup.1 +++ b/Master/texmf/doc/man/man1/psnup.1 @@ -151,7 +151,7 @@ on the second output page. .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" - +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/psresize.1 b/Master/texmf/doc/man/man1/psresize.1 index a5b8252c569..2fa06f9f6d0 100644 --- a/Master/texmf/doc/man/man1/psresize.1 +++ b/Master/texmf/doc/man/man1/psresize.1 @@ -72,7 +72,7 @@ psresize -PA4 -pletter in.ps out.ps .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" - +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/psselect.1 b/Master/texmf/doc/man/man1/psselect.1 index 8b06083aa72..005888306b5 100644 --- a/Master/texmf/doc/man/man1/psselect.1 +++ b/Master/texmf/doc/man/man1/psselect.1 @@ -75,7 +75,7 @@ at one. The actual page number in the document may be different. .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" - +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/pstops.1 b/Master/texmf/doc/man/man1/pstops.1 index d2055dac90d..cc4d160c890 100644 --- a/Master/texmf/doc/man/man1/pstops.1 +++ b/Master/texmf/doc/man/man1/pstops.1 @@ -157,7 +157,7 @@ for the reverse sides (or join them with a comma for duplex printing). .SH AUTHOR Copyright (C) Angus J. C. Duggan 1991-1995 .SH "SEE ALSO" - +epsffit(1), psbook(1), psnup(1), psresize(1), psselect(1), pstops(1), extractres(1), fixdlsrps(1), fixfmps(1), fixpsditps(1), fixpspps(1), fixscribeps(1), fixtpps(1), fixwfwps(1), fixwpps(1), fixwwps(1), includeres(1), psmerge(1), getafm(1) .SH TRADEMARKS .B PostScript is a trademark of Adobe Systems Incorporated. diff --git a/Master/texmf/doc/man/man1/tcdialog.1 b/Master/texmf/doc/man/man1/tcdialog.1 index 5168fb3dd62..a35fbc90696 100644 --- a/Master/texmf/doc/man/man1/tcdialog.1 +++ b/Master/texmf/doc/man/man1/tcdialog.1 @@ -1,6 +1,6 @@ '\" t -.\" $Id: dialog.1,v 1.120 2010/01/18 10:19:07 tom Exp $ -.\" Copyright 2005-2008,2010 Thomas E. Dickey +.\" $Id: dialog.1,v 1.125 2011/01/18 00:40:47 tom Exp $ +.\" Copyright 2005-2010,2011 Thomas E. Dickey .\" .\" This program is free software; you can redistribute it and/or modify .\" it under the terms of the GNU Lesser General Public License, version 2.1 @@ -16,6 +16,13 @@ .\" Free Software Foundation, Inc. .\" 51 Franklin St., Fifth Floor .\" Boston, MA 02110, USA. +.\" +.\" definitions for renaming +.ds p dialog +.ds l dialog +.ds L Dialog +.ds D DIALOG +.\" .de ES .ne 8 .IP @@ -29,25 +36,25 @@ .RE .. . -.TH DIALOG 1 "" "$Date: 2010/01/18 10:19:07 $" +.TH \*D 1 "" "$Date: 2011/01/18 00:40:47 $" .SH NAME -dialog \- display dialog boxes from shell scripts +\*p \- display dialog boxes from shell scripts .SH SYNOPSIS -\fBdialog --clear\fP +\fB\*p --clear\fP .br -.BI "dialog --create-rc " file +.BI "\*p --create-rc " file .br -\fBdialog --print-maxsize\fP +\fB\*p --print-maxsize\fP .br -\fBdialog\fP +\fB\*p\fP \fIcommon-options\fP \fIbox-options\fP .SH DESCRIPTION -\fBDialog\fP +\fB\*L\fP is a program that will let you to present a variety of questions or display messages using dialog boxes from a shell script. These types of dialog boxes are implemented -(though not all are necessarily compiled into \fBdialog\fR): +(though not all are necessarily compiled into \fB\*p\fR): .RS .LP .nh @@ -83,19 +90,19 @@ These types of dialog boxes are implemented You can put more than one dialog box into a script: .TP 5 - -Use the "\fB--and-widget\fP" token to force Dialog to proceed to the next +Use the "\fB--and-widget\fP" token to force \fB\*p\fP to proceed to the next dialog unless you have pressed ESC to cancel, or .TP 5 - Simply add the tokens for the next dialog box, making a chain. -Dialog stops chaining when the return code from a dialog is nonzero, +\*L stops chaining when the return code from a dialog is nonzero, e.g., Cancel or No (see DIAGNOSTICS). .PP -Some widgets, e.g., checklist, will write text to \fBdialog\fP's output. +Some widgets, e.g., checklist, will write text to \fB\*p\fP's output. Normally that is the standard error, but there are options for changing this: "\fB--output-fd\fP", "\fB--stderr\fP" and "\fB--stdout\fP". No text is written if the Cancel button (or ESC) is pressed; -\fBdialog\fP exits immediately in that case. +\fB\*p\fP exits immediately in that case. . .\" ************************************************************************ .SH OPTIONS @@ -106,26 +113,26 @@ for the benefit of those using systems with deranged locale support). A "\fB--\fP" by itself is used as an escape, i.e., the next token on the command-line is not treated as an option. .RS -.B dialog --title -- --Not an option +.B \*p --title -- --Not an option .RE .PP -The "\fB--args\fP" option tells \fBdialog\fP to list the command-line +The "\fB--args\fP" option tells \fB\*p\fP to list the command-line parameters to the standard error. This is useful when debugging complex scripts using the "\fB--\fP" and "\fB--file\fP", since the command-line may be rewritten as these are expanded. .PP -The "\fB--file\fP" option tells \fBdialog\fP to read parameters from +The "\fB--file\fP" option tells \fB\*p\fP to read parameters from the file named as its value. .RS -.B dialog --file \fIparameterfile +.B \*p --file \fIparameterfile .RE Blanks not within double-quotes are discarded (use backslashes to quote single characters). The result is inserted into the command-line, replacing "\fB--file\fP" and its option value. Interpretation of the command-line resumes from that point. -If \fIparameterfile\fP begins with "&", \fBdialog\fP +If \fIparameterfile\fP begins with "&", \fB\*p\fP interprets the following text as a file descriptor number rather than a filename. . @@ -164,7 +171,8 @@ To compare the effects, use these: .ES All three widgets visible, staircase effect, ordered 1,2,3: .EX -dialog --begin 2 2 --yesno "" 0 0 \\ +\*p \ + --begin 2 2 --yesno "" 0 0 \\ --and-widget --begin 4 4 --yesno "" 0 0 \\ --and-widget --begin 6 6 --yesno "" 0 0 .EE @@ -172,7 +180,8 @@ dialog --begin 2 2 --yesno "" 0 0 \\ .ES Only the last widget is left visible: .EX -dialog --clear --begin 2 2 --yesno "" 0 0 \\ +\*p \ + --clear --begin 2 2 --yesno "" 0 0 \\ --and-widget --clear --begin 4 4 --yesno "" 0 0 \\ --and-widget --begin 6 6 --yesno "" 0 0 .EE @@ -180,7 +189,8 @@ dialog --clear --begin 2 2 --yesno "" 0 0 \\ .ES All three widgets visible, staircase effect, ordered 3,2,1: .EX -dialog --keep-window --begin 2 2 --yesno "" 0 0 \\ +\*p \ + --keep-window --begin 2 2 --yesno "" 0 0 \\ --and-widget --keep-window --begin 4 4 --yesno "" 0 0 \\ --and-widget --begin 6 6 --yesno "" 0 0 .EE @@ -188,7 +198,8 @@ dialog --keep-window --begin 2 2 --yesno "" 0 0 \\ .ES First and third widget visible, staircase effect, ordered 3,1: .EX -dialog --keep-window --begin 2 2 --yesno "" 0 0 \\ +\*p \ + --keep-window --begin 2 2 --yesno "" 0 0 \\ --and-widget --clear --begin 4 4 --yesno "" 0 0 \\ --and-widget --begin 6 6 --yesno "" 0 0 .EE @@ -200,7 +211,7 @@ command. .IP "\fB--colors" Interpret embedded "\\Z" sequences in the dialog text by the following character, -which tells \fBdialog\fP to set colors or video attributes: +which tells \fB\*p\fP to set colors or video attributes: 0 through 7 are the ANSI used in curses: black, red, @@ -218,14 +229,14 @@ bold (perhaps bright) red. Restore normal settings with "\\Zn". . .IP "\fB--column-separator \fIstring" -Tell \fBdialog\fP to split data for radio/checkboxes and menus on the +Tell \fB\*p\fP to split data for radio/checkboxes and menus on the occurrences of the given string, and to align the split data into columns. . .IP "\fB--cr-wrap" Interpret embedded newlines in the dialog text as a newline on the screen. -Otherwise, \fBdialog\fR will only wrap lines where needed to fit inside the text box. +Otherwise, \fB\*p\fR will only wrap lines where needed to fit inside the text box. Even though you can control line breaks with this, -\fBdialog\fR will still wrap any lines that are too long for the width of the box. +\fB\*L\fR will still wrap any lines that are too long for the width of the box. Without cr-wrap, the layout of your text may be formatted to look nice in the source code of your script without affecting the way it will look in the dialog. @@ -234,7 +245,7 @@ See also the "\fB--no-collapse\fP" and "\fB--trim\fP" options. . .IP "\fB--create-rc \fIfile" When -\fBdialog\fP +\fB\*p\fP supports run-time configuration, this can be used to dump a sample configuration file to the file specified by @@ -272,7 +283,7 @@ Override the label used for "Extra" buttons. Note: for inputmenu widgets, this defaults to "Rename". . .IP "\fB--help" -Prints the help message to \fBdialog\fP's output. +Prints the help message to \fB\*p\fP's output. The help message is printed if no options are given. . .IP "\fB--help-button" @@ -280,7 +291,7 @@ Show a help-button after "OK" and "Cancel" buttons, i.e., in checklist, radiolist and menu boxes. If "\fB--item-help\fR" is also given, on exit the return status will be the same as for the "OK" button, -and the item-help text will be written to \fBdialog\fP's output after the token "HELP". +and the item-help text will be written to \fB\*p\fP's output after the token "HELP". Otherwise, the return status will indicate that the Help button was pressed, and no message printed. . @@ -295,16 +306,16 @@ This can be used to reconstruct the state of a checklist after processing the help request. . .IP "\fB--ignore" -Ignore options that \fBdialog\fP does not recognize. +Ignore options that \fB\*p\fP does not recognize. Some well-known ones such as "\fB--icon\fP" are ignored anyway, but this is a better choice for compatibility with other implementations. . .IP "\fB--input-fd \fIfd" Read keyboard input from the given file descriptor. -Most \fBdialog\fR scripts read from the standard input, +Most \fB\*p\fR scripts read from the standard input, but the gauge widget reads a pipe (which is always standard input). Some configurations do not work properly when -\fBdialog\fP tries to reopen the terminal. +\fB\*p\fP tries to reopen the terminal. Use this option (with appropriate juggling of file-descriptors) if your script must work in that type of environment. . @@ -318,21 +329,21 @@ adding a column which is displayed in the bottom line of the screen, for the currently selected item. . .IP "\fB--keep-tite" -Normally \fBdialog\fP checks to see if it is running in an \fBxterm\fP, +Normally \fB\*p\fP checks to see if it is running in an \fBxterm\fP, and in that case tries to suppress the initialization strings that would make it switch to the alternate screen. Switching between the normal and alternate screens -is visually distracting in a script which runs \fBdialog\fP +is visually distracting in a script which runs \fB\*p\fP several times. -Use this option to allow \fBdialog\fP to use those initialization strings. +Use this option to allow \fB\*p\fP to use those initialization strings. . .IP "\fB--keep-window" -Normally when \fBdialog\fR performs several \fBtailboxbg\fR widgets +Normally when \fB\*p\fR performs several \fBtailboxbg\fR widgets connected by "\fB--and-widget\fR", it clears the old widget from the screen by painting over it. Use this option to suppress that repainting. .IP -At exit, \fBdialog\fR repaints all of the widgets which have been +At exit, \fB\*p\fR repaints all of the widgets which have been marked with "\fB--keep-window\fR", even if they are not \fBtailboxbg\fR widgets. That causes them to be repainted in reverse order. See the discussion of the "\fB--clear\fR" option for examples. @@ -347,19 +358,19 @@ Suppress the "Cancel" button in checklist, inputbox and menu box modes. A script can still test if the user pressed the ESC key to cancel to quit. . .IP "\fB--no-collapse" -Normally \fBdialog\fR converts tabs to spaces and reduces multiple +Normally \fB\*p\fR converts tabs to spaces and reduces multiple spaces to a single space for text which is displayed in a message boxes, etc. Use this option to disable that feature. -Note that \fBdialog\fR will still wrap text, +Note that \fB\*p\fR will still wrap text, subject to the "\fB--cr-wrap\fR" and "\fB--trim\fR" options. . .IP "\fB--no-kill" Tells -\fBdialog\fP +\fB\*p\fP to put the \fBtailboxbg\fP box in the background, -printing its process id to \fBdialog\fP's output. +printing its process id to \fB\*p\fP's output. SIGHUP is disabled for the background process. . .IP "\fB--no-label \fIstring" @@ -369,6 +380,9 @@ Override the label used for "No" buttons. Rather than draw lines around boxes, draw spaces in the same place. See also "\fB--ascii-lines\fR". . +.IP "\fB--no-mouse +Do not enable the mouse. +. .IP "\fB--no-ok" .IP "\fB--nook" Suppress the "OK" button in checklist, inputbox and menu box modes. @@ -383,26 +397,26 @@ Override the label used for "OK" buttons. . .IP "\fB--output-fd \fIfd" Direct output to the given file descriptor. -Most \fBdialog\fR scripts write to the standard error, +Most \fB\*p\fR scripts write to the standard error, but error messages may also be written there, depending on your script. . .IP "\fB--separator \fIstring" .IP "\fB--output-separator\fIstring" -Specify a string that will separate the output on \fBdialog\fP's output from +Specify a string that will separate the output on \fB\*p\fP's output from checklists, rather than a newline (for --separate-output) or a space. This applies to other widgets such as forms and editboxes which normally use a newline. . .IP "\fB--print-maxsize" Print the maximum size of dialog boxes, i.e., the screen size, -to \fBdialog\fP's output. +to \fB\*p\fP's output. This may be used alone, without other options. . .IP "\fB--print-size" -Prints the size of each dialog box to \fBdialog\fP's output. +Prints the size of each dialog box to \fB\*p\fP's output. . .IP "\fB--print-version" -Prints \fBdialog\fR's version to \fBdialog\fP's output. +Prints \fB\*p\fR's version to \fB\*p\fP's output. This may be used alone, without other options. . .IP "\fB--scrollbar \fIstring" @@ -415,7 +429,7 @@ For checklist widgets, output result one line at a time, with no quoting. This facilitates parsing by another program. . .IP "\fB--separate-widget \fIstring" -Specify a string that will separate the output on \fBdialog\fP's output from +Specify a string that will separate the output on \fB\*p\fP's output from each widget. This is used to simplify parsing the result of a dialog with several widgets. If this option is not given, @@ -427,7 +441,7 @@ Draw a shadow to the right and bottom of each dialog box. .IP "\fB--single-quoted" Use single-quoting as needed (and no quotes if unneeded) for the output of checklist's as well as the item-help text. -If this option is not set, \fBdialog\fP uses double quotes around each item. +If this option is not set, \fB\*p\fP uses double quotes around each item. That requires occasional use of backslashes to make the output useful in shell scripts. . @@ -449,7 +463,7 @@ Direct output to the standard output. This option is provided for compatibility with Xdialog, however using it in portable scripts is not recommended, since curses normally writes its screen updates to the standard output. -If you use this option, \fBdialog\fR attempts to reopen the terminal +If you use this option, \fB\*p\fR attempts to reopen the terminal so it can write to the display. Depending on the platform and your environment, that may fail. . @@ -482,7 +496,9 @@ Specifies a string to be displayed at the top of the dialog box. . .IP "\fB--trace \fIfilename" -logs keystrokes to the given file. +logs the command-line parameters and +keystrokes to the given file. +If \fBdialog\fP reads a configure file, it is logged as well. Use control/T to log a picture of the current dialog window. . .IP "\fB--trim" @@ -556,7 +572,7 @@ The initial on/off state of each entry is specified by .IP On exit, a list of the \fItag\fP strings of those entries that are turned on -will be printed on \fBdialog\fP's output. +will be printed on \fB\*p\fP's output. If the "\fB--separate-output\fP" option is not given, the strings will be quoted to make it simple for scripts to separate them. See the "\fB--single-quoted\fP" option, which modifies the quoting behavior. @@ -585,7 +601,7 @@ window to the closest match. Use a carriage return or the "OK" button to accept the current value in the text-entry window and exit. .IP -On exit, the contents of the text-entry window are written to \fBdialog\fP's output. +On exit, the contents of the text-entry window are written to \fB\*p\fP's output. . .IP "\fB--editbox \fIfilepath height width\fR" The edit-box dialog displays a copy of the file. @@ -597,7 +613,7 @@ Unlike the \fB--inputbox\fP, you must tab to the "OK" or "Cancel" buttons to close the dialog. Pressing the "Enter" key within the box will split the corresponding line. .IP -On exit, the contents of the edit window are written to \fBdialog\fP's output. +On exit, the contents of the edit window are written to \fB\*p\fP's output. . .nf .IP "\fB--form \fItext height width formheight \fR[ \fIlabel y x item y x flen ilen \fR] \fI..." @@ -626,7 +642,7 @@ If \fIilen\fR is zero, it is set to \fIflen\fR. Use up/down arrows (or control/N, control/P) to move between fields. Use tab to move between windows. .IP -On exit, the contents of the form-fields are written to \fBdialog\fP's output, +On exit, the contents of the form-fields are written to \fB\*p\fP's output, each field separated by a newline. The text used to fill non-editable fields (\fIflen\fR is zero or negative) @@ -654,14 +670,14 @@ Typing any printable characters switches focus to the text-entry window, entering that character as well as scrolling the directory and filename windows to the closest match. .IP -Typing the space character forces \fBdialog\fP to complete the current +Typing the space character forces \fB\*p\fP to complete the current name (up to the point where there may be a match against more than one entry). .IP Use a carriage return or the "OK" button to accept the current value in the text-entry window and exit. .IP -On exit, the contents of the text-entry window are written to \fBdialog\fP's output. +On exit, the contents of the text-entry window are written to \fB\*p\fP's output. . . .IP "\fB--gauge \fItext height width [percent]\fR" @@ -681,22 +697,22 @@ The gauge exits when EOF is reached on the standard input. The \fIpercent\fR value denotes the initial percentage shown in the meter. If not specified, it is zero. .IP -On exit, no text is written to \fBdialog\fP's output. +On exit, no text is written to \fB\*p\fP's output. The widget accepts no input, so the exit status is always OK. . . .IP "\fB--infobox \fItext height width" An \fBinfo\fP box is basically a \fBmessage\fP box. -However, in this case, \fBdialog\fP +However, in this case, \fB\*p\fP will exit immediately after displaying the message to the user. -The screen is not cleared when \fBdialog\fP +The screen is not cleared when \fB\*p\fP exits, so that the message will remain on the screen until the calling shell script clears it later. This is useful when you want to inform the user that some operations are carrying on that may require some time to finish. .IP -On exit, no text is written to \fBdialog\fP's output. +On exit, no text is written to \fB\*p\fP's output. Only an "OK" button is provided for input, but an ESC exit status may be returned. . @@ -714,7 +730,7 @@ can be used to correct typing errors. If the input string is longer than can fit in the dialog box, the input field will be scrolled. .IP -On exit, the input string will be printed on \fBdialog\fP's output. +On exit, the input string will be printed on \fB\*p\fP's output. . . .IP "\fB--inputmenu \fItext height width menu-height \fR[ \fItag item \fR] \fI..." @@ -733,7 +749,7 @@ the current item when it is pressed. It is possible to rename the current entry by pressing the \fIRename\fP button. -Then \fBdialog\fP will write the following on \fBdialog\fP's output. +Then \fB\*p\fP will write the following on \fB\*p\fP's output. .IP RENAMED <tag> <item> .RE @@ -759,7 +775,7 @@ entries displayed in the menu at one time, but the menu will be scrolled if there are more entries than that. .IP On exit the \fItag\fP -of the chosen menu entry will be printed on \fBdialog\fP's output. +of the chosen menu entry will be printed on \fB\*p\fP's output. If the "\fB--help-button\fR" option is given, the corresponding help text will be printed if the user selects the help button. . @@ -787,7 +803,7 @@ The meter indicates the percentage. .IP It also displays a list of the \fItag\fP- and \fIitem\fP-values at the top of the box. -See dialog(3) for the tag values. +See \*l(3) for the tag values. .IP The \fItext\fP is shown as a caption between the list and meter. The \fIpercent\fR value denotes the initial percentage shown in the meter. @@ -795,7 +811,7 @@ The \fIpercent\fR value denotes the initial percentage shown in the meter. No provision is made for reading data from the standard input as \fB--gauge\fP does. .IP -On exit, no text is written to \fBdialog\fP's output. +On exit, no text is written to \fB\*p\fP's output. The widget accepts no input, so the exit status is always OK. . .IP "\fB--msgbox \fItext height width" @@ -804,14 +820,14 @@ The only difference between a \fBmessage\fP box and a \fByes/no\fP box is that a \fBmessage\fP box has only a single \fBOK\fP button. You can use this dialog box to display any message you like. After reading the message, the user can press the \fIENTER\fP key so that -\fBdialog\fP will exit and the calling shell script can continue its operation. +\fB\*p\fP will exit and the calling shell script can continue its operation. .IP If the message is too large for the space, -\fBdialog\fP may allow you to scroll it, +\fB\*p\fP may allow you to scroll it, provided that the underlying curses implementation is capable enough. In this case, a percentage is shown in the base of the widget. .IP -On exit, no text is written to \fBdialog\fP's output. +On exit, no text is written to \fB\*p\fP's output. Only an "OK" button is provided for input, but an ESC exit status may be returned. . @@ -838,7 +854,7 @@ cannot see. For these reasons, using "init" is highly discouraged. See "\fB--insecure\fP" if you do not care about your password. .IP -On exit, the input string will be printed on \fBdialog\fP's output. +On exit, the input string will be printed on \fB\*p\fP's output. . . .nf @@ -867,7 +883,7 @@ The only difference is that you can indicate which entry is currently selected, by setting its .IR status " to " on "." .IP -On exit, the name of the selected item is written to \fBdialog\fP's output. +On exit, the name of the selected item is written to \fB\*p\fP's output. . . .IP "\fB--tailbox \fIfile height width" @@ -875,7 +891,7 @@ Display text from a file in a dialog box, as in a "tail -f" command. Scroll left/right using vi-style 'h' and 'l', or arrow-keys. A '0' resets the scrolling. .IP -On exit, no text is written to \fBdialog\fP's output. +On exit, no text is written to \fB\*p\fP's output. Only an "OK" button is provided for input, but an ESC exit status may be returned. . @@ -886,23 +902,23 @@ as in a "tail -f &" command. Scroll left/right using vi-style 'h' and 'l', or arrow-keys. A '0' resets the scrolling. .IP -Dialog treats the background task specially if there are other +\*L treats the background task specially if there are other widgets (\fB--and-widget\fP) on the screen concurrently. Until those widgets are closed (e.g., an "OK"), -\fBdialog\fP will perform all of the tailboxbg widgets in the same process, +\fB\*p\fP will perform all of the tailboxbg widgets in the same process, polling for updates. You may use a tab to traverse between the widgets on the screen, and close them individually, e.g., by pressing \fIENTER\fP. -Once the non-tailboxbg widgets are closed, \fBdialog\fP forks a copy of itself +Once the non-tailboxbg widgets are closed, \fB\*p\fP forks a copy of itself into the background, and prints its process id if the "\fB--no-kill\fP" option is given. .IP -On exit, no text is written to \fBdialog\fP's output. +On exit, no text is written to \fB\*p\fP's output. Only an "EXIT" button is provided for input, but an ESC exit status may be returned. .IP NOTE: -Older versions of \fBdialog\fP forked immediately and attempted to +Older versions of \fB\*p\fP forked immediately and attempted to update the screen individually. Besides being bad for performance, it was unworkable. @@ -928,7 +944,7 @@ A '0' resets the left/right scrolling. For more convenience, vi-style forward and backward searching functions are also provided. .IP -On exit, no text is written to \fBdialog\fP's output. +On exit, no text is written to \fB\*p\fP's output. Only an "EXIT" button is provided for input, but an ESC exit status may be returned. . @@ -971,7 +987,7 @@ button and a button, in which the user can switch between by pressing the .IR TAB " key." .IP -On exit, no text is written to \fBdialog\fP's output. +On exit, no text is written to \fB\*p\fP's output. In addition to the "Yes" and "No" exit codes (see DIAGNOSTICS) an ESC exit status may be returned. .IP @@ -996,11 +1012,11 @@ Beep after a user has completed a widget by pressing one of the buttons. Create a sample configuration file by typing: .LP .in +1i -"dialog --create-rc <file>" +"\*p --create-rc <file>" .TP 4 2. At start, -\fBdialog\fP +\fB\*p\fP determines the settings to use as follows: .RS .TP 4 @@ -1024,14 +1040,14 @@ if the file in (c) is not found, use compiled in defaults. .TP 4 3. Edit the sample configuration file and copy it to some place that -\fBdialog\fP +\fB\*p\fP can find, as stated in step 2 above. . .\" ************************************************************************ .SH "KEY BINDINGS" -You can override or add to key bindings in \fBdialog\fP +You can override or add to key bindings in \fB\*p\fP by adding to the configuration file. -\fBDialog\fP's \fBbindkey\fP command maps single keys to its internal coding. +\fB\*L\fP's \fBbindkey\fP command maps single keys to its internal coding. .EX bindkey \fIwidget\fP \fIcurses_key\fP \fIdialog_key\fP .EE @@ -1042,11 +1058,11 @@ User-defined bindings override the built-in bindings. .PP The \fIcurses_key\fP can be any of the names derived from \fBcurses.h\fP, e.g., "HELP" from "KEY_HELP". -\fBDialog\fP also recognizes ANSI control characters such as "^A", "^?", +\fB\*L\fP also recognizes ANSI control characters such as "^A", "^?", as well as C1-controls such as "~A" and "~?". Finally, it allows any single character to be escaped with a backslash. .PP -\fBDialog\fP's internal keycode names correspond to the +\fB\*L\fP's internal keycode names correspond to the \fBDLG_KEYS_ENUM\fP type in \fBdlg_keys.h\fP, e.g., "HELP" from "DLGK_HELP". . @@ -1057,7 +1073,7 @@ Finally, it allows any single character to be escaped with a backslash. Define this variable to apply any of the common options to each widget. Most of the common options are reset before processing each widget. If you set the options in this environment variable, -they are applied to \fBdialog\fP's state after the reset. +they are applied to \fB\*p\fP's state after the reset. As in the "\fB--file\fP" option, double-quotes and backslashes are interpreted. .IP @@ -1093,14 +1109,14 @@ Normally shell scripts cannot distinguish between -1 and 255. .TP 15 \fBDIALOG_TTY\fP Set this variable to "1" to provide compatibility with older versions -of \fBdialog\fP which assumed that if the script redirects the standard output, +of \fB\*p\fP which assumed that if the script redirects the standard output, that the "\fB--stdout\fP" option was given. .SH FILES .TP 20 \fI$HOME/.dialogrc\fP default configuration file .SH EXAMPLES -The \fBdialog\fP sources contain several samples +The \fB\*p\fP sources contain several samples of how to use the different box options and how they look. Just take a look into the directory \fBsamples/\fP of the source. .SH DIAGNOSTICS @@ -1109,7 +1125,7 @@ Normally they are: .TP 5 0 if -.BR dialog " is exited by pressing the " Yes " or " OK +.BR \*p " is exited by pressing the " Yes " or " OK button. .TP 5 1 @@ -1132,24 +1148,24 @@ if the button is pressed. .TP 5 -1 -if errors occur inside \fBdialog\fP -or \fBdialog\fP is exited by pressing the \fIESC\fP key. +if errors occur inside \fB\*p\fP +or \fB\*p\fP is exited by pressing the \fIESC\fP key. . .\" ************************************************************************ .SH PORTABILITY -\fBdialog\fP works with X/Open curses. +\fB\*L\fP works with X/Open curses. However, some implementations have deficiencies: .RS 3 .TP 3 - HPUX curses (and perhaps others) do not open the terminal properly for the \fInewterm\fP function. -This interferes with \fBdialog\fP's \fB--input-fd\fP option, +This interferes with \fB\*p\fP's \fB--input-fd\fP option, by preventing cursor-keys and similar escape sequences from being recognized. .TP 3 - -NetBSD curses does not support subwindows of subwindows. -\fBdialog\fP will not display shadows of windows. +NetBSD 5.1 curses has incomplete support for wide-characters. +\fB\*p\fP will build, but not all examples display properly. .RE .\" ************************************************************************ .SH COMPATIBILITY @@ -1158,7 +1174,7 @@ You may want to write scripts which run with other \fBdialog\fP "clones". First, there is the "original" \fBdialog\fP program to consider (versions 0.3 to 0.9). It had some misspelled (or inconsistent) options. -The \fBdialog\fP program maps those deprecated options to the preferred ones. +The \fB\*p\fP program maps those deprecated options to the preferred ones. They include: .RS .TS @@ -1176,7 +1192,7 @@ this is an X application. With some care, it is possible to write useful scripts that work with both \fBXdialog\fP and \fBdialog\fP. .PP -The \fBdialog\fP program ignores these options which are recognized +The \fB\*p\fP program ignores these options which are recognized by \fBXdialog\fP: .RS .TS @@ -1199,7 +1215,7 @@ l l. .TE .RE .PP -\fBXdialog\fP's manpage has a section discussing its compatibility with \fBdialog\fP. +\fBXdialog\fP's manpage has a section discussing its compatibility with \fB\*p\fP. .SS WHIPTAIL Then there is \fBwhiptail\fP. For practical purposes, it is maintained by Debian. @@ -1207,13 +1223,13 @@ Its documentation claims .RS .sp .nf -whiptail(1) is a lightweight replacement for dialog(1), +whiptail(1) is a lightweight replacement for \*p(1), to provide dialog boxes for shell scripts. It is built on the newt windowing library rather than the ncurses library, allowing it to be smaller in embedded enviroments such as installers, rescue disks, etc. .sp -whiptail is designed to be drop-in compatible with dialog, but +whiptail is designed to be drop-in compatible with \*p, but has less features: some dialog boxes are not implemented, such as tailbox, timebox, calendarbox, etc. .fi @@ -1221,31 +1237,31 @@ as tailbox, timebox, calendarbox, etc. .PP Comparing actual sizes (Debian testing, 2007/1/10): The total of sizes for \fBwhiptail\fP, the newt, popt and slang libraries is 757kb. -The comparable number for \fBdialog\fP (counting ncurses) is 520kb. +The comparable number for \fB\*p\fP (counting ncurses) is 520kb. Disregard the first paragraph. .PP The second paragraph is misleading, since \fBwhiptail\fP -also does not work for common options of dialog, such as the gauge box. -\fBwhiptail\fP is less compatible with \fBdialog\fP than the decade-old +also does not work for common options of \*p, such as the gauge box. +\fBwhiptail\fP is less compatible with \fB\*p\fP than the decade-old original dialog 0.4 program. .PP -\fBwhiptail\fP's manpage borrows features from \fBdialog\fP, e.g., +\fBwhiptail\fP's manpage borrows features from \fB\*p\fP, e.g., \fB--default-item\fP, \fB--output-fd\fP, -but oddly cites only \fBdialog\fP versions up to 0.4 as a source. +but oddly cites only \fB\*p\fP versions up to 0.4 as a source. That is, its manpage refers to features which -were borrowed from more recent versions of \fBdialog\fP, e.g., +were borrowed from more recent versions of \fB\*p\fP, e.g., the \fB--gauge\fP and \fB--password\fP boxes, as well as options such as \fB-separate-output\fP. Somewhat humorously, one may note that the \fBpopt\fP feature (undocumented in its manpage) -of using a "--" as an escape was documented in \fBdialog\fP's manpage about +of using a "--" as an escape was documented in \fB\*p\fP's manpage about a year before it was mentioned in \fBwhiptail\fP's manpage. \fBwhiptail\fP's manpage incorrectly attributes that to \fBgetopt\fP (and is inaccurate anyway). .PP -Debian uses \fBwhiptail\fP for the official \fBdialog\fP variation. +Debian uses \fBwhiptail\fP for the official \fB\*p\fP variation. .PP -The \fBdialog\fP program ignores or maps these options which are recognized +The \fB\*p\fP program ignores or maps these options which are recognized by \fBwhiptail\fP: .RS .TS @@ -1275,7 +1291,7 @@ Valery Reznic - the form and progressbox widgets. Yura Kalinichenko adapted the gauge widget as "pause". .PP This is a rewrite (except as needed to provide compatibility) -of the earlier version of \fBdialog 0.9a\fP, +of the earlier version of \fB\*p 0.9a\fP, which lists as authors: .RS .LP diff --git a/Master/texmf/doc/man/man1/texmfstart.1 b/Master/texmf/doc/man/man1/texmfstart.1 index 1310422261f..e99ab230bd1 100644 --- a/Master/texmf/doc/man/man1/texmfstart.1 +++ b/Master/texmf/doc/man/man1/texmfstart.1 @@ -21,8 +21,8 @@ texmfstart \- run ConTeXt scripts, make ConTeXt wrapper scripts, view documents \fB texmfstart\fP [ \fIoptions ...\fP ] [ \fIfilename\fP ] [ \fIarguments ...\fP ] .SH "DESCRIPTION" -ConTeXt is a typesetting system based on -the .BR tex (1) +ConTeXt is a typesetting system based on the +.BR tex (1) family of programs. .B texmfstart is a ConTeXt meta-script that can run subordinate |