-Subject: Developers' notes
-From: Thomas Roessler <roessler@guug.de>
-Date: Tue, 9 May 2000 19:48:08 +0200
-
-
Required tools
--------------
-If you are planning to hack on mutt-ng, please subscribe to the
-mutt-dev mailinglist (mutt-ng-deve-@lists.berlios.de).
+If you are planning to hack on Mutt-ng, please subscribe to the
+Mutt-ng-devel mailinglist (mutt-ng-deve-l@lists.berlios.de).
Announcements about recent development
versions go to that mailing list, as go technical discussions and
patches.
- GNU make may be needed for the dependency tricks
-Getting started from CVS
+Getting started from SVN
------------------------
-Once you've checked out a copy of the source from CVS, you'll need to
-run the script called 'prepare' that is in the root directory. The
-script does all the automake/autoconf magic that needs to be done with
-a fresh checkout.
+Once you've checked out a copy of the source from SVN from
+svn.berlios.de/svnroot/repos/mutt-ng , you'll need to run the script
+called 'prepare' that is in the root directory. The script does all the
+automake/autoconf magic that needs to be done with a fresh checkout. If
+all steps succeed, you'll have a configure script to start off with.
A word about warnings
---------------------
-Mutt's default build process sets some pretty restrictive compiler
+Mutt-ng's default build process sets some pretty restrictive compiler
flags which may lead to lots of warnings. Generally, warnings are
something which should be eliminated.
Nevertheless, the code in intl/ is said to generate some warnings with
the compiler settings we usually rely upon. This code is not
-maintained by the mutt-ng developpers, so please redirect any comments to
+maintained by the Mutt-ng developpers, so please redirect any comments to
the GNU gettext library's developpers.
- when adding new options, make the old behaviour the
default.
-- try to keep mutt-ng as portable as possible.
+- try to keep Mutt-ng as portable as possible.
+- do not use C++-style comments (i.e. "// Comment")
Documentation
-------------
Configuration _variables_ are documented directly in init.h. Note
that this includes documentation for possibly added format flags!
+When adding variables which depend on system-functionality and/or
+./configure switches, you have to add additional "availability"
+information to init.h to avoid confusion in the manual. Please see
+init.h for examples.
+
The parts of The Manual and the muttngrc manual page dealing with
these variables, and the global Muttrc, are generated automatically
from that documentation. To start this process, type "make
- \fB switches to boldface
+ - \fT switches to typewriter (only for SGML and ignored otherwise)
+
- \fP switches to normal display
- \(as can be used to represent an asterisk (*). This is intended
This is used to protect indentations in tables.
Do _not_ use any other SGML or nroff formatting instructions here!
-
-$Id: devel-notes.txt,v 3.0 2002/01/24 13:35:07 roessler Exp $