[LLVMdev] pods

[Marco Peereboom]

On 08/02/12 13:42, Daniel Dunbar wrote:
> I checked all of the man pages generated using Sphinx and I thought that:
>
> 1. They all looked mostly identical.
>
> 2. When they didn't, I was equally happy with the Sphinx output.

I couldn't get Sphinx to work.  It would always bomb out so I gave up.

Also sphinx is pretty heavy weight which is not helpful for our 
environment.  We use clang/llvm as the base compiler for bitrig and we 
use packages to do binary distribution.  Every additional run/compile 
time tool we have to add is one too many for various reasons.

I used rst2man and it missed some bits and pieces and pages like llvm-nm 
were mangled pretty good.  I did see that there is a new version of it 
so I will try that as a last resort.

> Can you provide two specific .1 files one from POD and one from Sphinx
> that shows an issue you are concerned about.

I would if I was smart enough to make sphinx work without crashing.

> I haven't encountered problems with "Sphinx crashing" generating man
> pages. This sounds like something that you should file a bug for.

Why were the pods dropped anyway?