docs/120152: dev-handbook/tools-intro.html claims perl in base system

Michael Voorhis mvoorhis at cs.wpi.edu
Wed Jan 30 14:50:01 UTC 2008


>Number:         120152
>Category:       docs
>Synopsis:       dev-handbook/tools-intro.html claims perl in base system
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jan 30 14:50:00 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator:     Michael Voorhis
>Release:        FreeBSD 7.0-PRERELEASE i386
>Organization:
WPI Computer Science Dept.
>Environment:
System: FreeBSD xxx.wpi.edu 7.0-PRERELEASE FreeBSD 7.0-PRERELEASE #0: Thu Jan 17 11:26:40 EST 2008 root at xxx.wpi.edu:/usr/obj/FreeBSD/src-releng_7/src/sys/xxx i386
	
>Description:
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.

>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.

>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.



>Release-Note:
>Audit-Trail:
>Unformatted:



More information about the freebsd-doc mailing list