Bug 14649

Summary: Perl "tutorials" missing from documentation
Product: Base System Reporter: Andy Farkas <andyf>
Component: gnuAssignee: Sheldon Hearn <sheldonh>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: 3.3-STABLE   
Hardware: Any   
OS: Any   

Description Andy Farkas 1999-11-01 18:40:01 UTC
'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?

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.
How-To-Repeat: man perlopentut
Comment 1 Sheldon Hearn 1999-11-02 09:41:19 UTC
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.
Comment 2 Sheldon Hearn 1999-11-02 09:47:50 UTC
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
Comment 3 Sheldon Hearn freebsd_committer freebsd_triage 1999-11-02 09:47:59 UTC
Responsible Changed
From-To: freebsd-bugs->markm

Mark is Mr Perl, although I'm happy to commit this if he feels it's 
trivial. 

Comment 4 Andy Farkas 1999-11-04 07:03:19 UTC
> 
> 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/
Comment 5 Sheldon Hearn 1999-11-04 08:28:53 UTC
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.
Comment 6 Sheldon Hearn freebsd_committer freebsd_triage 1999-11-17 12:25:50 UTC
State Changed
From-To: open->suspended

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. 
Comment 7 Sheldon Hearn freebsd_committer freebsd_triage 1999-11-17 13:09:04 UTC
State Changed
From-To: suspended->closed

Merged from CURRENT in rev 1.2.2.3. 


Comment 8 Sheldon Hearn freebsd_committer freebsd_triage 1999-11-17 13:09:04 UTC
Responsible Changed
From-To: markm->sheldonh

Mark was happy for me to do it.