docs/61654: [patch] two minor additions to Porter's Handbook

Mark Linimon linimon at lonesome.com
Tue Jan 20 23:02:12 UTC 2004


>Number:         61654
>Category:       docs
>Synopsis:       [patch] two minor additions to Porter's Handbook
>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:   Tue Jan 20 15:00:26 PST 2004
>Closed-Date:
>Last-Modified:
>Originator:     Mark Linimon
>Release:        FreeBSD 4.9-PRERELEASE i386
>Organization:
Lonesome Dove Computing Services
>Environment:
System: FreeBSD lonesome.lonesome.com 4.9-PRERELEASE FreeBSD 4.9-PRERELEASE #0: Fri Sep 5 01:19:33 CDT 2003 linimon at lonesome.lonesome.com:/usr/src/sys/compile/MULTIMEDIA_DEBUG i386
	(n/a)
>Description:
	While reviewing the updated Porter's Handbook, I found one
	bit of text that was out of date, and one obvious thing to add.
>How-To-Repeat:
	(n/a)
>Fix:

--- book.sgml.dist	Tue Jan 20 16:33:11 2004
+++ book.sgml	Tue Jan 20 16:50:37 2004
@@ -2836,6 +2835,10 @@
 
 	<para>The COMMENT variable should immediately follow the MAINTAINER
 	  variable in the <filename>Makefile</filename>.</para>
+
+	<para>Please try to keep the COMMENT line less than 70
+	  characters, as it is displayed to users as a one-line
+	  summary of the port.</para>
       </sect1>
 
       <sect1 id="makefile-depend">
@@ -3798,8 +3801,8 @@
     <sect1 id="using-gnome">
       <title>Using GNOME</title>
 
-      <para>The FreeBSD/GNOME project uses a system called
-	<literal>GNOMENG</literal> to define which GNOME components a
+      <para>The FreeBSD/GNOME project uses its own set of variables
+	to define which GNOME components a
 	particular port uses. A
 	<ulink url="http://www.FreeBSD.org/gnome/docs/porting.html">comprehensive
 	list of these variables</ulink> exists within the FreeBSD/GNOME
>Release-Note:
>Audit-Trail:
>Unformatted:



More information about the freebsd-doc mailing list