[Python-modules-team] Bug#643990: Inconsistent naming off command-line programs

[Jakub Wilk]

retitle 643990 python-docutils: inconsistent names of rst2*tex scripts
forwarded 643990 http://sourceforge.net/tracker/?func=detail&aid=3419937&group_id=38414&atid=422030
severity 643990 minor
tags 643990 + confirmed
thanks

* Juhapekka Tolvanen <juhtolv at iki.fi>, 2011-10-01, 16:43:
>When I see command name "rst2latex", I understand immediately, that it 
>takes RST-code and outputs LaTeX-code. It just follows common naming 
>convention of command line Unix-programs. It is so common that even 
>Jargon File knows about it:
>
>http://www.catb.org/jargon/html/0/infix-2.html
>
>And that's fine: rst2latex really works exactly as its name suggests.
>
>Then comes command line program called "rst2xetex". That name suggests, 
>it takes RST-code as its input and outputs Plain TeX -code suitable for 
>TeX-engine called XeTeX. Bzzz! Wrong! It's man page says:
>
>rst2xetex - convert reST documents to XeLateX
>
>What the hell? If it outputs LaTeX-code suitable for XeLaTeX, why its 
>name is "rst2xetex" and not "rst2xelatex", then? If I write LaTeX-code 
>that is compiled with TeX-engine called XeTeX, then I compile it with 
>command xelatex, and not xetex.
>
>That is totally stupid inconsistency. What the hell is going in the 
>twisted minds of developers of python-docutils?

I forwarded your bug report to upstream developers.

Next time, please formulate your compliant in such a way, that I can 
point them directly to the bug report without being embarrassed. Just 
because you're not completely happy about the software they wrote, 
doesn't mean that they don't deserve a little bit of respect.

Thanks in advance.

>BTW who writes Plain TeX -code, anyway, when we have LaTeX and ConTeXt?

Take me for instance.

-- 
Jakub Wilk