-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On Fri, Apr 10, 2009 at 10:42:33PM +0200, Rainer Müller wrote: > For everyone who did not notice yet what this is about, I documented my > plans about a new help system based on AsciiDoc at > <http://trac.macports.org/wiki/NewHelpSystem>.
Hi all, First I want to apologize for being inactive in the last months. I only have sporadic access to a Mac at the moment (I switched to Linux with my main machine) so my activity was very low. But I like the MacPorts project and will continue to update my ports when I have time and access to my Mac. But as I will not be very active feel free to take over my ports. Regarding the guide. I think for now the guide should use DocBook at least until it's finished. Then we can decide if we want to switch. But the duplication pointed out by Mark is an important factor. So I think we should make a quick decision if the man pages should be written in DocBook or Asciidoc. And after the decision all other documents should be merged and removed so we only have one source and no duplication. If we switch the man pages to Asciidoc then all man pages in base/doc/ should only be generated through Asciidoc so we have a single format. The only problematic man page is portfile.7 as it is directly wired into the guide. I would like to remove it (or generate it through DocBook) and instead install the guide in /opt/local/share/doc/port/ so the user can access it. We should really remove all duplication and move documentation either to base/doc or doc, but not in both places. Thanks, Simon - -- + privacy is necessary + using http://gnupg.org + public key id: 0x6115F804EFB33229 -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (GNU/Linux) iEYEARECAAYFAknrPR0ACgkQYRX4BO+zMil8ygCgwWNB0Mumz4BPmKtGUe26kaBc /b0AoKg1wx4iOkj80BuZ50V3nnVbX6EZ =HTco -----END PGP SIGNATURE----- _______________________________________________ macports-dev mailing list [email protected] http://lists.macosforge.org/mailman/listinfo.cgi/macports-dev
