What's wrong with the perldocs

Post on 18-Nov-2014

1.528 views 0 download

description

How can the perl documentation be better?

Transcript of What's wrong with the perldocs

Perl docs {sux|rulez}

brian d foyThe Perl Review

Where do you find

variable scoping?(it’s not in perlvar)

Where do you find

variable naming?(it’s not in perlvar)

perldoc -f

perldoc -v

operators?

methods?

switches?

ReferenceTutorials

Alternate TutorialsTopic Overviews

Quick StartsFAQ

Lingua

perl perltoc perlartistic perlbookperlcommunity perldebug

perldoc perlgpl perlglossary perlhist perlintro

perlpolicy perlrepository perltodo perlutil

perl5004delta perl5005delta perl5100delta perl5101delta perl5110delta perl5111delta perl5112delta perl5113delta perl5114delta perl5115delta perl5120delta perl5121delta perl5122delta perl5130delta perl5131delta perl5132delta perl5133delta perl5134delta perl5135delta perl5136delta

perl561delta perl56delta perl570delta perl571delta

perldelta perl572delta perl573delta perl581delta perl582delta perl583delta perl584delta perl585delta perl586delta perl587delta perl588delta perl589delta perl58delta perl590delta perl591delta perl592delta perl593delta

perl594delta perl595delta

perlaix perlamiga perlapollo perlbeos perlbs2000 perlce perlcygwin perldgux perldos perlebcdic perlepoc

perlfreebsd perlhaiku perlhpux perlhurd perlirix perllinux perlmacos perlmacosx perlmpeix perlnetware perlopenbsd perlos2 perlos390 perlos400 perlplan9 perlqnx perlriscos

perlsolaris perlsymbian perltru64 perluts perlvmesa perlvms perlvos

perlapiperlapioperlcallperlclib

perlembedperlgutsperlhack

perlinternperliol

perlmroapiperlxs

perlxstut

perlfaqperlfaq1perlfaq2perlfaq3perlfaq4perlfaq5perlfaq6perlfaq7perlfaq8perlfaq9

perlbootperlbotperlmod

perlmodinstallperlmodlib

perlmodstyleperlnewmod

perlobjperltoocperltoot

perlfaqperlfaq1perlfaq2perlfaq3perlfaq4perlfaq5perlfaq6perlfaq7perlfaq8perlfaq9

perlreperlreapi

perlrebackslashperlrecharclass

perlrequickperlrerefperlretutperlreguts

perldscperldebtutperlopentutperlpacktutperlreftutperlthrtut

perlunicodeperlunifaq

perluniintroperluniprops

perlunitut

perlcnperljpperlkoperltw

perldata perldiag perldebguts perldbmfilter perlipc perllocale perlpod perlpodspec perllol perlnumber perlop

perlfilter perlfork perlform perlfunc perllexwarn perlpragma perlref perlrun perlsub perlsyn perltie perlvar

now → ?

perl is in git(perlrepository)

I’m a committer

Docs are for thecurrent version

perlfaq back in perl

books out of perlfaq2

into perlbook

perlvar reordered,variable birth documented

perlexperimentlists iffyfeatures

a new perlop

perlkeyword

Other happenings

• “Perl Documentation Team”

• Updates to perlipc