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