Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 48053 - mini-qmail typo, bad hints, no documentation
Summary: mini-qmail typo, bad hints, no documentation
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: x86 Linux
: High normal (vote)
Assignee: SpanKY
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2004-04-16 10:18 UTC by caspar-gentoo-bugs
Modified: 2004-05-07 05:58 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments
manpage qmail-config-mini (qmail-config-mini.8.gz,791 bytes, application/x-tar)
2004-04-17 07:05 UTC, caspar-gentoo-bugs
Details

Note You need to log in before you can comment on or make changes to this bug.
Description caspar-gentoo-bugs 2004-04-16 10:18:52 UTC
1. in the ebuild it tells to set up some QMTP server information.  It should say QMQP.
2. to tell "just run /var/mini-qmail/bin/config-mini for more information" is far from sufficient, for it gives:

  config-mini: usage: config-mini me defaultdom plusdom idhost qmqpserver ...

what is meant by these parameters?  A look into config-mini doesn't help.

From servers /var/qmail/control directory:
me: FQDN of qmail server, called "me"
defaultdom: default domain name to expand hostnames,
   called "defaultdomain"
plusdom: domain name to expand hostnames ending with
   plus sign, called "plusdomain"

Individually for each client machine:
idhost: hostname of machine where mini-qmail gets installed,
   normally copy of /etc/hostname
qmqpserver: server(s) to send mails to, one IP number per line

Even reading the normal qmail man pages wouldn't give this information

3. There is no documentation.  The normal qmail man pages aren't sufficient for they don't tell how to translate local server data to remote client data

4. There is no reason to change the path from /var/qmail/ to /var/mini-qmail.  Mini-qmail is nothing but a stripped down installation of qmail.

Reproducible: Always
Steps to Reproduce:
Install mini-qmail
Actual Results:  
installed mini-qmail in /var/mini-qmail/
useless instructions how to set up mini-qmail

Expected Results:  
installed mini-qmail in /var/qmail
sufficient instructions how to set up mini-qmail
Comment 1 caspar-gentoo-bugs 2004-04-17 07:02:51 UTC
Hi,

I checked the DJB mini-qmail page -- it's three totally different setups and only nullclient is covered by mini-qmail.

I suggest the following approach:

1. I prepared a manpage for nullclient.  It's my first one so don't expect too much, take it as a starting point :-))

2. Change the ebuilds' text to reflect the existance of the man page


bye

caspar
Comment 2 caspar-gentoo-bugs 2004-04-17 07:05:57 UTC
Created attachment 29489 [details]
manpage qmail-config-mini
Comment 3 Robin Johnson archtester Gentoo Infrastructure gentoo-dev Security 2004-04-24 01:03:43 UTC
vapier: mini-qmail is your baby.
Comment 4 SpanKY gentoo-dev 2004-04-24 01:12:52 UTC
1. fixed the typo
2. how about i just put into the einfo 'go read http://cr.yp.to/qmail/mini.html' ?
3. see #2 ... some app manpages still do apply
4. the 'standard' for mini-qmail is to use /var/mini-qmail.  i'm not going to change that.
Comment 5 caspar-gentoo-bugs 2004-04-24 14:09:22 UTC
2. IMO insufficient.  This mini-qmail is only a subset of those setups DJB describes on his page and the config script isn't described at all.  To give the djb web page as guide would render this package useless.

3. Some man pages do apply, others are not helpful for one needs the DJB page.  I personally think DJB should have created a separate man page for those setups as well.

4. Where is /var/mini-qmail described as standard?  DJB defines /var/mini-qmail only for the mailing list setup which this mini-qmail doesn't provide.


caspar
Comment 6 SpanKY gentoo-dev 2004-05-05 20:29:53 UTC
2. updated the postinst message and config-mini script to give a bit more info

3. list specific issues with the manpages or ill just leave them as is

4. /var/mini-qmail is going to be used and that wont be changing
Comment 7 caspar-gentoo-bugs 2004-05-07 01:09:47 UTC
1. That's great.  I have one small suggestion though -- it's the IP numbers of qmqpservers

2. I thought of creating (a) man page(s) myself to reflect mini qmail.  When they are ready I will send them to you.  But that isn't very important and your documentation doesn't need it.

3. ok :-))


thank you and bye

caspar
Comment 8 SpanKY gentoo-dev 2004-05-07 05:58:27 UTC
updated the patch to say ip addresses

i guess once you have manpages/patches, just post them here and re-open the bug