Bug#123546: tetex-bin: dvips documentation incorrectly describes how to include graphic

[Ross Boylan <RossBoylan@stanfordalumni.org>]

Package: tetex-bin
Version: 1.0.7+20001218-7
Severity: minor

The documentation for dvips includes a discussion of how to get
graphics in your output.  It implies, incorrectly, that \epsffile is
the right command for latex even if you use LaTeX2e (as our distro
does).

This is undoubtedly an upstream bug.


The documentation does say that one should use the graphics or
graphicx package for LaTeX2e.  However, as I eventually discovered,
\includegraphics is the right command in that case.

This error occurs in the dvips info files that are part of this
package, and also in tetex-doc:
/usr/share/doc/texmf/programs/dvips.dvi.gz.  It probably occurs
elsewhere too (e.g., man pages).

The current node 'EPSF macros' reads
---------------------------------------------------------
If you are using LaTeX 2e, use the `graphics' or `graphicx' package.
If you are using LaTeX 2.09, add the `epsf' style option, as in:

     \documentstyle[12pt,epsf]{article}

In any case, the above only needs to be done once, no matter how many
figures you plan to include.

  Now, at the point you want to include a file, enter a line such as:

     \epsffile{foo.eps}

  If you are using LaTeX, you may need to add `\leavevmode' immediately
before the `\epsffile' command to get certain environments to work
correct.....
--------------------------------------------------------------------

I suggest:
-------------------------------------------------------------
If you are using LaTeX 2e, use the `graphics' or `graphicx' package:
	\usepackage{graphics}

Then include your figure like this:
	\includegraphics{foo.eps}

If you are using LaTeX 2.09, add the `epsf' style option, as in:

     \documentstyle[12pt,epsf]{article}

Then include your figure like this:
     \epsffile{foo.eps}



Note that the initial \input epsf, \usepackage, or epsf option needs
only be given once.  You should include your figure at the point you
want it to appear.

[My guess is \leavevmode applies only to LaTeX 2.09.  Needs to be
clarified.]

[I'm not sure if the following discussion of the vbox behavior applies to all
methods; that should be clarified.]
-----------------------------------------------------------------

By the way, I eventually found the documentation on the graphics
package under the graphics section of texdoctk, "PS and other graphics
(graphics/graphx)".

-- System Information
Debian Release: 3.0
Architecture: i386
Kernel: Linux wheat 2.4.12 #1 Mon Oct 29 18:13:57 PST 2001 i686
Locale: LANG=C, LC_CTYPE=C

Versions of packages tetex-bin depends on:
ii  debianutils            1.15              Miscellaneous utilities specific t
ii  dpkg                   1.9.18            Package maintenance system for Deb
ii  ed                     0.2-19            The classic unix line editor
ii  libc6                  2.2.4-5           GNU C Library: Shared libraries an
ii  libkpathsea3           1.0.7+20001218-7  shared libkpathsea for teTeX
ii  libpng2                1.0.12-2          PNG library - runtime
ii  libstdc++2.10-glibc2.2 1:2.95.4-0.011006 The GNU stdc++ library
ii  libtiff3g              3.5.5-6           Tag Image File Format library
ii  libwww0                5.3.2-8           The W3C WWW library
ii  libxaw7                4.1.0-9           X Athena widget set library
ii  tetex-base             1.0.2+20011202-1  basic teTeX library files
ii  xlibs                  4.1.0-9           X Window System client libraries
ii  zlib1g                 1:1.1.3-18        compression library - runtime