jv@mh.nl (Johan Vromans) (08/21/90)
DISCLAIMER: The patch to the PostScript file "refbase.ps" is *NOT* a context diff, since that would have make it 5 times as big. VOLUNTEERS who want to make the full kit available via archive servers and/or anon FTP are invited to request for a new kit. Upgrade Perl Reference Guide 3.0.18.1 to 3.0.28.1. Changes since version 3.0.18.1: - added options "-c" and "-x" - added tokens "__LINE__", "__FILE__" and "__END__" - changed doc for "do EXPR" - added new arguments to "pack"/"unpack" - defaulted argument to "eval" and "length" - added doc for "ftruncate" and "require" - updated doc for "$[" and "@INC" - added doc for "$ARGV" and "%INC" - updated doc for the debugger - small typos and style changes Index: refbase.ps Prereq: 3.0.18.1 *** ../Post3.0.18.1/refbase.ps Fri Mar 30 10:52:25 1990 --- refbase.ps Tue Aug 21 10:49:55 1990 2c2 < %%Title: PerlRef 3.0.18.1 --- > %%Title: PerlRef 3.0.28.1 4c4 < %%CreationDate: Friday, March 30, 1990 --- > %%CreationDate: Tuesday, August 21, 1990 524c524 < (Johan Vromans; document: PerlRef 3.0.18.1)jn --- > (Johan Vromans; document: PerlRef 3.0.28.1)jn 703c703 < 820 127 gm --- > 837 197 gm 708c708 < (Rev. 3.0.18.1)show --- > (Rev. 3.0.28.1)show 763c763 < (\320d)show --- > (\320c)show 768a769,780 > (checks syntax but does not execute.)show > 179 169 gm > 1 fs > bu fc > 2 F /|______Times-Bold fnt > bn > (\320d)show > 179 197 gm > 0 fs > bu fc > 2 F /|______Times-Roman fnt > bn 780c792 < 176 197 gm --- > 193 197 gm 782c794 < 193 169 gm --- > 210 169 gm 795c807 < 207 197 gm --- > 224 197 gm 801c813 < 224 169 gm --- > 241 169 gm 817c829 < 238 197 gm --- > 255 197 gm 833c845 < 252 197 gm --- > 269 197 gm 835c847 < 269 169 gm --- > 286 169 gm 846c858 < 283 197 gm --- > 300 197 gm 851,854c863,864 < (specifies that files processed by the < > construct are to be edited)show < 297 197 gm < (in-place.)show < 314 169 gm --- > (files processed by the < > construct are to be edited in-place.)show > 317 169 gm 865c875 < 328 197 gm --- > 331 197 gm 881c891 < 345 169 gm --- > 348 169 gm 887c897 < 345 197 gm --- > 348 197 gm 893c903 < 362 169 gm --- > 365 169 gm 899c909 < 362 197 gm --- > 365 197 gm 905c915 < 379 169 gm --- > 382 169 gm 911c921 < 379 197 gm --- > 382 197 gm 917c927 < 396 169 gm --- > 399 169 gm 923c933 < 396 197 gm --- > 399 197 gm 929c939 < 410 197 gm --- > 413 197 gm 941c951 < 427 169 gm --- > 430 169 gm 947c957 < 427 197 gm --- > 430 197 gm 953c963 < 444 169 gm --- > 447 169 gm 959c969 < 444 197 gm --- > 447 197 gm 965c975 < 461 169 gm --- > 464 169 gm 971c981 < 461 197 gm --- > 464 197 gm 977c987 < 478 169 gm --- > 481 169 gm 983c993 < 478 197 gm --- > 481 197 gm 989c999 < 495 169 gm --- > 498 169 gm 995c1005 < 495 197 gm --- > 498 197 gm 1001c1011 < 509 197 gm --- > 512 197 gm 1003c1013 < 546 169 gm --- > 529 169 gm 1004a1015,1026 > bu fc > 2 F /|______Times-Bold fnt > bn > (\320x)show > 529 197 gm > 0 fs > bu fc > 2 F /|______Times-Roman fnt > bn > (extracts perl program from input stream.)show > 566 169 gm > 1 fs 1010c1032 < 566 169 gm --- > 586 169 gm 1017c1039 < 583 169 gm --- > 603 169 gm 1019c1041 < 597 197 gm --- > 617 197 gm 1021c1043 < 611 197 gm --- > 631 197 gm 1023c1045 < 628 169 gm --- > 648 169 gm 1025c1047 < 642 197 gm --- > 662 197 gm 1047c1069 < 659 169 gm --- > 679 169 gm 1049c1071 < 673 197 gm --- > 693 197 gm 1051c1073 < 687 197 gm --- > 707 197 gm 1053c1075 < 701 197 gm --- > 721 197 gm 1055c1077 < 718 169 gm --- > 738 169 gm 1057c1079 < 732 197 gm --- > 752 197 gm 1059c1081 < 746 197 gm --- > 766 197 gm 1061c1083 < 763 169 gm --- > 783 169 gm 1063c1085 < 777 197 gm --- > 797 197 gm 1065c1087 < 811 169 gm --- > 814 169 gm 1073c1095 < 845 169 gm --- > 842 169 gm 1079,1159c1101,1108 < 883 180 gm < (Perl 3.0 Reference Guide \320 Copyright )show < currentfont SwToSym < (\323)show < setfont < ( 1989, 1990 Johan Vromans)show < -4096 -4096 gm < 0 gr < -4095 -4095 lin < 6 25 lw < 868 163 gm < 868 164 lin < 868 163 gm < 869 163 lin < 25 6 lw < 1 1 lw < -4096 -4096 gm < -4095 -4095 lin < 6 25 lw < 868 164 gm < 868 525 lin < 25 6 lw < 1 1 lw < -4096 -4096 gm < -4095 -4095 lin < 6 25 lw < 868 525 gm < 869 525 lin < 25 6 lw < 1 1 lw < -4096 -4096 gm < -4095 -4095 lin < 6 25 lw < 868 163 gm < 889 163 lin < 25 6 lw < 1 1 lw < -4096 -4096 gm < -4095 -4095 lin < 6 25 lw < 868 525 gm < 889 525 lin < 25 6 lw < 1 1 lw < 900 180 gm < 1 setTxMode < (Rev. 3.0.18.1 Use and reproduction of this information is unlimited.)show < -4096 -4096 gm < 0 gr < -4095 -4095 lin < 6 25 lw < 906 163 gm < 906 164 lin < 25 6 lw < 1 1 lw < -4096 -4096 gm < -4095 -4095 lin < 6 25 lw < 906 164 gm < 906 525 lin < 25 6 lw < 1 1 lw < -4096 -4096 gm < -4095 -4095 lin < 6 25 lw < 25 6 lw < 1 1 lw < -4096 -4096 gm < -4095 -4095 lin < 6 25 lw < 888 163 gm < 906 163 lin < 25 6 lw < 1 1 lw < -4096 -4096 gm < -4095 -4095 lin < 6 25 lw < 888 525 gm < 906 525 lin < 25 6 lw < 1 1 lw --- > 859 169 gm > (Special tokens:)show > 873 197 gm > (_ _FILE_ _ : filename; _ _LINE_ _ : line number.)show > 887 197 gm > (_ _END_ _ : end of program; remaining lines are its standard)show > 901 197 gm > (input.)show 1313c1262 < (do EXPR)show --- > (do FILENAME)show 1315c1264 < (Uses the value of EXPR as a filename and executes the contents of)show --- > (Executes the contents of FILENAME as a perl script. Errors are)show 1317c1266 < (the file as a perl script. Errors are returned in $@ .)show --- > (returned in $@ . See also \322require\323 in section \322Miscellaneous\323.)show 1528c1477 < (This unary operator takes one argument, either a filename or a)show --- > (These unary operators takes one argument, either a filename or a)show 1538c1487 < (-r /-w /-x /-o)show --- > (\320r /\320w /\320x /\320o)show 1542c1491 < (-R /-W /-X /-O)show --- > (\320R /\320W /\320X /\320O)show 1546c1495 < (-e /-z /-s)show --- > (\320e /\320z /\320s)show 1550c1499 < (-f /-d)show --- > (\320f /\320d)show 1554c1503 < (-l /-S /-p)show --- > (\320l /\320S /\320p)show 1558c1507 < (-b /-c)show --- > (\320b /\320c)show 1562c1511 < (-u /-g /-k)show --- > (\320u /\320g /\320k)show 1566c1515 < (-t)show --- > (\320t)show 1570c1519 < (-T /-B)show --- > (\320T /\320B)show 1572c1521 < (File is a text/non-text \(binary\) file. Both -T and -B return)show --- > (File is a text/non-text \(binary\) file. Both \320T and \320B return)show 1697c1646 < (hex\(EXPR\)*)show --- > (hex\(EXPR\240\)*)show 1707c1656 < (oct\(EXPR\)*)show --- > (oct\(EXPR\240\)*)show 1816c1765,1769 < (p)show --- > (f)show > 388 244 gm > (/)show > 388 258 gm > (d)show 1818c1771 < (Pointer to a string)show --- > (Single/double float in native format)show 1820c1773,1777 < (x)show --- > (u)show > 405 244 gm > (/)show > 405 258 gm > (p)show 1822,1823c1779,1792 < (Null byte)show < 422 169 gm --- > (Uuencoded string / Pointer to a string)show > 422 228 gm > (x)show > 422 244 gm > (/)show > 422 258 gm > (@)show > 422 279 gm > (Null byte / null fill unto position)show > 439 228 gm > (X)show > 439 279 gm > (Backup a byte)show > 456 169 gm 1825,1829c1794,1822 < 436 169 gm < (as a repeat count. Spaces may be included in the template for readability)show < 450 169 gm < (purposes.)show < 487 169 gm --- > 470 169 gm > (as a repeat count, a \322*\323 specifies all remaining arguments.)show > 484 169 gm > (\322unpack\323 returns a )show > 2 fs > bu fc > 2 F /|______Times-Italic fnt > bn > (n)show > 0 fs > bu fc > 2 F /|______Times-Roman fnt > bn > (-bit checksum instead, if the format is preceded with)show > 498 169 gm > (\322%)show > 2 fs > bu fc > 2 F /|______Times-Italic fnt > bn > (n)show > 0 fs > bu fc > 2 F /|______Times-Roman fnt > bn > (\323.)show > 512 169 gm > (Spaces may be included in the template for readability purposes.)show > 549 169 gm 1836c1829 < 507 169 gm --- > 569 169 gm 1843c1836 < 521 197 gm --- > 583 197 gm 1845c1838 < 535 197 gm --- > 597 197 gm 1847c1840 < 549 197 gm --- > 611 197 gm 1849c1842 < 566 169 gm --- > 628 169 gm 1851c1844 < 580 197 gm --- > 642 197 gm 1853,1855c1846,1848 < 597 169 gm < (eval\(EXPR\)*)show < 611 197 gm --- > 659 169 gm > (eval\(EXPR\240\)*)show > 673 197 gm 1857c1850 < 625 197 gm --- > 687 197 gm 1859c1852 < 639 197 gm --- > 701 197 gm 1861c1854 < 653 197 gm --- > 715 197 gm 1863c1856 < 670 169 gm --- > 732 169 gm 1865c1858 < 684 197 gm --- > 746 197 gm 1867c1860 < 698 197 gm --- > 760 197 gm 1869,1871c1862,1864 < 715 169 gm < (length\(EXPR\)*)show < 729 197 gm --- > 777 169 gm > (length\(EXPR\240\)*)show > 791 197 gm 1873c1866 < 746 169 gm --- > 808 169 gm 1875c1868 < 760 197 gm --- > 822 197 gm 1877c1870 < 777 169 gm --- > 839 169 gm 1879c1872 < 791 197 gm --- > 853 197 gm 1881c1874 < 805 197 gm --- > 867 197 gm 1883c1876 < 819 197 gm --- > 881 197 gm 2050c2043 < (link\(OLDFILE,NEWFILE\))show --- > (truncate\(FILE,SIZE\))show 2052c2045 < (Creates a new filename linked to the old filename.)show --- > (truncates FILE to SIZE. FILE may be a filename or a filehandle.)show 2054c2047 < (lstat\(FILE\))show --- > (link\(OLDFILE,NEWFILE\))show 2056c2049 < (Like stat, but does not traverse a final symbolic link.)show --- > (Creates a new filename linked to the old filename.)show 2058c2051 < (mkdir\(DIR,MODE\))show --- > (lstat\(FILE\))show 2060c2053 < (Creates a directory with given permissions. Sets $! on failure.)show --- > (Like stat, but does not traverse a final symbolic link.)show 2062c2055 < (select\(RBITS,WBITS,NBITS,TIMEOUT\))show --- > (mkdir\(DIR,MODE\))show 2064c2057 < (Performs a select\(2\) system call with the same parameters.)show --- > (Creates a directory with given permissions. Sets $! on failure.)show 2066c2059 < (readlink\(EXPR\240\)*)show --- > (select\(RBITS,WBITS,NBITS,TIMEOUT\))show 2068c2061 < (Returns the value of a symbolic link.)show --- > (Performs a select\(2\) system call with the same parameters.)show 2070c2063 < (rename\(OLDNAME,NEWNAME\))show --- > (readlink\(EXPR\240\)*)show 2072c2065 < (Changes the name of a file.)show --- > (Returns the value of a symbolic link.)show 2074c2067 < (rmdir\(FILENAME\240\)*)show --- > (rename\(OLDNAME,NEWNAME\))show 2076c2069 < (Deletes the directory if it is empty. Sets $! on failure.)show --- > (Changes the name of a file.)show 2078c2071 < (stat\(FILE\))show --- > (rmdir\(FILENAME\240\)*)show 2079a2073,2076 > (Deletes the directory if it is empty. Sets $! on failure.)show > 514 169 gm > (stat\(FILE\))show > 528 197 gm 2081c2078 < 511 197 gm --- > 542 197 gm 2083c2080 < 525 197 gm --- > 556 197 gm 2085,2089c2082,2084 < 539 197 gm < (to the last file test operation. The parentheses may be omitted if)show < 553 197 gm < (FILE is a filehandle, a variable, or _ .)show < 570 169 gm --- > 570 197 gm > (to the last file test operation.)show > 587 169 gm 2091c2086 < 584 197 gm --- > 601 197 gm 2093c2088 < 601 169 gm --- > 618 169 gm 2095c2090 < 615 197 gm --- > 632 197 gm 2097c2092 < 632 169 gm --- > 649 169 gm 2099,2105c2094,2098 < 646 197 gm < (Changes the access and modification times on each file of a list of)show < 660 197 gm < (files. The first two elements of the list must be the numerical)show < 674 197 gm < (access and modification times.)show < 711 169 gm --- > 663 197 gm > (Changes the access and modification times. The first two elements)show > 677 197 gm > (of the list must be the numerical access and modification times.)show > 714 169 gm 2112c2105 < 731 169 gm --- > 734 169 gm 2119c2112 < 745 197 gm --- > 748 197 gm 2121c2114 < 762 169 gm --- > 765 169 gm 2123c2116 < 776 197 gm --- > 779 197 gm 2125c2118 < 793 169 gm --- > 796 169 gm 2127c2120 < 807 197 gm --- > 810 197 gm 2129c2122 < 824 169 gm --- > 827 169 gm 2131c2124 < 838 197 gm --- > 841 197 gm 2133c2126 < 855 169 gm --- > 858 169 gm 2135c2128 < 869 197 gm --- > 872 197 gm 2137c2130 < 886 169 gm --- > 889 169 gm 2139c2132 < 900 197 gm --- > 903 197 gm 2174c2167 < (\322binary\323 mode as opposed to \322text\323 mode \(MS-Dos only\).)show --- > (\322binary\323 mode as opposed to \322text\323 mode \(MS-DOS only\).)show 2642,2646c2635,2639 < (Designates the remainder of the current block as a package, having)show < 697 197 gm < (a separate namespace.)show < 714 169 gm < (reset [\(EXPR\)*])show --- > (Designates the remainder of the current block as a package,.)show > 700 169 gm > (require\(EXPR\240\)*)show > 714 197 gm > (Includes the specified file from the perl library. Does not include)show 2648,2657c2641,2650 < (Resets ?? searches so that they work again. If EXPR is not omitted,)show < 742 197 gm < (it is interpreted as a list of single characters \(hyphens allowed for)show < 756 197 gm < (ranges\). All variables and arrays beginning with one of those)show < 770 197 gm < (letters are reset to their pristine state. Only affects the current)show < 784 197 gm < (package.)show < 801 169 gm --- > (more than once, and yields error if the file does include OK.)show > 745 169 gm > (reset [\(EXPR\)*])show > 759 197 gm > (Resets ?? searches so that they work again. EXPR is a list of single)show > 773 197 gm > (letters. All variables and arrays beginning with one of those letters)show > 787 197 gm > (are reset to their pristine state. Only affects the current package.)show > 804 169 gm 2659c2652 < 815 197 gm --- > 818 197 gm 2661c2654 < 829 197 gm --- > 832 197 gm 2663c2656 < 846 169 gm --- > 849 169 gm 2665c2658 < 860 197 gm --- > 863 197 gm 2667c2660 < 877 169 gm --- > 880 169 gm 2669c2662 < 891 197 gm --- > 894 197 gm 2921c2914 < (nn)show --- > (n)show 2931c2924 < (mm)show --- > (m)show 2943c2936 < (nn)show --- > (n)show 2953c2946 < (mm)show --- > (m)show 2958,2959c2951,2994 < (\) match count.)show < 258 169 gm --- > (\) match count. {)show > 2 fs > bu fc > 2 F /|______Times-Italic fnt > bn > (n)show > 0 fs > bu fc > 2 F /|______Times-Roman fnt > bn > (})show > 255 197 gm > (means )show > 2 fs > bu fc > 2 F /|______Times-Italic fnt > bn > (n)show > 0 fs > bu fc > 2 F /|______Times-Roman fnt > bn > ( times; {)show > 2 fs > bu fc > 2 F /|______Times-Italic fnt > bn > (n)show > 0 fs > bu fc > 2 F /|______Times-Roman fnt > bn > (,} means at least )show > 2 fs > bu fc > 2 F /|______Times-Italic fnt > bn > (n)show > 0 fs > bu fc > 2 F /|______Times-Roman fnt > bn > ( times.)show > 272 169 gm 2961,2962d2995 < 258 197 gm < (matches alphanumeric, including \322_\323, \\W matches non-)show 2963a2997,2998 > (matches alphanumeric, including \322_\323, \\W matches non-)show > 286 197 gm 2965c3000 < 289 169 gm --- > 303 169 gm 2967c3002 < 289 197 gm --- > 303 197 gm 2969c3004 < 306 169 gm --- > 320 169 gm 2971c3006 < 306 197 gm --- > 320 197 gm 2973c3008 < 323 169 gm --- > 337 169 gm 2975c3010 < 323 197 gm --- > 337 197 gm 2977c3012 < 340 169 gm --- > 354 169 gm 2979c3014 < 357 169 gm --- > 371 169 gm 2981c3016 < 371 197 gm --- > 385 197 gm 2983c3018 < 388 169 gm --- > 402 169 gm 2985c3020 < 422 169 gm --- > 436 169 gm 2987c3022 < 436 197 gm --- > 450 197 gm 2989c3024 < 453 169 gm --- > 467 169 gm 2991c3026 < 453 197 gm --- > 467 197 gm 2993c3028 < 470 169 gm --- > 484 169 gm 2995c3030 < 470 197 gm --- > 484 197 gm 2997c3032 < 487 169 gm --- > 501 169 gm 2999c3034 < 487 197 gm --- > 501 197 gm 3001c3036 < 504 169 gm --- > 518 169 gm 3003c3038 < 504 197 gm --- > 518 197 gm 3005c3040 < 541 169 gm --- > 555 169 gm 3012c3047 < 561 197 gm --- > 575 197 gm 3019,3020d3053 < 575 197 gm < (FORMLIST)show 3021a3055,3056 > (FORMLIST)show > 603 197 gm 3023,3024d3057 < 606 169 gm < (FORMLIST pictures the lines, and contains the arguments which will)show 3025a3059,3060 > (FORMLIST pictures the lines, and contains the arguments which will)show > 634 169 gm 3027c3062 < 637 198 gm --- > 651 198 gm 3029c3064 < 651 227 gm --- > 665 227 gm 3031c3066 < 668 198 gm --- > 682 198 gm 3033c3068 < 685 198 gm --- > 699 198 gm 3035c3070 < 702 198 gm --- > 716 198 gm 3037c3072 < 719 169 gm --- > 733 169 gm 3039c3074 < 736 169 gm --- > 750 169 gm 3041c3076 < 753 169 gm --- > 767 169 gm 3043c3078 < 767 197 gm --- > 781 197 gm 3045c3080 < 784 169 gm --- > 798 169 gm 3046a3082,3162 > 870 180 gm > (Perl 3.0 Reference Guide \320 Copyright )show > currentfont SwToSym > (\323)show > setfont > ( 1989, 1990 Johan Vromans)show > -4096 -4096 gm > 0 gr > -4095 -4095 lin > 6 25 lw > 855 163 gm > 855 164 lin > 855 163 gm > 856 163 lin > 25 6 lw > 1 1 lw > -4096 -4096 gm > -4095 -4095 lin > 6 25 lw > 855 164 gm > 855 525 lin > 25 6 lw > 1 1 lw > -4096 -4096 gm > -4095 -4095 lin > 6 25 lw > 855 525 gm > 856 525 lin > 25 6 lw > 1 1 lw > -4096 -4096 gm > -4095 -4095 lin > 6 25 lw > 855 163 gm > 876 163 lin > 25 6 lw > 1 1 lw > -4096 -4096 gm > -4095 -4095 lin > 6 25 lw > 855 525 gm > 876 525 lin > 25 6 lw > 1 1 lw > 887 180 gm > 1 setTxMode > (Rev. 3.0.28.1 Use and reproduction of this information is unlimited.)show > -4096 -4096 gm > 0 gr > -4095 -4095 lin > 6 25 lw > 893 163 gm > 893 164 lin > 25 6 lw > 1 1 lw > -4096 -4096 gm > -4095 -4095 lin > 6 25 lw > 893 164 gm > 893 525 lin > 25 6 lw > 1 1 lw > -4096 -4096 gm > -4095 -4095 lin > 6 25 lw > 25 6 lw > 1 1 lw > -4096 -4096 gm > -4095 -4095 lin > 6 25 lw > 875 163 gm > 893 163 lin > 25 6 lw > 1 1 lw > -4096 -4096 gm > -4095 -4095 lin > 6 25 lw > 875 525 gm > 893 525 lin > 25 6 lw > 1 1 lw 3118c3234 < (The perl version string as displayed with \322perl -v\323.)show --- > (The perl version string \(as displayed with \322perl -v\323\), or number.)show 3201,3202c3317,3318 < 756 169 gm < (The following variables are always local to the current block:)show --- > 753 169 gm > ($ARGV The name of the current file when reading from < > .)show 3203a3320,3321 > (The following variables are always local to the current block:)show > 790 169 gm 3205c3323 < 773 197 gm --- > 790 197 gm 3207c3325 < 790 169 gm --- > 807 169 gm 3209c3327 < 790 197 gm --- > 807 197 gm 3211c3329 < 807 169 gm --- > 824 169 gm 3213c3331 < 807 197 gm --- > 824 197 gm 3215c3333 < 824 169 gm --- > 841 169 gm 3217c3335 < 824 197 gm --- > 841 197 gm 3219c3337 < 841 169 gm --- > 858 169 gm 3221c3339 < 855 197 gm --- > 872 197 gm 3223c3341 < 869 197 gm --- > 886 197 gm 3252,3255c3370,3371 < (including the command name\). See $0 for the command)show < 173 227 gm < (name.)show < 190 169 gm --- > (including the command name\).)show > 176 169 gm 3257c3373 < 190 227 gm --- > 176 227 gm 3259,3261c3375,3377 < 204 227 gm < (evaluated by the \322do EXPR\323 command.)show < 221 169 gm --- > 190 227 gm > (evaluated by the \322do FILENAME\323 and \322require\323 command.)show > 207 169 gm 3263c3379 < 221 227 gm --- > 207 227 gm 3265c3381 < 235 227 gm --- > 221 227 gm 3267c3383 < 252 169 gm --- > 238 169 gm 3269c3385 < 252 227 gm --- > 238 227 gm 3271c3387,3391 < 269 169 gm --- > 255 169 gm > (%INC)show > 255 227 gm > (List of files that have been \322require\323-d or \322do\323-ne.)show > 272 169 gm 3273c3393 < 269 227 gm --- > 272 227 gm 3275c3395 < 306 169 gm --- > 309 169 gm 3298c3418 < 326 169 gm --- > 329 169 gm 3304c3424 < 326 197 gm --- > 329 197 gm 3306c3426 < 343 169 gm --- > 346 169 gm 3308c3428 < 343 197 gm --- > 346 197 gm 3310,3314c3430,3434 < 360 169 gm < (c)show < 360 197 gm < (Continues \(until breakpoint or exit\).)show < 378 173 gm --- > 363 169 gm > (c [LINE])show > 363 239 gm > (Continues \(at LINE, or until breakpoint or exit\).)show > 381 173 gm 3326,3327c3446,3447 < 378 194 gm < 367 194 lin --- > 381 194 gm > 370 194 lin 3333,3334c3453,3454 < 367 194 gm < 367 170 lin --- > 370 194 gm > 370 170 lin 3340,3341c3460,3461 < 367 170 gm < 381 170 lin --- > 370 170 gm > 384 170 lin 3347,3348c3467,3468 < 381 170 gm < 381 194 lin --- > 384 170 gm > 384 194 lin 3354,3355c3474,3475 < 381 194 gm < 378 194 lin --- > 384 194 gm > 381 194 lin 3358c3478 < 378 204 gm --- > 381 204 gm 3365c3485 < 397 169 gm --- > 400 169 gm 3367c3487 < 397 197 gm --- > 400 197 gm 3369c3489,3493 < 414 169 gm --- > 417 169 gm > (f)show > 417 197 gm > (Breaks after finishing current subroutine.)show > 434 169 gm 3371,3375c3495,3509 < 428 197 gm < (lists a range of lines. RANGE may be a number, start-end,)show < 442 197 gm < (start+amount, or a subroutine name. If omitted, continues last \322l\323.)show < 459 169 gm --- > 434 239 gm > (Lists a range of lines. RANGE may be a number, start-)show > 448 197 gm > (end, start+amount, or a subroutine name. If omitted, lists next)show > 462 197 gm > (window.)show > 479 169 gm > (\320)show > 479 197 gm > (Lists previous window.)show > 496 169 gm > (w)show > 496 197 gm > (Lists window around current line.)show > 513 169 gm 3377c3511 < 459 197 gm --- > 513 197 gm 3379c3513 < 476 169 gm --- > 530 169 gm 3381c3515 < 476 197 gm --- > 530 197 gm 3383,3385c3517,3523 < 493 169 gm < (b [LINE])show < 507 197 gm --- > 547 169 gm > (T)show > 547 197 gm > (Stack trace.)show > 564 169 gm > (b [LINE [condition]])show > 564 274 gm 3387,3389c3525,3527 < 524 169 gm < (b SUBNAME)show < 538 197 gm --- > 581 169 gm > (b SUBNAME [condition])show > 581 309 gm 3391c3529 < 555 169 gm --- > 598 169 gm 3393c3531 < 555 197 gm --- > 598 197 gm 3395c3533 < 572 169 gm --- > 615 169 gm 3397c3535 < 586 197 gm --- > 615 239 gm 3399c3537 < 603 169 gm --- > 632 169 gm 3401c3539 < 603 197 gm --- > 632 197 gm 3403c3541 < 620 169 gm --- > 649 169 gm 3405c3543 < 620 197 gm --- > 649 197 gm 3407c3545 < 637 169 gm --- > 666 169 gm 3409,3411c3547,3551 < 651 197 gm < (Lists all variables in a package. Default package is main.)show < 668 169 gm --- > 666 274 gm > (Lists all variables in a package. Default package is)show > 680 197 gm > (main.)show > 697 169 gm 3413c3553 < 682 197 gm --- > 697 309 gm 3415c3555 < 699 169 gm --- > 714 169 gm 3417,3419c3557,3561 < 713 197 gm < (Sets an action to be executed before every debugger prompt.)show < 730 169 gm --- > 714 274 gm > (Sets an action to be executed before every)show > 728 197 gm > (debugger prompt.)show > 745 169 gm 3421,3425c3563,3567 < 744 197 gm < (Sets an action to be executed before every \322s\323, \322c\323 or \322n\323)show < 758 197 gm < (command.)show < 775 169 gm --- > 745 274 gm > (Sets an action to be executed before every \322s\323, \322c\323)show > 759 197 gm > (or \322n\323 command.)show > 776 169 gm 3427,3429c3569,3573 < 789 197 gm < (Redo a debugging command. Default is previous command.)show < 806 169 gm --- > 776 274 gm > (Redo a debugging command. Default is previous)show > 790 197 gm > (command.)show > 807 169 gm 3431,3433c3575,3579 < 820 197 gm < (Displays the last \320number commands of more than one letter.)show < 838 169 gm --- > 807 274 gm > (Displays the last \320number commands of more than)show > 821 197 gm > (one letter.)show > 839 169 gm 3435c3581 < 838 197 gm --- > 839 197 gm 3437c3583 < 838 346 gm --- > 839 346 gm 3447,3448c3593,3594 < 838 368 gm < 827 368 lin --- > 839 368 gm > 828 368 lin 3454,3455c3600,3601 < 827 368 gm < 827 343 lin --- > 828 368 gm > 828 343 lin 3461,3462c3607,3608 < 827 343 gm < 841 343 lin --- > 828 343 gm > 842 343 lin 3468,3469c3614,3615 < 841 343 gm < 841 368 lin --- > 842 343 gm > 842 368 lin 3475,3476c3621,3622 < 841 368 gm < 838 368 lin --- > 842 368 gm > 839 368 lin 3479c3625 < 838 370 gm --- > 839 370 gm 3486c3632 < 857 169 gm --- > 858 169 gm 3488c3634 < 871 197 gm --- > 858 239 gm 3490c3636 < 888 169 gm --- > 875 169 gm 3492c3638 < 902 197 gm --- > 875 239 gm 3493a3640,3643 > 892 169 gm > (/pattern/ Forward search for pattern.)show > 909 169 gm > (?pattern? Backward search for pattern.)show *** ../Post3.0.18.1/Makefile Tue Aug 21 10:50:52 1990 --- Makefile Tue Aug 21 12:25:28 1990 *************** *** 1,4 ! # @(#)@ Makefile 1.6 - Makefile for Perl Reference Guide SHELL = /bin/sh --- 1,4 ----- ! # @(#)@ Makefile 1.10 - Makefile for Perl Reference Guide SHELL = /bin/sh *************** *** 7,13 AUX = README Makefile parr psfmt - all: refguide.ps refcard.ps # 2 pages per page, suitable for centrefold reference guide --- 7,12 ----- AUX = README Makefile parr psfmt all: refguide.ps refcard.ps 2pass: guide-odd.ps guide-even1.ps guide-even2.ps *************** *** 10,15 all: refguide.ps refcard.ps # 2 pages per page, suitable for centrefold reference guide refguide.ps: refbase.ps parr psfmt parr -o 16,1,2,15,14,3,4,13,12,5,6,11,10,7,8,9 refbase.ps \ --- 9,16 ----- all: refguide.ps refcard.ps + 2pass: guide-odd.ps guide-even1.ps guide-even2.ps + # 2 pages per page, suitable for centrefold reference guide refguide.ps: refbase.ps parr psfmt parr -o 16,1,2,15,14,3,4,13,12,5,6,11,10,7,8,9 refbase.ps \ *************** *** 15,20 parr -o 16,1,2,15,14,3,4,13,12,5,6,11,10,7,8,9 refbase.ps \ | psfmt $(PAPER) > refguide.ps # 3 pages per page, suitable for triplefold reference card refcard.ps: refbase.ps parr psfmt parr -o 2,3,4,5,6,7,8,9,10,11,12,13,14,15,16 refbase.ps \ --- 16,37 ----- parr -o 16,1,2,15,14,3,4,13,12,5,6,11,10,7,8,9 refbase.ps \ | psfmt $(PAPER) > refguide.ps + # Odd and even passes for centerfold printing. First print + # guide-odd.ps, then find out which of the others to use. + # guide-even1.ps is for Apple LaserWriter II, guide-even1.ps for old + # Apple LaserWriters. + guide-odd.ps: refbase.ps parr psfmt + parr -o 16,1,14,3,12,5,10,7 refbase.ps \ + | psfmt $(PAPER) > guide-odd.ps + + guide-even1.ps: refbase.ps parr psfmt + parr -o 8,9,6,11,4,13,2,15 refbase.ps \ + | psfmt $(PAPER) > guide-even1.ps + + guide-even2.ps: refbase.ps parr psfmt + parr -o 2,15,4,13,6,11,8,9 refbase.ps \ + | psfmt $(PAPER) > guide-even2.ps + # 3 pages per page, suitable for triplefold reference card refcard.ps: refbase.ps parr psfmt parr -o 2,3,4,5,6,7,8,9,10,11,12,13,14,15,16 refbase.ps \ *************** *** 20,29 parr -o 2,3,4,5,6,7,8,9,10,11,12,13,14,15,16 refbase.ps \ | psfmt $(PAPER) -card > refcard.ps - refbase.ps: - cat refbase.xa? > refbase.ps - chmod 755 parr psfmt - clean: rm -f refbase.x?? refguide.ps refcard.ps --- 37,42 ----- parr -o 2,3,4,5,6,7,8,9,10,11,12,13,14,15,16 refbase.ps \ | psfmt $(PAPER) -card > refcard.ps clean: rm -f refguide.ps refcard.ps *************** *** 25,31 chmod 755 parr psfmt clean: ! rm -f refbase.x?? refguide.ps refcard.ps # For production use only ... --- 38,44 ----- | psfmt $(PAPER) -card > refcard.ps clean: ! rm -f refguide.ps refcard.ps # For production use only ... *************** *** 29,34 # For production use only ... REV = 1 SRC = RefGuide3.0.18.$(REV).ps --- 42,48 ----- # For production use only ... + PL = 28 REV = 1 SRC = RefGuide3.0.$(PL).$(REV).ps *************** *** 30,36 # For production use only ... REV = 1 ! SRC = RefGuide3.0.18.$(REV).ps refbase: $(SRC) perl pssplit $(SRC) --- 44,50 ----- PL = 28 REV = 1 ! SRC = RefGuide3.0.$(PL).$(REV).ps refbase: $(SRC) perl pssplit $(SRC) *************** *** 37,47 perl psjoin > refbase.ps rm -f Page-??.psx ! shar: $(AUX) refbase.ps ! split -500 refbase.ps refbase.x ! shar -c -m 30000 -f perlref refbase.x?? $(AUX) ! rm -f refbase.x?? ! ls -l perlref.shr? TZ: $(AUX) refbase.ps pdtar -zcvf perlref.TZ $(AUX) refbase.ps --- 51,62 ----- perl psjoin > refbase.ps rm -f Page-??.psx ! shar: Changes $(AUX) refbase.ps ! chmod 755 parr psfmt ! rm -f perfref_shr.* ! shar -c -n perlref3_$(PL)_$(REV) -a -s 'jv@mh.nl' \ ! -o perlref_shr -L30 -f Changes $(AUX) refbase.ps ! ls -l perlref_shr.* TZ: $(AUX) refbase.ps pdtar -zcvf perlref.TZ $(AUX) refbase.ps *** ../Post3.0.18.1/README Tue Aug 21 10:50:52 1990 --- README Tue Aug 21 12:27:01 1990 *************** *** 3,9 The Perl 3.0 Reference Guide ! Revised: March 30, 1990 The Perl Reference Guide is a typeset quick reference guide to Larry Wall's Perl program. --- 3,9 ----- The Perl 3.0 Reference Guide ! Revised: 90/08/21 The Perl Reference Guide is a typeset quick reference guide to Larry Wall's Perl program. *************** *** 10,16 It contains a concise description of all Perl 3.0 statements, functions, variables and lots of other useful information. ! The Guide is based on Perl version 3.0, patchlevel 18. The purpose of the Reference Guide is to aid in the use of Perl, to look up the syntax of specific functions, statements and the meaning --- 10,16 ----- It contains a concise description of all Perl 3.0 statements, functions, variables and lots of other useful information. ! The Guide is based on Perl version 3.0, patchlevel 28. The purpose of the Reference Guide is to aid in the use of Perl, to look up the syntax of specific functions, statements and the meaning *************** *** 36,41 After unloading the distribution, you will have the following files: README - this file Makefile - make file psfmt - page formatting tool parr - page rearrange tool (stolen from J.Greely) --- 36,42 ----- After unloading the distribution, you will have the following files: README - this file + Changes - a short description of changes Makefile - make file psfmt - page formatting tool parr - page rearrange tool (stolen from J.Greely) *************** *** 41,54 parr - page rearrange tool (stolen from J.Greely) refbase.ps - PostScript version of the Reference Guide - If you unloaded from the shar files, you will have refbase.ps split - into pieces: - - refbase.x?? - pieces of refbase.ps - - The instructions in the Makefile will construct refbase.ps from the - pieces. - As distributed, the Makefile is configured to generate output for A4 (21 x 29.7 cm) paper format. Use "make PAPER= ..." to select US Letter (8.5 x 11") format. Both formats should be printable on all --- 42,47 ----- parr - page rearrange tool (stolen from J.Greely) refbase.ps - PostScript version of the Reference Guide As distributed, the Makefile is configured to generate output for A4 (21 x 29.7 cm) paper format. Use "make PAPER= ..." to select US Letter (8.5 x 11") format. Both formats should be printable on all *************** *** 61,66 2-column text. It should be printed double-sided, stapled in the middle, folded, and cut to size to have a 16-page 3.5 x 8" booklet. - Use "make refcard.ps" to create a "Reference Card", with 5 pages of 3-column text. --- 54,64 ----- 2-column text. It should be printed double-sided, stapled in the middle, folded, and cut to size to have a 16-page 3.5 x 8" booklet. + - Use "make 2pass" to create a set of odd and even pages for double + sided printing. First print "guide-odd.ps". Then put the paper back + in the tray, and print either "guide-even1.ps" or "guide-even2.ps", + depending on the way your printer arranges the printed paper. + - Use "make refcard.ps" to create a "Reference Card", with 5 pages of 3-column text. *************** *** 64,70 - Use "make refcard.ps" to create a "Reference Card", with 5 pages of 3-column text. ! "make" without arguments will make both. If your printout is not correct, feel free to change the figures in the formatting program "psfmt". --- 62,68 ----- - Use "make refcard.ps" to create a "Reference Card", with 5 pages of 3-column text. ! "make" without arguments will make both the refguide and the refcard. If your printout is not correct, feel free to change the figures in the formatting program "psfmt". *************** *** 92,100 Moy (for "macps"), JGreely (for "parr"), Edwin Kremer. And Larry Wall, of course, without whom I would have spent lots of time annoying myself. ! ---------------------------------------------------------------------- ! Some people are trying to create TeX and troff versions of the guides; ! I've sent them the ascii text but didn't hear anything since :-( . ! ---------------------------------------------------------------------- ! PostScript is a trademark of Adobe, I assume. --- 90,94 ----- Moy (for "macps"), JGreely (for "parr"), Edwin Kremer. And Larry Wall, of course, without whom I would have spent lots of time annoying myself. ! -- PostScript is a trademark of Adobe, I assume. No differences encountered No differences encountered *** /dev/null Tue Aug 21 12:28:15 1990 --- Changes Tue Aug 21 11:55:04 1990 *************** *** 0 --- 1,14 ----- + Changes since version 3.0.18.1: + + - added options "-c" and "-x" + - added tokens "__LINE__", "__FILE__" and "__END__" + - changed doc for "do EXPR" + - added new arguments to "pack"/"unpack" + - defaulted argument to "eval" and "length" + - added doc for "ftruncate" and "require" + - updated doc for "$[" and "@INC" + - added doc for "$ARGV" and "%INC" + - updated doc for the debugger + - small types and style changes + + The Makefile has additional entries for 2pass printing. -- Johan Vromans jv@mh.nl via internet backbones Multihouse Automatisering bv uucp: ..!{uunet,hp4nl}!mh.nl!jv Doesburgweg 7, 2803 PL Gouda, The Netherlands phone/fax: +31 1820 62911/62500 ------------------------ "Arms are made for hugging" -------------------------