Debian Bug report logs - #178583
wwwconfig-common: No documentation available

Full log

Message #35 received at [email protected] (full text, mbox, reply):

Received: (at 178583) by bugs.debian.org; 22 Jul 2003 12:21:35 +0000
From [email protected] Tue Jul 22 07:21:32 2003
Return-path: <[email protected]>
Received: from n02p127.netcamp.se (chrystal.opal.dhs.org) [62.119.125.127] 
	by master.debian.org with esmtp (Exim 3.35 1 (Debian))
	id 19ew95-0006OZ-00; Tue, 22 Jul 2003 07:21:32 -0500
Received: from ola by chrystal.opal.dhs.org with local (Exim 3.35 #1 (Debian))
	id 19ew94-0001Oo-00; Tue, 22 Jul 2003 14:21:30 +0200
Date: Tue, 22 Jul 2003 14:21:30 +0200
From: Ola Lundqvist <[email protected]>
To: Matthew Palmer <[email protected]>
Cc: [email protected]
Subject: Re: Bug#178583: Documentation (partial) written
Message-ID: <[email protected]>
Reply-To: [email protected]
References: <[email protected]> <[email protected]> <[email protected]>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <[email protected]>
User-Agent: Mutt/1.3.28i
Sender: Ola Lundqvist <[email protected]>
Delivered-To: [email protected]
X-Spam-Status: No, hits=-16.1 required=4.0
	tests=BAYES_01,EMAIL_ATTRIBUTION,IN_REP_TO,QUOTED_EMAIL_TEXT,
	      QUOTE_TWICE_1,REFERENCES,REPLY_WITH_QUOTES,USER_AGENT_MUTT
	autolearn=ham version=2.53-bugs.debian.org_2003_07_20
X-Spam-Level: 
X-Spam-Checker-Version: SpamAssassin 2.53-bugs.debian.org_2003_07_20 (1.174.2.15-2003-03-30-exp)

Hello

On Tue, Jul 22, 2003 at 06:56:32PM +1000, Matthew Palmer wrote:
> On Tue, Jul 22, 2003 at 09:57:37AM +0200, Ola Lundqvist wrote:
> > On Tue, Jul 22, 2003 at 11:43:07AM +1000, Matthew Palmer wrote:
> > > I've written an overview manpage for wwwconfig-common, along with the
> > > necessary rules info to include it in the built package.  I've included the
> > > complete patch, relative to 0.0.27.
> > > 
> > > In future, any manpages which are written for specific commands (and I think
> > > that most, if not all of them, need one, as well as an expansion of the best
> > > usage of the package as a whole), merely need to be put in the manpages
> > > directory, and everything will be taken care of automagically.
> > 
> > Did you write the manpage from scratch or did you use a tool to create it?
> 
> I took the debhelper(7) manpage off my system, and then edited it to fit.

Ok. It might be better to write it in docbook or something that I can
manage without a bigger problem. On the other hand it is a lot better with
a manpage than without one. :) Thanks again.

> > I'm not very good at raw manpage format. :)
> 
> I used to hack raw troff some years back, but haven't in ages (LaTeX is my
> format these days).  I can't remember too much of the stuff, I just took the
> macros that were there already, and duplicated as necessary...

Ok.

> > I'll add this but modify the build things slightly.
> 
> Mmmkay.  As long as I can type 'man wwwconfig-common', I'll be happy.

:)

> I'll probably write specific man pages for the commands I use as I get used
> to using them, I'll submit them as wishlist bugs as I write them.  But I
> think it's important to have an overview page for reference.

That would be really great.

> > I also think about making wwwconfig-common more general in that you can
> > configure more things than web-related things. What do you think about
> > such an idea?
> 
> Hmm, how general were you planning on going?  I think there has to be a
> limit to how broad wwwconfig-common should go, but there is more stuff that
> could go in, I'm sure.

I'm planning on a generic interface for configuring other packages.
Of course it has to be renamed then. wwwconfig-common is basically
just an interface on how to configure exim, mysql, postgres,
php and apache. This should be possible to generalize.

Regards,

// Ola

> - Matt

-- 
 --------------------- Ola Lundqvist ---------------------------
/  [email protected]                     Annebergsslingan 37      \
|  [email protected]                 654 65 KARLSTAD          |
|  +46 (0)54-10 14 30                  +46 (0)70-332 1551       |
|  http://www.opal.dhs.org             UIN/icq: 4912500         |
\  gpg/f.p.: 7090 A92B 18FE 7994 0C36  4FE4 18A1 B1CF 0FE5 3DD9 /
 ---------------------------------------------------------------

Send a report that this bug log contains spam.