[86173] trunk/dports/python/py-sip/Portfile

[Ryan Schmidt]

On Oct 31, 2011, at 21:22, Jeremy Lavergne wrote:

>> There had at one time been an effort to develop new documentation files, out of which could be generated the guide, the manpages, and anything else we wanted. I don't think that got completed though.
> 
> Don't let that stop you though.

Right. Even just getting the current manpages to appear in the guide would be helpful. But we would want to do so in a way that isn't just formatting the current manpages as XML and copying them into the guide sources, because they'll just get out of sync with the manpages sources. We currently have some things documented in the guide and not the manpages, some things documented in the manpages and not the guide, and some things documented in the wiki, and even some things documented on the MacPorts web page proper, with some overlap between all of these. The goal of the documentation rewrite was to deduplicate and get a single canonical source for the documentation, out of which could be generated whatever formats we wanted. It is probably a long and involved process though.