[texdoc] texdoc and man pages

Reinhard Kotucha reinhard.kotucha at web.de
Sat Oct 18 01:53:08 CEST 2008


Karl Berry writes:
 >     What is the problem with manual pages called 'dvips.1.pdf'?
 > 
 > I am not necessarily opposed to this.  But for packages which have
 > nothing *but* man pages, texdoc foo should return the man page.  It
 > just moves the special case from one side to the other.

Hi Karl,
of course, the special case is moved from one side to the other.  But
I think that's not a matter of taste.

Let me cite my mail to Manuel:

 >  kpsewhich -format='TeX system documentation' dvips.pdf
 > 
 > and 
 > 
 >  kpsewhich -format='TeX system documentation' dvips.1.pdf
 > 
 > provide different results.

 > If there are two different files with the same name, the result is
 > unpredictable.  That's all I'm concerned about.
 > 
 > And does it really matter at all whether texdoc derives the
 > information (that a particular file is a man page) from the file
 > name or from the path?

I definitely prefer unique names.

Regards,
  Reinhard

-- 
----------------------------------------------------------------------------
Reinhard Kotucha			              Phone: +49-511-3373112
Marschnerstr. 25
D-30167 Hannover	                      mailto:reinhard.kotucha at web.de
----------------------------------------------------------------------------
Microsoft isn't the answer. Microsoft is the question, and the answer is NO.
----------------------------------------------------------------------------


More information about the texdoc mailing list