Bug#189343: tetex-doc: poor Description:

[<stefan.ulrich@zen.co.uk>]

Hilmar Preusse <hille42@web.de> wrote :

> > >  If you want a full installation of teTeX
> > >  you have to install tetex-extra.
> > >  . 
> > >  Together with tetex-bin you'll have a minimal installation.
> > 
> > Together with tetex-bin you'll have a minimal installation.
> > For a full installation of teTeX, you should also install
> > tetex-extra.
> > 
> Is this an extra (the last) paragraph?

Sorry for not being clear about that - I guess it should be. (I wasn't
happy with the original since first mentioning the full and then the
minimal installation seemed confusing).

> > ...  programs belonging to teTeX, i.e. the (La)TeX compiler itself,
> > and variants like pdf(la)tex, e-TeX etc. It also contains auxiliary
> > programs like dvips and xdvi,
> >                         ^^^^^^^^^^^^^^^^^^^
> It is. There are some wishlist bugs about splitting xdvi off from
> tetex-bin as it seems to be one of the few programs in tetex-bin,
> which depends on xlibs. The other program is that /usr/bin/mfw
> (Metafont with support for displaying generated characters).

Yes, I've seen that bug - I think I have no opinion on it. (It makes
sense from a logical point of view, but it might take some effort to
untangle the dependencies. Currently xt.ac is in kpathsea, which
doesn't seem right, and might change in the future.)

If it was split off, the text would need to be changed of course ;-)

My reason for adding xdvi was that it might be a useful info for some
people, and besides, `other programs, like x and y' reads better than
`other programs, like x'. Maybe others could be added too - or will a
full file list be included too? In that case, one could of course omit
the examples from the description.

Possible variant listing more examples:

Description: The teTeX binary files
 This is the binary part of teTeX (a TeX implementation for UNIX
 compatible systems). This package contains all the executable
 programs belonging to teTeX, i.e. the (La)TeX compiler itself
 and variants like pdf(la)tex and e-TeX. It also contains
 auxiliary programs like bibtex, makeindex, dvips and xdvi,
 and the man pages and info files for all these programs.

> > >  You need at least additional tetex-base to get a useful installation.
> > 
> > To get a useful installation, you'll need at least tetex-base in
> > addition.
> > 
> Perhaps we can can leave that sentence out, as tetex-bin depends on
> tetex-base.

Yup, makes sense.

Best,
Stefan