Questions about Perl and doc

[Russ Allbery]

Julien ÉLIE <julien at trigofacile.com> writes:

> I have three little questions which puzzle me:

> * why are there in mod-active the following two consecutive lines?

>     $oldact = $inn::active;         # active file location
>     $oldact = $inn::active;         # active file location (same; shut up, perl -w)

> I do not understand why -- perhaps an issue with antediluvian Perl
> versions?!?

When you run perl with -w, it warns about variables used only once.  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.

> * what are in some Perl scripts lines like these ones for?

>     # lint food
>     print $inn::pathrun.$inn::pathlog.$inn::pathetc.$inn::newsbin;

Same problem.

> * 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.

Likewise, it probably wouldn't be a bad idea to install the INSTALL
document as an inn man page in some section.

>   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.

-- 
Russ Allbery (rra at stanford.edu)             <http://www.eyrie.org/~eagle/>

    Please send questions to the list rather than mailing me directly.
     <http://www.eyrie.org/~eagle/faqs/questions.html> explains why.