Re: [Mageia-dev] Suggest summary documentation of Mageia perl routines

2011-08-24 Thread Eugeni Dodonov
On Wed, Aug 24, 2011 at 04:24, Buchan Milne bgmi...@staff.telkomsa.netwrote: Of course, it might also be an idea to refactor libDrakX (use a unique namespace etc.). This decade-old task still awaits the lost^w brave souls to take it :) -- Eugeni Dodonov http://eugeni.dodonov.net/

Re: [Mageia-dev] Suggest summary documentation of Mageia perl routines

2011-08-24 Thread Thierry Vignaud
On 24 August 2011 08:31, andre999 and...@laposte.net wrote: Which one jquelin is reffering to? none. i'm maintaining perl  perl modules for mageia, but am not a drak* contributor. OK, I was mistaken by a post by jquelin reminded me of something that would be nice to see my fault ... a

Re: [Mageia-dev] Suggest summary documentation of Mageia perl routines

2011-08-24 Thread D.Morgan
On Wed, Aug 24, 2011 at 1:28 PM, Thierry Vignaud thierry.vign...@gmail.com wrote: On 24 August 2011 08:31, andre999 and...@laposte.net wrote: Which one jquelin is reffering to? none. i'm maintaining perl  perl modules for mageia, but am not a drak* contributor. OK, I was mistaken by a post

Re: [Mageia-dev] Suggest summary documentation of Mageia perl routines

2011-08-24 Thread Guillaume Rousse
On 24/08/2011 13:28, Thierry Vignaud wrote: at mga as well as set up perl_checker mails again in order to auto catch bugs) perl_checker doesn't catch bugs, but violations to an hard-coded coding style policy, which is quite different... -- BOFH excuse #174: Backbone adjustment

Re: [Mageia-dev] Suggest summary documentation of Mageia perl routines

2011-08-24 Thread Thierry Vignaud
On 24 August 2011 14:05, Guillaume Rousse guillomovi...@gmail.com wrote: at mga as well as set up perl_checker mails again in order to auto catch bugs) perl_checker doesn't catch bugs, but violations to an hard-coded coding style policy, which is quite different... Please only speak about

Re: [Mageia-dev] Suggest summary documentation of Mageia perl routines

2011-08-23 Thread Guillaume Rousse
On 23/08/2011 00:02, andre999 wrote: I'm talking about a concise programmer's guide, and not something suitable for end-users. And not something describing the perl language itself, for which there are plenty of references. That's been asked for for just 10 years now. As long as no one

Re: [Mageia-dev] Suggest summary documentation of Mageia perl routines

2011-08-23 Thread Thierry Vignaud
On 23 August 2011 09:34, Guillaume Rousse guillomovi...@gmail.com wrote: I'm talking about a concise programmer's guide, and not something suitable for end-users. And not something describing the perl language itself, for which there are plenty of references. That's been asked for for just 10

Re: [Mageia-dev] Suggest summary documentation of Mageia perl routines

2011-08-23 Thread Jerome Quelin
On 11/08/23 15:40 +0200, Thierry Vignaud wrote: Which one jquelin is reffering to? none. i'm maintaining perl perl modules for mageia, but am not a drak* contributor. jérôme

[Mageia-dev] Suggest summary documentation of Mageia perl routines

2011-08-22 Thread andre999
A post by jquelin reminded me of something that would be nice to see, for potential contributors to Mageia code (like myself). It would be useful to have brief documentation for Mageia perl routines, which would describe the inputs required (function, range of values, etc) and the purpose of

Re: [Mageia-dev] Suggest summary documentation of Mageia perl routines

2011-08-22 Thread Bruno Cornec
andre999 said on Mon, Aug 22, 2011 at 06:02:35PM -0400: It would be useful to have brief documentation for Mageia perl routines, which would describe the inputs required (function, range of values, etc) and the purpose of each routine. Why not use just pod ? That way doc and code could easily