--- perlmodstyle.pod Sat Mar 18 02:07:51 2006 +++ perlmodstyle.indexed.pod Sat Mar 18 02:19:18 2006 @@ -5,2 +5,3 @@ =head1 INTRODUCTION +X<Perl style, module, introduction> @@ -168,2 +169,4 @@ =head1 BEFORE YOU START WRITING A MODULE +X<Perl style, module, planning> +X<Perl style, module, before start> @@ -212,2 +215,3 @@ =head2 What's in a name? +X<Perl style, module, naming guideline> @@ -247,2 +251,3 @@ =head1 DESIGNING AND WRITING YOUR MODULE +X<Perl style, module, design> @@ -251,2 +256,4 @@ =head2 To OO or not to OO? +X<Perl style, module, object oriented design> +X<Perl style, module, object-oriented design> @@ -313,2 +320,4 @@ =head2 Designing your API +X<Perl style, module, API design> +X<Perl style, API design> @@ -351,2 +360,4 @@ =item Naming conventions +X<Perl style, naming guideline> +X<Perl style, naming convention> @@ -415,2 +426,3 @@ =head2 Backwards compatibility +X<Perl style, module, backwards compatibility> @@ -421,2 +433,4 @@ =head2 Error handling and messages +X<Perl style, error handling> +X<Perl style, error message> @@ -462,2 +476,3 @@ =head1 DOCUMENTING YOUR MODULE +X<Perl style, module, documentation> @@ -598,4 +613,9 @@ =head1 RELEASE CONSIDERATIONS +X<Perl style, release consideration> +X<Perl style, packaging> +X<Perl style, release package> =head2 Version numbering +X<Perl style, module, versioning> +X<Perl style, module, version number guideline> @@ -710,2 +730,3 @@ =head1 COMMON PITFALLS +X<Perl style, common problem>
--- perlfaq1.pod Sat Mar 18 01:04:45 2006 +++ perlfaq1.indexed.pod Sat Mar 18 01:02:52 2006 @@ -153,2 +153,3 @@ =head2 What is Ponie? +X<Ponie> @@ -285,2 +286,4 @@ =head2 What's the difference between "perl" and "Perl"? +X<Perl, name of language> +X<Perl, name of interpreter> @@ -329,2 +332,4 @@ =head2 What is a JAPH? +X<JAPH> +X<Just Another Perl Hacker>
--- perlfaq2.pod Sat Mar 18 01:05:22 2006 +++ perlfaq2.indexed.pod Sat Mar 18 01:13:40 2006 @@ -11,2 +11,6 @@ =head2 What machines support perl? Where do I get it? +X<supported platform> +X<supported hardware> +X<supported operating system> +X<supported OS> @@ -91,2 +95,6 @@ =head2 What modules and extensions are available for Perl? What is CPAN? What does CPAN/src/... mean? +X<CPAN> +X<Comprehensive Perl Archive Network> +X<Perl module library> +X<Perl module repository> @@ -169,2 +177,3 @@ =head2 What are the Perl newsgroups on Usenet? Where do I post questions? +X<Perl newsgroups> @@ -216,2 +225,16 @@ =head2 Perl Books +X<Perl book> +X<Camel book> +X<Perl book, Programming Perl> +X<Llama book> +X<Perl book, Learning Perl> +X<Ram book> +X<Perl book, Perl Cookbook> +X<Alpaca book> +X<Perl book, Learning Perl Objects, References, and Modules> +X<Perl book, Perl: The Programmer's Companion> +X<Gecko book> +X<Perl book, Learning Perl on Win32 Systems> +X<Perl book, Object Oriented Programming with Perl> +X<Perl book, Network Programming with Perl> @@ -407,2 +430,5 @@ =head2 Which magazines have Perl content? +X<Perl periodical> +X<Perl periodical, The Perl Journal> +X<Perl periodical, The Perl Review> @@ -430,2 +456,3 @@ =head2 What mailing lists are there for Perl? +X<Perl mailing list> @@ -473,2 +500,6 @@ =head2 Where do I send bug reports? +X<Perl bug report> +X<reporting bug> +X<bug reporting> +X<submit bug report>
--- perlfaq3.pod Sat Mar 18 01:14:39 2006 +++ perlfaq3.indexed.pod Sat Mar 18 01:26:48 2006 @@ -43,2 +43,3 @@ =head2 Is there a Perl shell? +X<Perl shell> @@ -62,2 +63,3 @@ =head2 How do I find which modules are installed on my system? +X<Perl module, installed module> @@ -111,2 +113,4 @@ =head2 How do I debug my Perl programs? +X<debug> +X<debugging> @@ -149,2 +153,4 @@ =head2 How do I profile my Perl programs? +X<profile> +X<profiling> @@ -191,2 +197,5 @@ =head2 Is there a pretty-printer (formatter) for Perl? +X<pretty print> +X<pretty-print> +X<reformatting source> @@ -229,2 +238,4 @@ =head2 Is there an IDE or Windows Perl Editor? +X<IDE> +X<Integrated Development Environment> @@ -242,2 +253,4 @@ =item Eclipse +X<IDE, Eclipse> +X<Integrated Development Environment, Eclipse> @@ -249,2 +262,6 @@ =item Enginsite +X<IDE, Perl Editor> +X<Integrated Development Environment, Perl Editor> +X<IDE, EngInSite> +X<Integrated Development Environment, EngInSite> @@ -257,2 +274,4 @@ =item Komodo +X<IDE, Komodo> +X<Integrated Development Environment, Komodo> @@ -265,2 +284,4 @@ =item Open Perl IDE +X<IDE, Open Perl IDE> +X<Integrated Development Environment, Open Perl IDE> @@ -273,2 +294,4 @@ =item OptiPerl +X<IDE, OptiPerl> +X<Integrated Development Environment, OptiPerl> @@ -280,2 +303,4 @@ =item PerlBuilder +X<IDE, PerlBuilder> +X<Integrated Development Environment, PerlBuilder> @@ -287,2 +312,4 @@ =item visiPerl+ +X<IDE, visiPerl+> +X<Integrated Development Environment, visiPerl+> @@ -293,2 +320,4 @@ =item Visual Perl +X<IDE, Visual Perl> +X<Integrated Development Environment, Visual Perl> @@ -299,2 +328,4 @@ =item Zeus +X<IDE, Zeus> +X<Integrated Development Environment, Zeus> @@ -469,2 +500,3 @@ =head2 Where can I get Perl macros for vi? +X<vi macros> @@ -477,2 +509,4 @@ =head2 Where can I get perl-mode for emacs? +X<emacs perl-mode> +X<emacs perl mode> @@ -492,2 +526,3 @@ =head2 How can I use curses with Perl? +X<curses> @@ -500,2 +535,4 @@ =head2 How can I use X or Tk with Perl? +X<Tk> +X<X windows> @@ -514,2 +551,3 @@ =head2 How can I make my Perl program run faster? +X<performance, improving> @@ -546,2 +584,5 @@ =head2 How can I make my Perl program take less memory? +X<memory, reducing consumption> +X<memory, reducing usage> +X<memory usage> @@ -684,2 +725,6 @@ =head2 How can I free an array or hash so my program shrinks? +X<releasing memory, array> +X<releasing memory, hash> +X<freeing memory, array> +X<freeing memory, hash> @@ -706,2 +751,3 @@ =head2 How can I make my CGI script more efficient? +X<performance, CGI> @@ -738,2 +784,4 @@ =head2 How can I hide the source for my Perl program? +X<hiding source> +X<obfuscating source> @@ -781,2 +829,4 @@ =head2 How can I compile my Perl program into byte code or C? +X<compiling Perl program> +X<Perl Archive Toolkit> @@ -814,2 +864,3 @@ =head2 How can I compile Perl into Java? +X<compiling Perl program, into Java> @@ -824,2 +875,5 @@ =head2 How can I get C<#!perl> to work on [MS-DOS,NT,...]? +X<running Perl program, MS-DOS> +X<running Perl program, Microsoft Windows> +X<running Perl program, MacOS> @@ -925,2 +979,5 @@ =head2 Where can I learn about CGI or Web programming in Perl? +X<CGI> +X<CGI programming> +X<web programming>
--- perlfaq4.pod Sat Mar 18 01:27:37 2006 +++ perlfaq4.indexed.pod Sat Mar 18 02:04:58 2006 @@ -12,2 +12,6 @@ =head2 Why am I getting long decimals (eg, 19.9499999999999) instead of the numbers I should be getting (eg, 19.95)? +X<floating point, rounding problem> +X<floating point, rounding error> +X<floating point, inexact> +X<floating point, imprecise> @@ -49,2 +53,6 @@ =head2 Why isn't my octal data interpreted correctly? +X<octal, argument to chmod> +X<octal, argument to mkdir> +X<octal, argument to umask> +X<octal, argument to sysopen> @@ -81,2 +89,6 @@ =head2 Does Perl have a round() function? What about ceil() and floor()? Trig functions? +X<math, standard function> +X<standard math function> +X<trig> +X<trigonometry> @@ -123,2 +135,4 @@ =head2 How do I convert between numeric representations/bases/radixes? +X<math, base conversion> +X<math, convert base> @@ -138,2 +152,3 @@ =item How do I convert hexadecimal into decimal +X<math, hexadecimal to decimal> @@ -158,2 +173,3 @@ =item How do I convert from decimal to hexadecimal +X<math, decimal to hexadecimal> @@ -182,2 +198,3 @@ =item How do I convert from octal to decimal +X<math, octal to decimal> @@ -199,2 +216,3 @@ =item How do I convert from decimal to octal +X<math, decimal to octal> @@ -211,2 +229,3 @@ =item How do I convert from binary to decimal +X<math, binary to decimal> @@ -240,2 +259,3 @@ =item How do I convert from decimal to binary +X<math, decimal to binary> @@ -261,2 +281,4 @@ =head2 Why doesn't & work the way I want it to? +X<&, problem> +X<& operator, problem> @@ -288,2 +310,5 @@ =head2 How do I multiply matrices? +X<math, matrix> +X<math, matrix arithmetic> +X<math, matrix multiplication> @@ -333,2 +358,3 @@ =head2 How can I output Roman numerals? +X<math, Roman numeral> @@ -337,2 +363,5 @@ =head2 Why aren't my random numbers random? +X<math, random number> +X<math, random> +X<math, rand> @@ -363,2 +392,5 @@ =head2 How do I get a random number between X and Y? +X<math, random number> +X<math, random> +X<math, rand> @@ -393,2 +425,4 @@ =head2 How do I find the day or week of the year? +X<date, day of the year> +X<date, day of the week> @@ -421,2 +455,4 @@ =head2 How do I find the current century or millennium? +X<date, current century> +X<date, current millennium> @@ -440,2 +476,3 @@ =head2 How can I compare two dates and find the difference? +X<date, comparison> @@ -456,2 +493,3 @@ =head2 How can I find the Julian Day? +X<date, Julian Day> @@ -509,2 +547,3 @@ =head2 Does Perl have a Year 2000 problem? Is Perl Y2K compliant? +X<date, Year 2000> @@ -541,2 +580,3 @@ =head2 How do I validate input? +X<string manipulation, input validation> @@ -564,2 +604,3 @@ =head2 How do I remove consecutive pairs of characters? +X<string manipulation, remove consecutive pairs of characters> @@ -589,2 +630,6 @@ =head2 How do I expand function calls in a string? +X<string manipulation, execute code within string> +X<string manipulation, call function in string> +X<string manipulation, run code in string> +X<string manipulation, interpolate code output> @@ -630,2 +675,6 @@ =head2 How do I find matching/nesting anything? +X<regular expression, find matching> +X<regexp, find matching> +X<regular expression, find nested> +X<regexp, find nested> @@ -677,2 +726,3 @@ =head2 How do I expand tabs in a string? +X<string manipulation, expand tab> @@ -689,2 +739,3 @@ =head2 How do I reformat a paragraph? +X<string manipulation, reformat paragraph> @@ -727,2 +778,4 @@ =head2 How do I change the Nth occurrence of something? +X<string manipulation, change Nth occurrence> +X<string manipulation, change occurrence> @@ -758,2 +811,4 @@ =head2 How can I count the number of occurrences of a substring within a string? +X<string manipulation, count occurrence> +X<string manipulation, count match> @@ -783,2 +838,3 @@ =head2 How do I capitalize all the words on one line? +X<string manipulation, capitalize word> @@ -831,2 +887,5 @@ =head2 How can I split a [character] delimited string except when inside [character]? +X<string manipulation, delimiter separated> +X<string manipulation, parsing delimiter separated> +X<parsing, delimiter separated> @@ -868,2 +927,6 @@ =head2 How do I strip blank space from the beginning/end of a string? +X<string manipulation, remove leading blank space> +X<string manipulation, remove leading whitespace> +X<string manipulation, remove trailing blank space> +X<string manipulation, remove trailing whitespace> @@ -917,2 +980,4 @@ =head2 How do I pad a string with blanks or pad a number with zeroes? +X<string manipulation, pad string> +X<string manipulation, pad number> @@ -962,2 +1027,3 @@ =head2 How do I extract selected columns from a string? +X<string manipulation, extract column> @@ -984,2 +1050,3 @@ =head2 How do I find the soundex value of a string? +X<string manipulation, soundex> @@ -992,2 +1059,3 @@ =head2 How can I expand variables in text strings? +X<string manipuation, expand variable> @@ -1017,2 +1085,5 @@ =head2 What's wrong with always quoting "$vars"? +X<quoting, stringification> +X<quoting, unnecessary> +X<performance, unncessary quoting> @@ -1059,2 +1130,5 @@ =head2 Why don't my E<lt>E<lt>HERE documents work? +X<common problem, HERE document> +X<common problem, HERE quoting> +X<quoting, common problem with HERE document> @@ -1162,2 +1236,5 @@ =head2 What is the difference between $array[1] and @array[1]? +X<common problem, array slice> +X<common problem, accidental array slice> +X<common problem, accessing array> @@ -1181,2 +1258,6 @@ =head2 How can I remove duplicate elements from a list or array? +X<list, finding duplicate element> +X<array, finding duplicate element> +X<list, removing duplicate element> +X<array, removing duplicate element> @@ -1224,2 +1305,4 @@ =head2 How can I tell whether a certain element is contained in a list or array? +X<list, search> +X<array, search> @@ -1292,2 +1375,6 @@ =head2 How do I compute the difference of two arrays? How do I compute the intersection of two arrays? +X<array, intersection> +X<list, intersection> +X<array, difference> +X<list, difference> @@ -1308,2 +1395,8 @@ =head2 How do I test whether two arrays or hashes are equal? +X<array, compare> +X<list, compare> +X<array, equal> +X<list, equal> +X<hash, compare> +X<hash, equal> @@ -1357,2 +1450,6 @@ =head2 How do I find the first array element for which a condition is true? +X<array, find if> +X<list, find if> +X<array, find first> +X<list, find first> @@ -1391,2 +1488,3 @@ =head2 How do I handle linked lists? +X<linked list> @@ -1440,2 +1538,3 @@ =head2 How do I handle circular lists? +X<circular list> @@ -1448,2 +1547,8 @@ =head2 How do I shuffle an array randomly? +X<shuffle array> +X<shuffle list> +X<list, shuffle list> +X<array, shuffle array> +X<list, random shuffle> +X<array, random shuffle> @@ -1528,2 +1633,4 @@ =head2 How do I select a random element from an array? +X<array, select random element> +X<list, select random element> @@ -1538,2 +1645,4 @@ =head2 How do I permute N elements of a list? +X<array, permutation> +X<list, permutation> @@ -1583,2 +1692,5 @@ =head2 How do I sort an array by (anything)? +X<list, sort> +X<array, sort> +X<sorting> @@ -1630,2 +1742,3 @@ =head2 How do I manipulate arrays of bits? +X<bit array> @@ -1733,2 +1846,5 @@ =head2 Why does defined() return true on empty arrays and hashes? +X<common problem, defined empty array> +X<common problem, defined empty list> +X<common problem, defined empty hash> @@ -1765,2 +1881,5 @@ =head2 How do I look up a hash element by value? +X<hash, find key from value> +X<hash, reverse lookup> +X<hash, inverse lookup> @@ -1787,2 +1906,3 @@ =head2 How can I know how many entries are in a hash? +X<hash, count entries> @@ -1798,2 +1918,3 @@ =head2 How do I sort a hash (optionally by value instead of key)? +X<hash, sort> @@ -1851,2 +1972,4 @@ =head2 What's the difference between "delete" and "undef" with hashes? +X<hash, removing element> +X<hash, assigning undef> @@ -2008,2 +2131,3 @@ =head2 How can I make the Perl equivalent of a C structure/C++ class/hash or array of hashes or arrays? +X<structure type> @@ -2026,2 +2150,3 @@ =head2 How can I use a reference as a hash key? +X<hash, using reference as key> @@ -2061,2 +2186,7 @@ =head2 How do I determine whether a scalar is a number/whole/integer/float? +X<string manipulation, numeric validation> +X<regular expression, numeric validation> +X<regexp, numeric validation> +X<regular expression, valid number> +X<regexp, valid number> @@ -2128,2 +2258,3 @@ =head2 How do I print out or copy a recursive data structure? +X<debug, display data structure>
