summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorwl <wl>2012-05-20 13:58:09 +0000
committerwl <wl>2012-05-20 13:58:09 +0000
commit0ba10d251a10e8b7453fad8877e529a5c2e26f96 (patch)
tree816dea7244660f65e6fae78b540b8dafafbd949a /doc
parent496b379176b94e41aa03f7779bb3bac06e91c783 (diff)
downloadgroff-0ba10d251a10e8b7453fad8877e529a5c2e26f96.tar.gz
* doc/groff.texinfo: Add extra info about `.asciify'.
Document new gropdf options -u and -s. * src/devices/gropdf/gropdf.man: Remove references to Type 42 fonts, they do not work in PDFs. Document new option -s which adds `statistics' line to end of PDF file showing number of pages in document. This has always been the default behaviour (to add this line), all other software seems to ignore it as intended, but `gs' sometimes complains, so the default is now to omit the statistics. Document new option -u[cmapfilename] to allow a user ToUnicode CMap instead of gropdf's default. If no `cmapfilename' given then do not include any ToUnicode CMap. * src/devices/gropdf/gropdf.pl <top>: Allow `bundled' flags on command line (i.e. -de = -d -e). Use $RT_SEP as multi path separator, not hard coded `:'. Update all users. New flags -u and -s. Once a custom papersize has been set as \X'papersize x,y' make it sticky so all following pages use custom size. When importing pdf with \X'pdf: pdfpic ...' do not compress objects which are already compressed! This caused problems with PDFs created with ImageMagick, now fixed. (IsText, PutLine, do_t): The troff `u' command can contain a kerning adjustment number, this was not being handled, now fixed. (do_c): The troff `c' command was not being handled correctly, now fixed. (FindChar, RemapChr, do_N): Handle fonts with more than 255 glyphs. ($ucmap): Define CMap ToUnicode to convert ligatures (fl,fi,ff,ffl,ffi) back to individual characters, useful for cut'n'paste and text searching. (LoadFont): Handle it. (ToPoints, GetPoints): Handle `z' unit. (do_x, FixPDFColour, PutHotSpot): Allow Annotation colour to be groff colour, i.e. 0-65535 *3, or #rrggbb, or #rrrrbbbbgggg. (do_p):The papersize width/length in switch -p were reversed, corrected. * src/devices/gropdf/Makefile.sub (gropdf): Use $RT_SEP. Use $fontpath rather than $fontdir (this ensures site-font is included in searches). * tmac/pdf.tmac (PDFBOOKMARK.VIEW, PDFHREF.VIEW, PDFPAGE.Y): Fix strings. (pdfbookmark): Correct handling of bookmark levels. Convert \[em] to hyphen in bookmarks Rather use -N than -T for "named" bookmarks (-T already used for "tag" in pdfmark.tmac) (.pdfclean): New macro which attempts to asciify bookmark text. (.pdfpagename): New wrapper macro for \X'pdf: pagename'. (.pdfswitchtopage): New wrapper macro for \X'pdf: switchtopage'.
Diffstat (limited to 'doc')
-rw-r--r--doc/groff.texinfo22
1 files changed, 19 insertions, 3 deletions
diff --git a/doc/groff.texinfo b/doc/groff.texinfo
index b1e31707..da6535f0 100644
--- a/doc/groff.texinfo
+++ b/doc/groff.texinfo
@@ -26,7 +26,7 @@
@copying
This manual documents GNU @code{troff} version 1.21.
-Copyright @copyright{} 1994-2011 Free Software Foundation, Inc.
+Copyright @copyright{} 1994-2012 Free Software Foundation, Inc.
@quotation
Permission is granted to copy, distribute and/or modify this document
@@ -472,7 +472,7 @@ developing GNU and promoting software freedom.''
@title groff
@subtitle The GNU implementation of @code{troff}
@subtitle Edition 1.21
-@subtitle Winter 2010
+@subtitle Spring 2012
@author by Trent A.@tie{}Fisher
@author and Werner Lemberg (@email{bug-groff@@gnu.org})
@@ -13012,6 +13012,10 @@ the following sets register@tie{}@code{n} to@tie{}1.
.x
@endExample
+Note that @code{asciify} cannot return all items in a diversion back
+to their source equivalent, nodes such as @code{\N[...]} will still
+remain as nodes, so the result cannot be guaranteed to be a pure string.
+
@xref{Copy-in Mode}.
@endDefreq
@@ -15198,6 +15202,18 @@ file. See the @cite{groff_font(5)} manual page for details.
@item -v
Print the version number.
+
+@item -s
+Append a comment line to end of PDF showing statistics, i.e. number of
+pages in document. Ghostscript's @cite{ps2pdf(1)} complains about this
+line if it is included, but works anyway.
+
+@item -u@var{filename}
+@code{gropdf} normally includes a ToUnicode CMap with any font created
+using @file{text.enc} as the encoding file, this makes it easier to
+search for words which contain ligatures. You can include your own CMap
+by specifying a @var{filename} or have no CMap at all by omitting the
+@var{filename}.
@end table
@c ---------------------------------------------------------------------
@@ -15434,7 +15450,7 @@ options:
@table @option
@item -a@var{bits}
-Use this number of @var{bits} (= 1, 2 or 4) for text antialiasing.
+Use this number of @var{bits} (= 1, 2 or 4) for text antialiasing.
Default: @var{bits} = 4.
@item -a0