Neohapsis is currently accepting applications for employment. For more information, please visit our website www.neohapsis.com or email firstname.lastname@example.org
From: /dev/rob0 (rob0gmx.co.uk)
Date: Thu Jun 24 2010 - 14:30:39 CDT
On Thu, Jun 24, 2010 at 09:39:05AM -0700, Quanah Gibson-Mount wrote:
> --On Wednesday, June 23, 2010 5:28 PM -0400 Victor Duchovni
> <Victor.Duchovnimorganstanley.com> wrote:
>> BACKWARDS COMPATIBILITY
>> For backwards compatibility with Postfix version 2.0 and
> So you leave your online documentation using the syntax of a
> release that is 6 years old? That seems fairly odd. Why not use
> versioned documentation?
> Just as an example, OpenLDAP has:
> This way people who want the official documentation for
> OpenLDAP 2.0 through 2.4 can get at those, even if they are
> no longer maintained.
> Same for the online manual pages, where you can pull them down
> for everything from OpenLDAP 1.0 onwards.
> In this way, people are able to get the information that is most
> relevant to their setup, and not get hit with examples that are
> half a decade out of date.
I generally recommend that people consult their own documentation in
their local $html_directory. This helps avoid the confusion which
comes with future features and syntax.
Note that versioned documentation for Postfix is always readily
available, even if not easily found via WWW. All you have to do is
get the source tarball for your Postfix release.
Simiarly it would be trivial for Wietse to put these online at
www.postfix.org under version directories like OpenLDAP's, but I'm
pretty sure he will not want to do this. The goal in Postfix is for
man pages and READMEs to be relevant for any version, except as may
be noted in the document, such as in MILTER_README and DSN_README
(those features were both added with Postfix 2.3)
Another drawback to having versioned documentation online is that El
Goog is as likely to find the wrong version of a document. If a
seeker ends up at http://www.postfix.org/documentation.html , all's
well, but not necessarily so if they find someone's old, non-updated
Offlist mail to this address is discarded unless
"/dev/rob0" or "not-spam" is in Subject: header