From nobody@FreeBSD.ORG Mon Nov  1 10:31:39 1999
Return-Path: <nobody@FreeBSD.ORG>
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id 304BA14D5B; Mon,  1 Nov 1999 10:31:39 -0800 (PST)
Message-Id: <19991101183139.304BA14D5B@hub.freebsd.org>
Date: Mon,  1 Nov 1999 10:31:39 -0800 (PST)
From: andyf@speednet.com.au
Sender: nobody@FreeBSD.ORG
To: freebsd-gnats-submit@freebsd.org
Subject: Perl "tutorials" missing from documentation
X-Send-Pr-Version: www-1.0

>Number:         14649
>Category:       gnu
>Synopsis:       Perl "tutorials" missing from documentation
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    sheldonh
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Nov  1 10:40:01 PST 1999
>Closed-Date:    Wed Nov 17 05:09:04 PST 1999
>Last-Modified:  Wed Nov 17 05:09:56 PST 1999
>Originator:     Andy Farkas
>Release:        3.3-STABLE, 4.0-CURRENT
>Organization:
Speednet Communications Pty Ltd
>Environment:
>Description:
'man perl' mentions three sections: perlopentut, perlreftut,
and perlthrtut, but they are not built/installed by 'make world'.

It looks like they were left out on purpose.  Why?

>How-To-Repeat:
man perlopentut

>Fix:
Either the man page for perl should be changed, or the makefiles in
src/gnu/usr.bin/perl/pod/* should include the missing sections.


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->markm 
Responsible-Changed-By: sheldonh 
Responsible-Changed-When: Tue Nov 2 01:47:59 PST 1999 
Responsible-Changed-Why:  
Mark is Mr Perl, although I'm happy to commit this if he feels it's 
trivial. 

From: Sheldon Hearn <sheldonh@uunet.co.za>
To: andyf@speednet.com.au
Cc: freebsd-gnats-submit@FreeBSD.ORG
Subject: Re: gnu/14649: Perl "tutorials" missing from documentation 
Date: Tue, 02 Nov 1999 11:41:19 +0200

 On Mon, 01 Nov 1999 10:31:39 PST, andyf@speednet.com.au wrote:
 
 > 'man perl' mentions three sections: perlopentut, perlreftut,
 > and perlthrtut, but they are not built/installed by 'make world'.
 > 
 > It looks like they were left out on purpose.  Why?
 
 In which release of perl were they first featured?
 
 Ciao,
 Sheldon.
 

From: Sheldon Hearn <sheldonh@uunet.co.za>
To: andyf@speednet.com.au
Cc: freebsd-gnats-submit@FreeBSD.ORG
Subject: Re: gnu/14649: Perl "tutorials" missing from documentation 
Date: Tue, 02 Nov 1999 11:47:50 +0200

 On Mon, 01 Nov 1999 10:31:39 PST, andyf@speednet.com.au wrote:
 
 > >Fix:
 > Either the man page for perl should be changed, or the makefiles in
 > src/gnu/usr.bin/perl/pod/* should include the missing sections.
 
 Can you try this through a ``make world'' without NOCLEAN and see
 whether it
 
 	a) Has the desired effect
 
 	and
 
 	b) Causes any problems
 
 ?
 
 Thanks,
 Sheldon.
 
 Index: Makefile
 ===================================================================
 RCS file: /home/ncvs/src/gnu/usr.bin/perl/pod/pod/Makefile,v
 retrieving revision 1.4
 diff -u -d -r1.4 Makefile
 --- Makefile	1999/08/27 23:36:19	1.4
 +++ Makefile	1999/11/02 09:46:24
 @@ -8,8 +8,9 @@
  	perlfaq3.pod perlfaq4.pod perlfaq5.pod perlfaq6.pod perlfaq7.pod \
  	perlfaq8.pod perlfaq9.pod perlform.pod perlfunc.pod perlguts.pod \
  	perlhist.pod perlipc.pod perllocale.pod perllol.pod perlmod.pod \
 -	perlmodinstall.pod perlmodlib.pod perlobj.pod perlop.pod perlpod.pod \
 -	perlport.pod perlre.pod perlref.pod perlrun.pod perlsec.pod \
 +	perlmodinstall.pod perlmodlib.pod perlobj.pod perlop.pod \
 +	perlopentut.pod perlpod.pod perlport.pod perlre.pod perlref.pod \
 +	perlreftut.pod perlrun.pod perlsec.pod \
  	perlstyle.pod perlsub.pod perlsyn.pod perltie.pod perltoc.pod \
  	perltoot.pod perltrap.pod perlvar.pod perlxs.pod perlxstut.pod
  
 

From: Andy Farkas <andyf@speednet.com.au>
To: Sheldon Hearn <sheldonh@uunet.co.za>
Cc: freebsd-gnats-submit@FreeBSD.ORG
Subject: Re: gnu/14649: Perl "tutorials" missing from documentation 
Date: Thu, 4 Nov 1999 18:03:19 +1100 (EST)

 > 
 > Can you try this through a ``make world'' without NOCLEAN and see
 > whether it
 > 
 > 	a) Has the desired effect
 > 
 > 	and
 > 
 > 	b) Causes any problems
 > 
 > ?
 > 
 > Thanks,
 > Sheldon.
 
 Yes, a buildworld/installworld was ok.  'man perlopentut' gives you a
 man page.
 
 You left out perlthrtut.pod though...
 
 > Index: Makefile
 > ===================================================================
 > RCS file: /home/ncvs/src/gnu/usr.bin/perl/pod/pod/Makefile,v
 > retrieving revision 1.4
 > diff -u -d -r1.4 Makefile
 > --- Makefile	1999/08/27 23:36:19	1.4
 > +++ Makefile	1999/11/02 09:46:24
 > @@ -8,8 +8,9 @@
 >  	perlfaq3.pod perlfaq4.pod perlfaq5.pod perlfaq6.pod perlfaq7.pod \
 >  	perlfaq8.pod perlfaq9.pod perlform.pod perlfunc.pod perlguts.pod \
 >  	perlhist.pod perlipc.pod perllocale.pod perllol.pod perlmod.pod \
 > -	perlmodinstall.pod perlmodlib.pod perlobj.pod perlop.pod perlpod.pod \
 > -	perlport.pod perlre.pod perlref.pod perlrun.pod perlsec.pod \
 > +	perlmodinstall.pod perlmodlib.pod perlobj.pod perlop.pod \
 > +	perlopentut.pod perlpod.pod perlport.pod perlre.pod perlref.pod \
 > +	perlreftut.pod perlrun.pod perlsec.pod \
 >  	perlstyle.pod perlsub.pod perlsyn.pod perltie.pod perltoc.pod \
 >  	perltoot.pod perltrap.pod perlvar.pod perlxs.pod perlxstut.pod
 >  
 > 
 
 --
  
  :{ andyf@speednet.com.au
   
         Andy Farkas
     System Administrator
    Speednet Communications
  http://www.speednet.com.au/
   
 
 
 

From: Sheldon Hearn <sheldonh@uunet.co.za>
To: Andy Farkas <andyf@speednet.com.au>
Cc: freebsd-gnats-submit@FreeBSD.ORG
Subject: Re: gnu/14649: Perl "tutorials" missing from documentation 
Date: Thu, 04 Nov 1999 10:28:53 +0200

 On Thu, 04 Nov 1999 18:03:19 +1100, Andy Farkas wrote:
 
 > You left out perlthrtut.pod though...
 
 Indeed. Didn't spot it in your report, although I see that it _is_
 there.
 
 Thanks,
 Sheldon.
 
State-Changed-From-To: open->suspended 
State-Changed-By: sheldonh 
State-Changed-When: Wed Nov 17 04:25:50 PST 1999 
State-Changed-Why:  
Fixed in CURRENT in gnu/usr.bin/perl/pod/pod/Makefile rev 1.5.  I'll 
probably MFC straight away, but I'll leave this suspended in case I  
forget. 
State-Changed-From-To: suspended->closed 
State-Changed-By: sheldonh 
State-Changed-When: Wed Nov 17 05:09:04 PST 1999 
State-Changed-Why:  
Merged from CURRENT in rev 1.2.2.3. 


Responsible-Changed-From-To: markm->sheldonh 
Responsible-Changed-By: sheldonh 
Responsible-Changed-When: Wed Nov 17 05:09:04 PST 1999 
Responsible-Changed-Why:  
Mark was happy for me to do it. 
>Unformatted:
