[Mailman-Developers] preferred documentation format, sources for documentation in admin/www
Joost van Baal
j.e.vanbaal at uvt.nl
Fri Jan 6 06:42:49 CET 2006
Hi,
Brad and Barry: thanks for your reply!
On Thu, Jan 05, 2006 at 09:03:39PM -0500, Barry Warsaw wrote:
> On Wed, 2006-01-04 at 16:57 +0100, Joost van Baal wrote:
>
> > I'd like to document my patch for making Mailman OpenPGP and S/MIME
> > aware ( http://non-gnu.uvt.nl/pub/mailman/ ). I'd like this
> > documentation to integrate nicely with the official Mailman
> > documenation. What is the preferred format for creating documentation?
> >
> > I believe it's LaTeX. However, the sources for
> > mailman-{admin,install,member}.{ps,pdf,txt} are neither in
> > cvs/sf/mailman/mailman/admin/www nor in mailman-2.1.7.tgz . It'd help
> > me if these sources got published somewhere.
>
> LaTeX is the preferred format for the documentation source. We process
> our .tex files with the mkhowto program from the Python distribution.
> These rules apply for Mailman too:
>
> http://www.python.org/doc/current/doc/doc.html
>
> The source files are available in CVS, here:
>
> http://cvs.sourceforge.net/viewcvs.py/mailman/mailman/doc/?only_with_tag=Release_2_1-maint
Oops, of course. Apparently I got confused by the rsync calls in the
Makefile in admin/www, and stopped searching too early.
I'll start documenting my Secure List Server patch using this
framework (it's patch #1167696, BTW).
Bye,
Joost
--
Joost van Baal http://abramowitz.uvt.nl/
Tilburg University
j.e.vanbaal at uvt.nl The Netherlands
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 835 bytes
Desc: Digital signature
Url : http://mail.python.org/pipermail/mailman-developers/attachments/20060106/eba8e5c8/attachment.pgp
More information about the Mailman-Developers
mailing list