Skip to Content.
Sympa Menu

devel - Re: [sympa-developpers] [sympa-commits] sympa[10690] branches/sympa-6.2-branch/src/lib/Makefile.am: [-feature] Add section 3 manual pages generated from PODs in some modules.

Subject: Developers of Sympa

List archive

Chronological Thread  
  • From: IKEDA Soji <address@concealed>
  • To: address@concealed
  • Subject: Re: [sympa-developpers] [sympa-commits] sympa[10690] branches/sympa-6.2-branch/src/lib/Makefile.am: [-feature] Add section 3 manual pages generated from PODs in some modules.
  • Date: Thu, 29 May 2014 01:20:47 +0900

On Wed, 28 May 2014 13:46:07 +0200
Guillaume Rousse <address@concealed> wrote:

> Le 22/05/2014 10:55, address@concealed a écrit :
> > Revision
> > 10690
> > Author
> > sikeda
> > Date
> > 2014-05-22 10:55:06 +0200 (jeu. 22 mai 2014)
> >
> >
> > Log Message
> >
> > [-feature] Add section 3 manual pages generated from PODs in some modules.
> > Section is (3Sympa) to avoid conflict with other softwares.
> >
> > Anyway, precise documentation is encouraged.
> 99% of sympa users won't care about sympa implementation documentation
> (which is what is actually covered by those man pages), and the
> remaining is either already subscribed to this list, or able to read
> them directly with 'perldoc' command, or from sources, so why install them ?
>
> Especially if this requires so much additional Makefile code and
> inventing a new man page section... The added value/cost ratio is
> definitevely not worth the interest here.

Updated documentation of Sympa API will be alternative to fossilized
ones recently found by Google etc.

I hardly can find another meaning.

Regards.

--- Soji


--
株式会社 コンバージョン セキュリティ&OSSソリューション部 池田荘児
〒231-0004 神奈川県横浜市中区元浜町3-21-2 ヘリオス関内ビル7F
e-mail address@concealed TEL 045-640-3550
http://www.conversion.co.jp/




Archive powered by MHonArc 2.6.19+.

Top of Page