Bug#543293: Poor quality of documentation in /usr/share/doc/cyrus-common-2.2/README.Debian.database.gz

[Henrique de Moraes Holschuh]

On Mon, 24 Aug 2009, Alejandro Forero Cuervo wrote:
> Very poor quality of documentation in
> /usr/share/doc/cyrus-common-2.2/README.Debian.database.gz.
> 
> It includes completely irrelevant things such as what are the type of
> people that the maintainer likes or dislikes, leaving one with the
> impression that he's rather arrogant: he seems to think he's better than

That text was written in 2002...  Heck, I can't even recall properly
anymore what got me so pissed off to the point of writing that stuff.

I fully agree it is way past time to remove that stupid rant (and I can
certainly agree that it shouldn't have been written in the first place,
for which I can only apologise).  I had completely forgotten all about
it.

I can say in my defense that arrogance had little to do with it, though.
It is no excuse, but I can assure you my main beef at the time was with
people who I perceived to only take, never giving anything back.  I
think someone let it show that as far as he was concerned, I owned him
to walk him through and fix his cyrus install because clearly my time
was not as important and valuable as his or something to that sort, and
it pushed exactly the wrong buttons.

>    If the BerkeleyDB version is what was changed, you need to use the
>    Berkeley DB upgrade utility in all db* databases.  See the manpages
>    for db*_upgrade. Note that you need to use the db*_upgrade utility
>    with the same version as given on the DBENGINE line of
>    cyrus-db-types.txt.

For all I know, given the right conditions, BDB does it by itself
nowadays.  That text was written for BDB 3.2, which is *ancient* :)

> what the documentation was created to help you achieve.  I would suggest
> that, after removing the aforementioned irrelevant paragraph (about how
> the maintainer is ???quite short on time lately???), a mention of dbX-util
> is added, along the lines of:

That "quite short on time" proved to be prophetic.  Thankfully, others
stepped up to maintain cyrus, but the entire team is somewhat "quite
short on time".  Maybe that text is a curse on the cyrus-imap packages,
we really ought to remove it ASAP :)

Thank you for your suggestions, as far as I am concerned, they're
accepted.

-- 
  "One disk to rule them all, One disk to find them. One disk to bring
  them all and in the darkness grind them. In the Land of Redmond
  where the shadows lie." -- The Silicon Valley Tarot
  Henrique Holschuh