Path: utzoo!utgpu!news-server.csri.toronto.edu!cs.utexas.edu!sdd.hp.com!hplabs!hpl-opus!hpccc!weisberg
From: weisberg@hpccc.HP.COM (Len Weisberg)
Newsgroups: comp.lang.perl
Subject: Re: Index for Man Pages
Message-ID: <12170005@hpccc.HP.COM>
Date: 13 Jul 90 18:49:27 GMT
References: <183@sun13.scri.fsu.edu>
Organization: HP Corp Computing & Services
Lines: 89

John Nall writes:
> As something in between the excruciatingly detailed man pages,
> and the invaluable (but compressed) Perl Reference Guide, I
> have found that putting the following index on the front of
> the man pages (which I keep in a notebook) is helpful.  On
> the off chance that it may benefit someone else, here 'tis.
> This is, of course, for version 3.0.1.5.  Patch level 18.
> 
> ---------------------cut here---------------------------

  .....  table of contents deleted  ......



I have also found this idea to be very useful.
My version, included below, omits most of the big alphabetical list of 
functions so that the whole table of contents will fit on one page.
I have also added some annotations to help find items whose locations 
are not obvious.  Very subjective, of course.  Comments are welcome.

I hope someday to write some ?roff macros so that this will always be
printed out with correct page numbers, but meanwhile that is a manual
process.  If you are photocopying a number of copies, that is no problem,
anyway.  Also note, of course, that our page number mileage does vary.

Here goes.  Enjoy.

- Len Weisberg - HP Corp Computing & Services - weisberg@corp.HP.COM

------------------------------------------------------------------------------

perl(1)      UNIX System V  (Release 3.0 Patchlevel 18)           perl(1)

    	    Table of Contents 

 1 - NAME
 1 - SYNOPSIS
 1 - DESCRIPTION
 1 -   intro;  locating input script
 1 - Options
 4 - Data Types and Objects
 4 -   context;  "undefined";  scalars
 5 -   arrays;  associative arrays;  lvalues;  namespaces
 6 -   literals;  quoting;
 7 -   list assignment
 9 -   backticks - `...` ;  filehandles
 9 -   ARGV and <>
11 - Syntax
11 - Compound statements
13 -   "case"-like blocks
14 - Simple statements
14 -   conditional modifiers
15 - Expressions
15 -   in perl, not in C:
15 -   -  .. (range) operator
16 -   -  file-tests
17 -   in C, not in perl;   ++ string
19 -   alphabetical catalog of operators (builtin functions)
          (including the following topics)
24 -   -  do: &foo(@args)
24 -   -  do: #include and cpp
25 -   -  dump:  undump
26 -   -  eof:  <> line numbers
32 -   -  keys:  Environment - %ENV
33 -   -  local:  local variables
35 -   -  m/PATTERN/:  /PATTERN/
36 -   -  open:  files,  pipes
38 -   -  open:  redirecting stdin/stdout
39 -   -  pack:  binary structures
51 -   -  system:  shell escape
53 -   -  utime:  like touch(1)
55 - Precedence
56 - Subroutines
58 - Passing By Reference
58 - Regular Expressions
60 - Formats
62 - Interprocess Communication
63 - Predefined Names
68 - Packages
69 - Style
70 - Debugging
72 - Setuid Scripts
73 - ENVIRONMENT
74 - AUTHOR
74 - FILES
74 - SEE ALSO
74 - DIAGNOSTICS
74 - TRAPS (differences from awk, C, sed, shells)
76 - BUGS