48af41221f
Groff
-----
o The argument of the command line option `-I' is now also passed to troff
and grops, specifying a directory to search for files on the command line,
files named in `so' and `psbb' requests, and files named in \X'ps: file'
and \X'ps: import' escapes.
o If option `-V' is used more than once, the commands will be both printed
on standard error and run.
Troff
-----
o Two new read-only, string-valued registers `.m' and `.M' return the
name of the current drawing and background color, respectively.
o New read-only register `.U' which is set to 1 if in safer mode and set
to 0 if in unsafe mode.
o An input encoding file for latin-5 (a.k.a. ISO 8859-9) has been added.
Example use:
groff -Tdvi -mlatin5 my_file > my_file.dvi
Note that some output devices don't support all glyphs of this encoding.
o If the `return' request is called with an argument, it exits twice,
namely the current macro and the macro one level higher. This is
used to define a wrapper macro for `return' in trace.tmac.
o For completeness, two new requests have been added: `dei1' and `ami1'.
They are equivalent to `dei' and `ami', respectively, but the macros
are executed with compatibility mode off (similar to `de1' and `am1').
o New command line option `-I' to specify a directory for files (both
those on the command line and those named in `psbb' requests). This is
also handled by the groff wrapper program.
o Since version 1.19 you can say `.vs 0'. Older versions emit a warning
and convert this to `.vs \n[.V]'.
This hasn't been documented properly. Note that `.vs 0' isn't saved in a
diversion since it doesn't result in vertical motion.
Pic
___
o Dashed and dotted ellipses have been implemented.
Tbl
---
o New key character `x' to make tbl call a user-defined macro on a table
cell. Patch by Heinz-Jürgen Oertel <hj.oertel@surfeu.de>.
Grohtml
-------
o New option `-j' to emit output splitted into multiple files.
Grops
-----
o New command line option `-I' to specify a directory to search for files
on the command line and files named in \X'ps: import' and \X'ps: file'
escapes. This is also handled by the groff wrapper program.
o The default value for the `broken' keyword in the DESC file is now 0.
Grolj4
------
o A new man page `lj4_font(5)' documents how fonts are accessed with
grolj4.
o The built-in fonts for LJ4 and newer PCL 5 devices have been completely
revised, mainly to access as much glyphs as possible. The provided
metric files should be compatible with recent PCL 5 printers also.
Additionally, font description files have been added for the Arial and
Times New Roman family, the MS symbol, and Wingdings fonts.
Hpftodit
--------
o Completely revised to handle HP TrueType metric files also. See the
hpftodit manual page for more details.
Macro Packages
--------------
o www.tmac: New macro `JOBNAME' to split output into multiple files.
o In mdoc, multiple calls to `.Lb' are now supported in the LIBRARY
section.
106 lines
2.2 KiB
Groff
106 lines
2.2 KiB
Groff
.\" Id: grap2graph.man,v 1.3 2003/10/28 07:46:23 wlemb Exp
|
|
.\" This documentation is released to the public domain.
|
|
.
|
|
.
|
|
.TH GRAP2GRAPH @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
|
|
.IX grap2graph
|
|
.SH NAME
|
|
grap2graph \- convert a grap diagram into a cropped bitmap image
|
|
.
|
|
.
|
|
.SH SYNOPSIS
|
|
.B grap2graph
|
|
[
|
|
.B \-unsafe
|
|
]
|
|
[
|
|
.BI \-resolution\ M\fR|\fPMxN
|
|
]
|
|
[
|
|
.BI \-format\ fmt
|
|
]
|
|
.
|
|
.
|
|
.SH DESCRIPTION
|
|
Reads a grap program as input; produces an image file (by default in
|
|
Portable Network Graphics format) suitable for the Web as output.
|
|
For a description of the grap language, see
|
|
.BR grap (1).
|
|
.P
|
|
Your graph specification should \fInot\fR be wrapped with the \&.G1 and
|
|
\&.G2 macros that normally guard it within
|
|
.BR groff (@MAN1EXT@)
|
|
macros.
|
|
.P
|
|
The output image will be a black-on-white graphic clipped to the
|
|
smallest possible bounding box that contains all the black pixels.
|
|
By specifying command-line options to be passed to
|
|
.BR convert (1)
|
|
you can give it a border, set the background transparent, set the
|
|
image's pixel density, or perform other useful transformations.
|
|
.P
|
|
This program uses
|
|
.BR grap (1),
|
|
.BR @g@pic (@MAN1EXT@),
|
|
.BR groff (@MAN1EXT@),
|
|
and the ImageMagick
|
|
.BR convert (1)
|
|
program.
|
|
These programs must be installed on your system and accessible on your
|
|
$PATH for \fBgrap2graph\fR to work.
|
|
.
|
|
.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-unsafe
|
|
Run
|
|
.BR @g@pic (@MAN1EXT@)
|
|
and
|
|
.BR groff (@MAN1EXT@)
|
|
in the `unsafe' mode enabling the PIC macro
|
|
.B sh
|
|
to execute arbitrary commands.
|
|
The default is to forbid this.
|
|
.TP
|
|
.BI \-format\ fmt
|
|
Specify an output format; the default is PNG (Portable Network Graphics).
|
|
Any format that
|
|
.BR convert (1)
|
|
can emit is supported.
|
|
.PP
|
|
Command-line switches and arguments not listed above are passed to
|
|
.BR convert (1).
|
|
.
|
|
.
|
|
.SH ENVIRONMENT
|
|
.TP
|
|
.B GROFF_TMPDIR
|
|
The directory in which temporary files will be created.
|
|
If this is not set
|
|
.B grap2graph
|
|
searches the environment variables
|
|
.BR \%TMPDIR ,
|
|
.BR TMP ,
|
|
and
|
|
.B TEMP
|
|
(in that order).
|
|
Otherwise, temporary files will be created in
|
|
.BR /tmp .
|
|
.
|
|
.
|
|
.SH "SEE ALSO"
|
|
.BR pic2graph (@MAN1EXT@),
|
|
.BR eqn2graph (@MAN1EXT@),
|
|
.BR @g@pic (@MAN1EXT@),
|
|
.BR groff (@MAN1EXT@),
|
|
.BR gs (1),
|
|
.BR convert (1).
|
|
.
|
|
.
|
|
.SH AUTHOR
|
|
Eric S. Raymond <esr@thyrsus.com>
|
|
.
|
|
.\" Local Variables:
|
|
.\" mode: nroff
|
|
.\" End:
|