--- Begin Message ---
- To: Dan Jacobson <jidanni@jidanni.org>, 273084-done@bugs.debian.org
- Subject: Re: pdftex.1.gz: --help has basic info that man page lacks
- From: Hilmar Preusse <hille42@web.de>
- Date: Sun, 12 Sep 2010 21:42:08 +0200
- Message-id: <20100912194208.GA15815@preusse-16223.user.cis.dfn.de>
- In-reply-to: <E1CAN08-0003CF-6D@jidanni1>
- References: <E1CAN08-0003CF-6D@jidanni1>
Version: 2007-1
On 23.09.04 Dan Jacobson (jidanni@jidanni.org) wrote:
Hi Dan,
> Package: tetex-bin
> Version: 2.0.2-15
> Severity: minor
> File: /usr/share/man/man1/pdftex.1.gz
>
> SYNOPSIS
> pdftex [options] [commands]
> is not enough to get a person started, and indeed omits the filename
> that can be seen here:
>
> $ pdftex --help
> Usage: pdftex [OPTION]... [TEXNAME[.tex]] [COMMANDS]
>
> Nor does one see
> Run pdfTeX on TEXNAME, usually creating TEXNAME.pdf.
> etc.
>
Actually the situation has improved. The help reads now:
hille@drachi:~$ pdftex --help
Usage: pdftex [OPTION]... [TEXNAME[.tex]] [COMMANDS]
or: pdftex [OPTION]... \FIRST-LINE
or: pdftex [OPTION]... &FMT ARGS
Run pdfTeX on TEXNAME, usually creating TEXNAME.pdf.
Any remaining COMMANDS are processed as pdfTeX input, after TEXNAME is read.
If the first line of TEXNAME is %&FMT, and FMT is an existing .fmt file,
use it. Else use `NAME.fmt', where NAME is the program invocation name,
most commonly `pdftex'.
Alternatively, if the first non-option argument begins with a backslash,
interpret all non-option arguments as a line of pdfTeX input.
Alternatively, if the first non-option argument begins with a &, the
next word is taken as the FMT to read, overriding all else. Any
remaining arguments are processed as above.
In the manual page one can read:
NAME
pdftex, pdfinitex, pdfvirtex - PDF output from TeX
SYNOPSIS
pdftex [options] [& format ] [ file | \ commands ]
DESCRIPTION
Run the pdfTeX typesetter on file, usually creating file.pdf. If the
file argument has no extension, ".tex" will be appended to it. Instead
of a filename, a set of pdfTeX commands can be given, the a first of
which must start with a backslash. With a &format argument pdfTeX uses
a different set of precompiled commands, contained in format.fmt; it is
usually better to use the -fmt format option instead.
Both docs describe now the two methods to submit input to TeX. This
should be sufficient, I close that bug.
Regards,
H.
--
sigmentation fault
--- End Message ---