Questions about Perl and doc
Julien ÉLIE
julien at trigofacile.com
Wed Sep 5 18:55:23 UTC 2007
En réponse à Russ Allbery :
>> $oldact = $inn::active; # active file location
>> $oldact = $inn::active; # active file location (same; shut up, perl -w)
>
> When you run perl with -w, it warns about variables used only once.
All right. I haven't thought about the use of $inn::active (I thought the comment
was refering to $oldact).
And I now understand the "lint food" part. Thanks! It has been titillating my mind
for months!
> This would go away if we replaced innshellvars.pl with a real Perl module that
> declares and exports its variables properly, something I was hoping to do
> eventually.
That is to say innshellvars.pm which defines 'package inn' and only exports
variables with EXPORT_OK (so as not to pollute the namespace)?
And then fixscript would put:
use lib '@libdir@';
use innshellvars;
>> * why are hook-perl and hook-python only available in text format in
>> doc/? wouldn't it be useful to also [or only?] have them in man format
>> in doc/man? Indeed, there is no "man filter_innd" or "man filter_nnrpd"
>> for quick reference...
>
> Yeah, that's probably not a bad idea. I just wasn't thinking about that
> when I wrote it.
It would need a little rewrite to split filter_innd and filter_nnrpd.
And maybe also nnrpd_access and nnrpd_auth.
Besides, it would make it simpler since there are similar behaviours
regarding Perl and Python implementations. A possibility would be
a general introduction for each file, then a part for what is specific
to Perl (with examples) and another part for Python (with examples).
> Likewise, it probably wouldn't be a bad idea to install the INSTALL
> document as an inn man page in some section.
Which name (and number) for the man page?
What for the checklist?
>> And by the way, is it OK if I add symbolinc links (like actsyncd(8) ->
>> actsync(8)) for nocem.ctl(5) -> perl-nocem(8) and localgroups(5) ->
>> docheckgroups(8)?
>
> Yes, please do. That's a great idea.
I shall have a look at that soon.
--
Julien ÉLIE
« Si bene commemini, causae sunt quinque bibendi :
Hospitis aduentus, praesens sitis atque futura,
Et uini bonitas, et quaelibet altera causa. »
More information about the inn-workers
mailing list