What's wrong with the perldocs

34
Perl docs {sux|rulez} brian d foy The Perl Review

description

How can the perl documentation be better?

Transcript of What's wrong with the perldocs

Page 1: What's wrong with the perldocs

Perl docs {sux|rulez}

brian d foyThe Perl Review

Page 2: What's wrong with the perldocs
Page 3: What's wrong with the perldocs
Page 4: What's wrong with the perldocs

Where do you find

variable scoping?(it’s not in perlvar)

Page 5: What's wrong with the perldocs

Where do you find

variable naming?(it’s not in perlvar)

Page 6: What's wrong with the perldocs

perldoc -f

perldoc -v

Page 7: What's wrong with the perldocs

operators?

methods?

switches?

Page 8: What's wrong with the perldocs
Page 9: What's wrong with the perldocs
Page 10: What's wrong with the perldocs
Page 11: What's wrong with the perldocs

ReferenceTutorials

Alternate TutorialsTopic Overviews

Quick StartsFAQ

Lingua

Page 12: What's wrong with the perldocs

perl perltoc perlartistic perlbookperlcommunity perldebug

perldoc perlgpl perlglossary perlhist perlintro

perlpolicy perlrepository perltodo perlutil

Page 13: What's wrong with the perldocs

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

Page 14: What's wrong with the perldocs

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

Page 15: What's wrong with the perldocs

perlapiperlapioperlcallperlclib

perlembedperlgutsperlhack

perlinternperliol

perlmroapiperlxs

perlxstut

Page 16: What's wrong with the perldocs

perlfaqperlfaq1perlfaq2perlfaq3perlfaq4perlfaq5perlfaq6perlfaq7perlfaq8perlfaq9

Page 17: What's wrong with the perldocs

perlbootperlbotperlmod

perlmodinstallperlmodlib

perlmodstyleperlnewmod

perlobjperltoocperltoot

Page 18: What's wrong with the perldocs

perlfaqperlfaq1perlfaq2perlfaq3perlfaq4perlfaq5perlfaq6perlfaq7perlfaq8perlfaq9

Page 19: What's wrong with the perldocs

perlreperlreapi

perlrebackslashperlrecharclass

perlrequickperlrerefperlretutperlreguts

Page 20: What's wrong with the perldocs

perldscperldebtutperlopentutperlpacktutperlreftutperlthrtut

Page 21: What's wrong with the perldocs

perlunicodeperlunifaq

perluniintroperluniprops

perlunitut

Page 22: What's wrong with the perldocs

perlcnperljpperlkoperltw

Page 23: What's wrong with the perldocs

perldata perldiag perldebguts perldbmfilter perlipc perllocale perlpod perlpodspec perllol perlnumber perlop

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

Page 24: What's wrong with the perldocs

now → ?

Page 25: What's wrong with the perldocs

perl is in git(perlrepository)

Page 26: What's wrong with the perldocs

I’m a committer

Page 27: What's wrong with the perldocs

Docs are for thecurrent version

Page 28: What's wrong with the perldocs

perlfaq back in perl

Page 29: What's wrong with the perldocs

books out of perlfaq2

into perlbook

Page 30: What's wrong with the perldocs

perlvar reordered,variable birth documented

Page 31: What's wrong with the perldocs

perlexperimentlists iffyfeatures

Page 32: What's wrong with the perldocs

a new perlop

Page 33: What's wrong with the perldocs

perlkeyword

Page 34: What's wrong with the perldocs

Other happenings

• “Perl Documentation Team”

• Updates to perlipc