Hi Justin and all,

I vote for leaving it in the file It is part of the documentation, pod's are invented and used for reason, and people wanting to dig deeper into things need it

As an alternative, you can probably deliver a stripped version and the full version, call them Config-dist-short pm and Config-dist-long pm and have people copy either to Config pm

Personlly, I can't see why it should be difficult to wait with changing until one sees a =cut People obviously read the file and then spontaneously decide to change the file Difficult ? Yes ! Difficult people ! ;-)

On 23 Jul 2006 00:37:07 -0000 "Dada Mail (Justin Simoni)" dada@PROTECTED wrote:

Hey guys/gals, I have an idea, I thought I'd first ask you all for an
opinion about:

Currently, the Config pm file has embedded documentation, that gets
run through a translator, to make pretty HTML files like this:

http://mojo skazat com/support/documentation/Config pm html

Here's more information on how/what the embedded docs are/work:

http://www ayni com/perldoc/perl5 8 0/pod/perlpod html

Some people have voiced that the embedded documentation actually
makes reading the Config pm file harder, since it's difficult to
pick out sometimes, what variable it is you need to change, and what
is just the example of how you change the variable

It may be worth while to, before I distribute Dada Mail, strip out
this embedded documentation, to make the Config pm file a little less
busy I could leave small comments here and there to keep some sort
of organization in the file itself, but scrubbing everything else,
except the actual variables, could lead to a easier-to-configure
program

Any comments on this idea? If it's a horrible idea, please let me
know :)

Cheers, and thanks for all the comments on the boards and bugs file
recently,

-- Justin Simoni

: Dada Mail "Write Once - Distribute Everywhere" Email Communication
Software

url: http://mojo skazat com aolim: leaddadaist

--

Post: dadadev@PROTECTED

Unsubscribe: http://mojo skazat com/cgi-bin/dada/mail cgi/u/dadadev/

List Information: http://mojo skazat com/cgi-bin/dada/mail cgi/list/dadadev

Archive: http://mojo skazat com/cgi-bin/dada/mail cgi/archive/dadadev