Path: utzoo!utgpu!news-server.csri.toronto.edu!cs.utexas.edu!know!zaphod.mps.ohio-state.edu!sdd.hp.com!hplabs!hpcc01!weisberg
From: weisberg@hpcc01.HP.COM (Len Weisberg)
Newsgroups: comp.lang.perl
Subject: Re: Index for Man Pages
Message-ID: <12150003@hpcc01.HP.COM>
Date: 24 Jul 90 00:18:30 GMT
References: <183@sun13.scri.fsu.edu>
Organization: HP Corporate Computing & Services
Lines: 82

I wrote a week or so ago:
> 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.

Since there has been no comment, I am wondering if anyone is interested in
this idea.  Has anyone tried to tailor one for their own printing?
If I did indeed come up with ?roff macros, would there be any chance that
their use would be incorporated into the official manpage source?

Anyway, In my last pass through the manual, I came up with a few more
hard-to-find items; so here's my new version of the annotated 
Table of Contents:

- 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 (annotated with selected hard-to-find topics)

 1 - NAME; SYNOPSIS
 1 - DESCRIPTION
 1 -   intro;  locating input script
 1 - Command line options (including:)
 3 -   -S - alternative to #!
 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 <>
10 -   filename globbing
11 - Syntax
11 - Compound statements
13 -   "case"-like blocks
14 - Simple statements
14 -   conditional modifiers
15 - Expressions
15 -   in perl, not in C (including:)
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 (including:)
66 -   $; - multidimensional array emulation
68 - Packages
69 - Style
70 - Debugging
72 - Setuid Scripts
73 - ENVIRONMENT
74 - AUTHOR;  FILES;  SEE ALSO;  DIAGNOSTICS
74 - TRAPS (differences from awk, C, sed, shells)
76 - BUGS