This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlfunc: Document fallback to "top" format
authorFather Chrysostomos <sprout@cpan.org>
Mon, 10 Jun 2013 07:18:07 +0000 (00:18 -0700)
committerFather Chrysostomos <sprout@cpan.org>
Mon, 10 Jun 2013 07:19:17 +0000 (00:19 -0700)
commitdbaf95aca2eb7d377aca1764b72e71120da654fd
treee30425ea38adc0d529af303998457a63c5c95647
parent319f71293a1ed7c0f55e9fb7822514fb5fbe7944
perlfunc: Document fallback to "top" format

perl 4’s perl.man says this:

By default the top‐of‐page format is "top", but it may be set to the
format of your choice by assigning the name to the $^ variable.

This is still the case, but is completely undocumented in perl 5.

In perl 5 the presence of a <FILEHANDLE_NAME>_TOP format will over-
ride "top", as will $^, but "top" is still checked for in the
absence of those.

This should be documented.  One thing I do mention here that perl 4
omits is that it is "top" in the current package.

I also tweaked the wording of the preceding sentence.
pod/perlfunc.pod