[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