Subject: Rearrange perl.pod Bug-Debian: http://bugs.debian.org/278323 The TOC in perl.pod should probably not be in the synopsis. Note the debian/ prefix rather than fixes/ since upstream doesn't agree. --- pod/perl.pod | 64 +++++++++++++++++++++++++++++----------------------------- 1 files changed, 32 insertions(+), 32 deletions(-) diff --git a/pod/perl.pod b/pod/perl.pod index 939c683..9bc461d 100644 --- a/pod/perl.pod +++ b/pod/perl.pod @@ -16,6 +16,38 @@ B S<[ B<-sTtuUWX> ]> S<[ B<-i>[I] ]> S<[ [B<-e>|B<-E>] I<'command'> ] [ B<--> ] [ I ] [ I ]...> +=head1 DESCRIPTION + +Perl is a language optimized for scanning arbitrary +text files, extracting information from those text files, and printing +reports based on that information. It's also a good language for many +system management tasks. The language is intended to be practical +(easy to use, efficient, complete) rather than beautiful (tiny, +elegant, minimal). + +Perl combines (in the author's opinion, anyway) some of the best +features of C, B, B, and B, so people familiar with +those languages should have little difficulty with it. (Language +historians will also note some vestiges of B, Pascal, and even +BASIC-PLUS.) Expression syntax corresponds closely to C +expression syntax. Unlike most Unix utilities, Perl does not +arbitrarily limit the size of your data--if you've got the memory, +Perl can slurp in your whole file as a single string. Recursion is of +unlimited depth. And the tables used by hashes (sometimes called +"associative arrays") grow as necessary to prevent degraded +performance. Perl can use sophisticated pattern matching techniques to +scan large amounts of data quickly. Although optimized for +scanning text, Perl can also deal with binary data, and can make dbm +files look like hashes. Setuid Perl scripts are safer than C programs +through a dataflow tracing mechanism that prevents many stupid +security holes. + +If you have a problem that would ordinarily use B or B or +B, but it exceeds their capabilities or must run a little faster, +and you don't want to write the silly thing in C, then Perl may be for +you. There are also translators to turn your B and B +scripts into Perl scripts. + If you're new to Perl, you should start with L, which is a general intro for beginners and provides some background to help you navigate the rest of Perl's extensive documentation. @@ -258,38 +290,6 @@ If something strange has gone wrong with your program and you're not sure where you should look for help, try the B<-w> switch first. It will often point out exactly where the trouble is. -=head1 DESCRIPTION - -Perl is a language optimized for scanning arbitrary -text files, extracting information from those text files, and printing -reports based on that information. It's also a good language for many -system management tasks. The language is intended to be practical -(easy to use, efficient, complete) rather than beautiful (tiny, -elegant, minimal). - -Perl combines (in the author's opinion, anyway) some of the best -features of C, B, B, and B, so people familiar with -those languages should have little difficulty with it. (Language -historians will also note some vestiges of B, Pascal, and even -BASIC-PLUS.) Expression syntax corresponds closely to C -expression syntax. Unlike most Unix utilities, Perl does not -arbitrarily limit the size of your data--if you've got the memory, -Perl can slurp in your whole file as a single string. Recursion is of -unlimited depth. And the tables used by hashes (sometimes called -"associative arrays") grow as necessary to prevent degraded -performance. Perl can use sophisticated pattern matching techniques to -scan large amounts of data quickly. Although optimized for -scanning text, Perl can also deal with binary data, and can make dbm -files look like hashes. Setuid Perl scripts are safer than C programs -through a dataflow tracing mechanism that prevents many stupid -security holes. - -If you have a problem that would ordinarily use B or B or -B, but it exceeds their capabilities or must run a little faster, -and you don't want to write the silly thing in C, then Perl may be for -you. There are also translators to turn your B and B -scripts into Perl scripts. - But wait, there's more... Begun in 1993 (see L), Perl version 5 is nearly a complete -- tg: (daf8b46..) debian/perl_synopsis (depends on: upstream)