[PATCH 5.005_63 DOC] Readability patch to perlmod

[scozens@pwj.co.jp]

This makes it read a little better, but still needs some thought;
Benchmark isn't `the same name' as Benchmark.pm
Any suggestions/recasts greatly appreciated.

Incidentally, I have an issue with `library file': it's used variously
to mean `a file in the standard set of modules, which we call the module
library' and `a Perl4-ish .pl file'. So a library file is a file which
is something like a module but not quite, or a file which is one of a
set of standard files and which may or may not be a library file
(sense 1). ETOOCONFUSING! I've had people confused as to what a/the
`Perl library' is because of this, so is there a chance we choose one
meaning and stick to it?


Simon

(flames to simon@brecon.co.uk please, not this address.)

*** pod/perlmod.pod Wed Jul 21 02:18:09 1999
--- pod/perlmod.new Mon Jan 17 14:31:48 2000
***************
*** 261,268 ****

  =head2 Perl Modules

! A module is just a set of related function in a library file a Perl
! package with the same name as the file.  It is specifically designed
  to be reusable by other modules or programs.  It may do this by
  providing a mechanism for exporting some of its symbols into the
  symbol table of any package using it.  Or it may function as a class
--- 261,270 ----

  =head2 Perl Modules

! A module is just a set of related functions in a file containing a Perl
! package with the same name as the file.  For example, the standard
! Benchmark module is a set of functions in a package called Benchmark,
! stored in a file called F<Benchmark.pm>.  It is specifically designed
  to be reusable by other modules or programs.  It may do this by
  providing a mechanism for exporting some of its symbols into the
  symbol table of any package using it.  Or it may function as a class

---

Follow-Ups from:

Peter Scott <Peter@PSDT.com>

---

[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index][Thread Index][Top&Search][Original]

---