Re: Idea: Take out the Config.pm embedded documentation

 
From: "Mariano Absatz" <el.baby@PROTECTED>
In-Reply-To: Re: Idea: Take out the Config.pm embedded documentation
Date: August 2nd 2006
I'm totally for *keeping* the pod in... everything Andreas Grau said in his first post makes sense to me... even when you may be too lazy to learn to write pod, learning to read it is quite simple... if you use a perl-aware editor, it will even colorize it as comments.

Lynton's idea would be very annoying for those of us using simple text editors to modify Config.pm... if you're editing it remotely, you might have a hard time following a hyperlink in a text-only environment...

I don't mind having 2 or 3 Config-xxx.pm templates and choosing from them, but you (Justin) will have to keep them quite in-sync... probably with only one source generating all templates like:

Config-source.pm

might have pod *and* simple comments embedded (maybe with a small mark to ease the task of generating the other ones), and then a script would generate:

Config-pod.pm
Config-comments.pm
Config-linked.pm

and you would include instructions to choose one of these files and rename it as Config.pm before configuring it.

Just my 2c.

--
Mariano Absatz - El Baby
el (dot) baby (AT) gmail (dot) com
el (punto) baby (ARROBA:@) gmail (punto) com

Post:
mailto:dadadev@PROTECTED

Unsubscribe:
http://mojo.skazat.com/cgi-bin/dada/mail.cgi/u/[list]/

List Information:
http://mojo.skazat.com/cgi-bin/dada/mail.cgi/list/[list]

Archive:
http://mojo.skazat.com/cgi-bin/dada/mail.cgi/archive/[list]

rss/atom
‹ Beta 10.9.10 Beta 1
Index
Re: RFC: copying settings from one list to another - how should it be done? ›
  • This mailing list is a public mailing list - anyone may join or leave, at any time.
  • This mailing list is a group discussion list (unmoderated)

  • Start a new thread, email: dadadev@dadamailproject.com

This is the developer discussion mailing list for Dada Mail.

If you are just looking for support Dada Mail, consult the message boards at:

https://forum.dadamailproject.com

Documentation for Dada Mail:

https://dadamailproject.com/d

Specifically, see the Error FAQ:

https://dadamailproject.com/d/FAQ-errors.pod.html

To post to this list, send a message to:

mailto:dadadev@dadamailproject.com

All subscribers of this list may post to the list itself.

Topics that are welcome:

  • Constructive critiques on the program (I like, "x", but, "y" needs some work - here's an idea on how to make this better...)
  • Bug/Error reports
  • Bug fixes
  • Request For Comments on any changes to the program
  • Help customizing Dada Mail for your own needs
  • Patches
  • Language Translations
  • Support Documentation/Doc editing, FAQ's, etc.
  • Discussion of any changes that you would like to be committed to the next version of Dada Mail -

Dada Mail is on Github:

https://github.com/justingit/dada-mail/

If you would like to fork, branch, send over PRs, open up issues, etc.

Privacy Policy:

This Privacy Policy is for this mailing list, and this mailing list only.

Email addresses collection through this mailing list are used explicitly to work within this email discussion list.

We only collect email addresses through our Closed-Loop Opt-In system.

We don't use your email address for any other purpose.

We won't be sharing your email address with any other entity.

Unsubscription can be done at any time. Please contact us at: justin@dadamailproject.com for any help regarding your subscription, including removal from the mailing list.

All mailing list messages sent from us will include a subscription removal link, which will allow you to remove yourself from this mailing list automatically, and permanently.

All consent to use your email address for any other purpose stated at the time of the mailing list subscription will also be revoked upon mailing list removal.