[LLVMdev] pods

[Daniel Dunbar]

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.

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

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

 - Daniel

On Wed, Aug 1, 2012 at 8:15 PM, Marco Peereboom <marco at peereboom.us> wrote:
> To my absolute dismay I found out that the latest llvm docs are in rst
> format.  I tried a couple of rst to man converters and the results are
> pretty bad.  rst2man sort of works but spits out a lot of errors and the
> man pages don't look very good.  sphinx crashes and is really too heavy.
>   pandoc, haskell, right.
>
> I'd like to plead with the forces that be to bring back the pods.  Pods
> aren't great but pod2man is at least a standard UNIX utility and one can
> convert it to many other formats easily.
>
> Help a UNIX brother out!
> _______________________________________________
> LLVM Developers mailing list
> LLVMdev at cs.uiuc.edu         http://llvm.cs.uiuc.edu
> http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev