Documentation [Was Shared mailboxes doc]

[Adam Tauno Williams]

On Fri, 2011-01-07 at 17:45 +0000, Jeroen van Meeuwen (Kolab Systems)
wrote:
> Dan White wrote:
> >>I have a git repository at:
> > > http://git.cyrusimap.org/cyrus-imapd-docs/
> > >and some output I regulary generate on:
> >>http://www.cyrusimap.org/~vanmeeuwen/cyrus-imapd-2.4-docs/
> > >Really, at this point, *any* feedback is most appreciated ;-))
> > What are your plans with this documentation? Are you intending to
> use this
> > build system to generate the contents of the /doc documentation?
> Assuming I'm understanding the question correctly;
> Ny intention is to make it easier to provide *more* content then is
> suitable for a man-page, or the doc/ directory, in a way that enables
> us to spit out the documentation in different formats, versioned and
> all.

I added the following regarding the condstore annotation to my WMOGAG
Cyrus section:

<QUOTE>
This annotation is only supported in the 2.3.x release series starting
with 2.3.3 although its use is not recommended until 2.3.8. As of the
2.4.x release series CONDSTORE functionality is enabled on all mailboxes
regardless of annotation and attempting to set this annotation will
result in a permission denied message. On releases where this annotation
is supported setting a value of “true” will enable CONDSTORE
functionality [1].

[footnote:1] The CONDSTORE functionality is defined in RFC4551,
http://tools.ietf.org/html/rfc4551
</QUOTE>

It might be nice to have that in the 'official' (?) documentation.

I put this in the Administration/cyradm/mboxcfg section where the useful
annotations are listed.

jmeeuwen: If I create a documentation section or update something do you
want me to ping you via private e-mail, on the -devel list, or
not-at-all?