Bug 120152

Summary: dev-handbook/tools-intro.html claims perl in base system
Product: Documentation Reporter: M. Voorhis <mvoorhis>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description M. Voorhis 2008-01-30 14:50:00 UTC
The file doc/en/books/developers-handbook/tools-intro.html claims:

   Compilers for C, C++, and Fortran and an assembler come with the
   basic system, not to mention a Perl interpreter and classic UNIX
   tools such as sed and awk.

Fix: 

I'd remove the reference to Perl in this sentence, rewriting:

   Compilers for C, C++, and Fortran and an assembler come with the
   basic system, not to mention classic UNIX tools such as sed and
   awk.

The next sentence in the file refers to additional tools being
available in the ports collection.  We could point people to the
next section (developers-handbook/tools-programming.html) maybe
with a hyperlink, so that impatient readers could quickly establish
that getting Perl was an easy thing:

   If that is not enough, there are many more compilers and
   interpreters in the Ports collection--See sections 2.3.2 and
   2.3.3 of this Handbook for more information.
How-To-Repeat: 
Read the relevant section (2.2 Introduction) of a recent developer's
handbook, first sentence.  My handbook was cvsup'd from the docs
on the 29th January 2008, in the afternoon US/Eastern time.
Comment 1 Mark Linimon 2008-01-30 15:56:22 UTC
IIRC Fortran is gone, too.

mcl
Comment 2 minimarmot 2008-02-03 02:57:51 UTC
I thought that the Fortran compiler had been removed from the base
system for 7.0 -- please correct me if I'm wrong.

-Ben Kaduk
Comment 3 dfilter service freebsd_committer freebsd_triage 2008-02-03 18:26:38 UTC
brueffer    2008-02-03 18:26:28 UTC

  FreeBSD doc repository

  Modified files:
    en_US.ISO8859-1/books/developers-handbook/tools chapter.sgml 
  Log:
  Don't claim that Perl and Fortran are in the base system, add a note
  about the next section describing some of the options from the ports
  collection.
  
  PR:             120152
  Submitted by:   Michael Voorhis <mvoorhis@cs.wpi.edu>
  
  Revision  Changes    Path
  1.48      +5 -3      doc/en_US.ISO8859-1/books/developers-handbook/tools/chapter.sgml
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
Comment 4 Christian Brueffer freebsd_committer freebsd_triage 2008-02-03 18:26:47 UTC
State Changed
From-To: open->closed

I've removed Perl and Fortran and added some text along the 
lines that you've suggested.  Thanks!