develooper Front page | perl.perl5.porters | Postings from March 2000

Re: [ID 20000316.011] perldoc INSTALL

From:
Andy Dougherty
Date:
March 23, 2000 08:09
Subject:
Re: [ID 20000316.011] perldoc INSTALL
Message ID:
Pine.SOL.4.10.10003231104190.10680-100000@maxwell.phys.lafayette.edu
On Thu, 16 Mar 2000, Richard Foley wrote:

> perldoc INSTALL
> /usr/bin/pod2man: bad option in paragraph 52 of INSTALL: ``-d'' should
> be [CB]<-d>
[etc.]

I don't have a specific proposal here, but I think the INSTALL file is
fine as is.  This is a pod2man problem.  Readers of INSTALL should not
have to wade through non-plain pod markup just to decipher exactly what to
type and what not to type to build and install perl.  The INSTALL file
ought to be readable, as is, by someone who has never touched perl or pod
before.

Perhaps INSTALL needs some sort of

	=for pod2man quiet-already-I-know-what-I'm-doing

pragma or something near the top, but please don't anyone go in and
clutter up the current readable version with non-plain markup.

    Andy Dougherty		doughera@lafayette.edu
    Dept. of Physics
    Lafayette College, Easton PA 18042




nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About