X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlform.pod;h=4fac1a69e38a5a35bb66368746ca2b1c29b5d9f2;hb=3ed26a2c26e4f1468588c483e9e86eae4e74f24f;hp=8c840d4cc2ecb3405e18d135f755f20fdc5ab78d;hpb=a2eb900354d7492c5b0c2f521e88387de8974900;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlform.pod b/pod/perlform.pod index 8c840d4..4fac1a6 100644 --- a/pod/perlform.pod +++ b/pod/perlform.pod @@ -54,7 +54,7 @@ with either "@" (at) or "^" (caret). These lines do not undergo any kind of variable interpolation. The at field (not to be confused with the array marker @) is the normal kind of field; the other kind, caret fields, are used to do rudimentary multi-line text block filling. The length of the field -is supplied by padding out the field with multiple "<", ">", or "|" +is supplied by padding out the field with multiple "E", "E", or "|" characters to specify, respectively, left justification, right justification, or centering. If the variable would exceed the width specified, it is truncated. @@ -147,18 +147,18 @@ Examples: . It is possible to intermix print()s with write()s on the same output -channel, but you'll have to handle $- ($FORMAT_LINES_LEFT) +channel, but you'll have to handle C<$-> (C<$FORMAT_LINES_LEFT>) yourself. =head2 Format Variables -The current format name is stored in the variable C<$~> ($FORMAT_NAME), -and the current top of form format name is in C<$^> ($FORMAT_TOP_NAME). -The current output page number is stored in C<$%> ($FORMAT_PAGE_NUMBER), -and the number of lines on the page is in C<$=> ($FORMAT_LINES_PER_PAGE). +The current format name is stored in the variable C<$~> (C<$FORMAT_NAME>), +and the current top of form format name is in C<$^> (C<$FORMAT_TOP_NAME>). +The current output page number is stored in C<$%> (C<$FORMAT_PAGE_NUMBER>), +and the number of lines on the page is in C<$=> (C<$FORMAT_LINES_PER_PAGE>). Whether to autoflush output on this handle is stored in C<$|> -($OUTPUT_AUTOFLUSH). The string output before each top of page (except -the first) is stored in C<$^L> ($FORMAT_FORMFEED). These variables are +(C<$OUTPUT_AUTOFLUSH>). The string output before each top of page (except +the first) is stored in C<$^L> (C<$FORMAT_FORMFEED>). These variables are set on a per-filehandle basis, so you'll need to select() into a different one to affect them: @@ -198,7 +198,7 @@ Much better! =head1 NOTES -Since the values line may contain arbitrary expressions (for at fields, +Because the values line may contain arbitrary expressions (for at fields, not caret fields), you can farm out more sophisticated processing to other functions, like sprintf() or one of your own. For example: