Re: Secret operators: the documentation

On Mon, Apr 02, 2012 at 06:28:56PM +0200, Alexis Sukrieh wrote:
> Le 16 mars 2012 12:44, Philippe Bruhat (BooK)
> <[email protected]> a =E9crit :
> > So,
> >
> > A few years back, I started to write a manual page about Perl secret =
operators,
> > with the goal of getting it into the official Perl documentation at s=
ome point.
> [...]
> > Patches welcome.
> >
> > When it's stabilized enough, I'll send a patch to p5p.
>=20
> Nice work :)
>=20
> I have a question though;
>=20
> Did you change your mind about the "A word of warning" section? It
> sounds that it won't fit well in the official Perl documentation ;)
>=20

I've pushed a branch on the Perl source tree, and Abigail already
patched the module a bit.
http://perl5.git.perl.org/perl.git/shortlog/refs/heads/book/perlsecret

The "word of warning" still holds. The page is specifically not listed
in the main perl.pod manual page. The idea is to hide it a little, so tha=
t
people who know about it can easily point inquiring minds to it, while no=
t
making these "official".

I also wrote a test script (t/japh/secret.t) and it helped a lot in refin=
ing
exactly how and when each of those worked.

--=20
 Philippe Bruhat (BooK)

 "Did I err?"      (Groo, in too many issues to count - ...and *YES* he d=
id!)