Documentation Unification and Awesomeification

[Sebastian Hagedorn]

--On 8. Juni 2015 17:14:21 -0500 Nic Bernstein <nic at onlight.com> wrote:

> So here's my quandary:
>
>   • I've found it completely impossible to produce standards-compliant
> man pages using ReStructuredText with the Sphinx/Docutils tool suite,
> without running into this problem.
>   • There's just no way I can find to work around this other than to
> either:
>     • Alter the docutils/writers/manpage.py code, as shown above, or
>     • Grep or sed out the gratuitous ".ft " commands from the resultant
> output.
>
> I think the best way forward with this is to opt for the latter and
> modify cyrus-docs/Makefile to strip the resulting manpages from
> cyrus-docs/build/man, like so:
>
>
>
> <...>
> BUILDDIR      = build
> SED           = /bin/sed
> <snip>
> man:
> 	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
> 	$(SED) -i -e 's/^\.ft.*//' $(BUILDDIR)/man/*.[0-9]*
> 	@echo
> 	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
> <...>
>
>
>
> Thoughts?

How about reporting this as a bug upstream?

Sebastian Hagedorn
-- 
    .:.Sebastian Hagedorn - Weyertal 121 (Gebäude 133), Zimmer 2.02.:.
                 .:.Regionales Rechenzentrum (RRZK).:.
   .:.Universität zu Köln / Cologne University - ✆ +49-221-470-89578.:.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pkcs7-signature
Size: 5313 bytes
Desc: not available
Url : http://lists.andrew.cmu.edu/pipermail/cyrus-devel/attachments/20150609/9e501ce5/attachment.bin