Dear Developers and especially #imap_reviewers,This recently pushed diff, D52, is intended to support the creation of rI:cyrus-imapd/man/imapd.conf.rst, which in turn can be plopped into rD:cyrus-docs/source/imapd/admin/configs/imapd.conf.rst to build man pages and online documentation.
In order to get this to work, I had to make some small changes to lib/imapoptions, mostly to correct non-standard comments which cause issues both with the existing config2man as well as with the new config2rst commands.
As I don't have rights to land this, I hope someone who does have those rights will do so, assuming it passes review.
The next issue to deal with, then, is to get config2rst added into the autoconf/makefile stuff, and to figure out just how we will actually merge imapd.conf.rst into rD, and then to merge the generated man pages from rD:cyrus-docs/build/man back into rI:cyrus-imapd/man.
I leave these tasks for the actual developers, rather than little old me. :-)
Along with D49, this should close T84.
Cheers,
-nic
On 06/23/2015 04:31 PM, onlight (Nic Bernstein) wrote:
onlight created this revision. onlight added reviewers: IMAP Reviewers, Documentation Reviewers. REVISION SUMMARY New tool, config2rst, will support the creation of .rst version of imapd.conf.5 manpage.Slight changes to lib/imapoptions to correct formatting and ensureinteroperation with aforementioned config2rst. TEST PLAN None REPOSITORY rI cyrus-imapd BRANCH dev/config2rst-work REVISION DETAIL https://git.cyrus.foundation/D52 AFFECTED FILES lib/imapoptions tools/config2rst EMAIL PREFERENCES https://git.cyrus.foundation/settings/panel/emailpreferences/ To: onlight, murchison, elliefm, brong, vanmeeuwen, admin, nicolan, amor
-- Nic Bernstein n...@onlight.com Onlight, Inc. www.onlight.com 1442 N Farwell Ave., Suite 600 v. 414.272.4477 Milwaukee, Wisconsin 53202
<<attachment: nic.vcf>>
