[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#102120: tetex-bin: sparse docs for making PDF [with PATCH]



Package: tetex-bin
Version: 1.0.6-7
Severity: normal

Currently, the dvips documentation suggests using only the standard 35
PostScript fonts for any document to be converted to PDF.  Other fonts
can be used if .pfb files are available and the right options are
specified.  The current docs point to the necessary fonts, but do not
make this point.  The patch below clarifies this, I think.  It also
clears up a couple of makeinfo complaints.

Note: I include pointers to "Creating quality Adobe PDF files from TeX
with DVIPS" by Kendall Whitehouse of Adobe.  The current docs include
a link to http://www.emrg.com/texpdf.html which might have been the same
document.  However, that link is broken.  

This patch assumes the dvips installation includes a suitable
config.pdf file and the font map files it references.  If they are
absent from the upstream sources, then maybe this patch is suitable
only for the Debian package.  Or (better) those files need to be
folded into the upstream sources at the same time.

		- Jim Van Zandt

p.s. I'm not related to Timothy Van Zandt.

p.p.s. This patch is against tetex-bin_1.0.7+20001218.orig.tar.gz


--- texk/dvipsk/dvips.texi-orig	Sat Oct 31 22:45:06 1998
+++ texk/dvipsk/dvips.texi	Sun Jun 24 15:15:13 2001
@@ -1047,8 +1047,8 @@
 can use the @samp{-t} option twice, once for the paper type, and once
 for @samp{landscape}.
 
-@item -T @var{hsize,vsize}
-@opindex -T @var{hsize,vsize}
+@item -T @var{hsize},@var{vsize}
+@opindex -T @var{hsize},@var{vsize}
 Set the paper size to (@var{hsize},@var{vsize}), a comma-separated pair
 of dimensions such as @samp{.1in,-.3cm} (@pxref{papersize special}).  It
 overrides any paper size special in the DVI file.
@@ -2683,7 +2683,7 @@
 
 
 @menu
-* Hypertext caveats::       Bitmaps poorly supported, psi.
+* Hypertext caveats::       Font quality, missing character psi.
 * Hypertext specials::      The details on the specials.
 @end menu
 
@@ -2695,19 +2695,65 @@
 
 @cindex Computer Modern in PostScript
 @cindex hypertext and bitmap fonts
-If you intend to go all the way to PDF, you will probably want to use
-PostScript fonts exclusively, since the Adobe PDF readers are extremely
-slow when dealing with bitmap fonts.  Commercial versions of the
-Computer Modern fonts are available from Blue Sky; public domain
-versions are available from CTAN sites (for CTAN info,
-@pxref{unixtex.ftp,,, kpathsea, Kpathsea}) in:
+@cindex hypertext caveats
+@cindex embedding Type 1 fonts
+@cindex PDF files, font quality
+If you intend to go all the way to PDF, you may want to use the standard
+35 PostScript fonts exclusively, since other fonts are embedded as
+bitmaps by default.  The Adobe PDF readers are extremely slow when
+dealing with bitmap fonts and the results look terrible on the screen.
+Printouts will probably look fine, but may not take full advantage of a
+high-resolution printer.  Alternatively, you can have your fonts
+embedded as Type 1 scalable outlines.  The resulting PostScript files
+may be larger, but can be effectively rasterized at any resolution.
+They can also be converted to PDF files that can be used effectively at
+any screen or printer resolution.
+
+To get the TeX fonts embedded in the PostScript file as Type 1 fonts,
+add @samp{-Ppdf} to the dvips command line switches.  The printout
+for a run should look something like this:
+
+@example
+  dvips report -Ppdf -o report.ps
+  This is dvips(k) 5.86 Copyright 1999 Radical Eye Software (www.radicaleye.com)
+  ' TeX output 2001.06.15:0837' -> report.ps
+  <tex.pro><alt-rule.pro><texc.pro><texps.pro><special.pro>. 
+  <cmbx9.pfb><cmsy6.pfb><cmsy7.pfb><cmr5.pfb><cmex10.pfb><cmr9.pfb>
+  <cmmi7.pfb><cmsy10.pfb><cmmib10.pfb><cmmi10.pfb><cmti10.pfb>
+  <cmr7.pfb><cmbx10.pfb><cmr10.pfb><cmti9.pfb><cmr12.pfb><cmbx12.pfb>
+  [1] [2<mean1.ps>] [3<bounce1-00.ps>] [4]
+@end example
+
+An entry like "<cmr10.pfb>" indicates success: dvips found the Computer
+Modern Roman 10 point font in a PostScript Font Binary file, translated
+it to an ASCII encoding, and embedded it.  You can confirm this by
+examining the PostScript output file, looking for the section starting
+@code{%%BeginFont: CMR10} followed by an entry @code{/FontType 1 def}.
+
+The @samp{-Ppdf} option requires that the relevant outline (@file{.pfa}
+or @file{.pfb}) files be installed (@pxref{Font concepts}).  For
+example, the @file{cmr10} file might be in
+@file{/usr/share/texmf/fonts/type1/bluesky/cm/cmr10.pfb}.  Your TeX
+distribution may make those fonts available in a separate optional
+package (e.g. "tetex-extra" in a Debian system).  Failing that,
+commercial versions of the Computer Modern fonts are available from Blue
+Sky; public domain versions are available from CTAN sites (for CTAN
+info, @pxref{unixtex.ftp,,, kpathsea, Kpathsea}) in:
 @example
 fonts/postscript/bakoma
 fonts/postscript/paradissa
 @end example
+
 @noindent You may need to modify these fonts; see
 @url{http://xxx.lanl.gov/faq/bakoma.html}.
 
+In order to get Type 1 fonts embedded in a PDF file, you must use
+Acrobat's "distill" program to convert the PostScript file.  Currently,
+@code{ps2pdf}, the free program that comes with @code{Ghostscript}, will
+not embed Type 1 fonts.  You can check the fonts in a PDF file with
+Acrobat Reader by selecting the menu entries @samp{File|Document
+Info|Fonts}.
+
 @cindex psi character missing
 @cindex trailing spaces, dropped
 @cindex spaces, dropped trailing
@@ -2728,6 +2774,16 @@
 duplicate the first 32 characters starting at 192 to avoid MS-DOS
 problems.
 
+For more information on the use of TeX to produce PDF files, see the
+article "Creating quality Adobe PDF files from TeX with DVIPS" by
+Kendall Whitehouse of Adobe.  Adobe seems not to offer the article any
+more, but copies are available elsewhere, such as
+@url{http://www.math.hawaii.edu/~ralph/MathOnWeb/TeXPDF.html} or
+@url{http://www.utdallas.edu/~cantrell/online/543e.html}.  You may also
+want to check "Notes on converting (La)TeX documents to robust PDF using
+Rokicki's dvips and Acrobat Distiller" by Timothy P. Van Zandt, at
+@url{http://www.emrg.com/texpdf.htmlhttp://zandtwerk.insead.fr/tex2pdf.html}.
+
 
 @node Hypertext specials
 @subsection Hypertext specials
@@ -3236,7 +3292,7 @@
 @end example
 
 @item
-Insert an entry for the font in @file{psfonts.map} (@xref{psfonts.map}):
+Insert an entry for the font in @file{psfonts.map} (@pxref{psfonts.map}):
 @example
 rptmr      Times-Roman                 <ptmr8a.pfa
 @end example

-- System Information
Debian Release: testing/unstable
Kernel Version: Linux vanzandt 2.4.4 #1 Fri May 18 22:35:13 EDT 2001 i686 unknown

Versions of the packages tetex-bin depends on:
ii  debianutils    1.15           Miscellaneous utilities specific to Debian.
ii  dpkg-perl      0.1-3.0        Perl interface modules for dpkg
ii  ed             0.2-19         The classic unix line editor
ii  libc6          2.2.2-4        GNU C Library: Shared libraries and Timezone
ii  libpng2        1.0.8-1        PNG library - runtime
ii  libstdc++2.10  2.95.2-14      The GNU stdc++ library
ii  tetex-base     1.0-10         basic teTeX library files
ii  tetex-lib      1.0.6-7        shared libkpathsea for teTeX
ii  xlib6g         3.3.6-11potato shared libraries required by X clients
ii  zlib1g         1.1.3-14       compression library - runtime
	^^^ (Provides virtual package libz1)

--- Ignoring modified conffile /etc/texmf/texmf.cnf (>8k)



Reply to: