On Fri, Jul 01, 2005 at 03:10:50AM -0700, Yitzchak Scott-Thoennes wrote: > Here's a first try at perlglossary.pod, mostly taken from the Camel > III Glossary courtesy of the nice folks at O'Reilly. Their lawyers > are still working out the exact licensing wording, but Tim gave the ok > to add this now.
Wow, excellent! +=item awk > + > +Descriptive editing term--short for "awkward". Also coincidentally > +refers to a venerable text-processing language from which Perl derived > +some of its high-level ideas. > + > +=back 4 > + > +=over 4 > + > +=item backreference =back doesn't take an indent level. Also the =back/=over looks like some attempt to split the document into letter groupings but it doesn't have any effect. All the =back/=over's are effectively no-ops. Perhaps it would be better to do this: =item awk Blabity blah =back =head2 B =over 4 =item backreference Or simply don't bother with splitting into letter groupings, which I think is a better choice. Its not really useful in a man page as it is on paper as the amount of text seen is much smaller (so the groupings aren't as readily apparent) and we have the ability to search. Though it might be useful in HTML form as jump points. -- Michael G Schwern [EMAIL PROTECTED] http://www.pobox.com/~schwern ROCKS FALL! EVERYONE DIES! http://www.somethingpositive.net/sp05032002.shtml
