From linimon@lonesome.com  Wed Mar 17 10:42:20 2004
Return-Path: <linimon@lonesome.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 3E1BF16A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 17 Mar 2004 10:42:20 -0800 (PST)
Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 177B343D2F
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 17 Mar 2004 10:42:20 -0800 (PST)
	(envelope-from linimon@lonesome.com)
Received: from lonesome.lonesome.com (cs242743-143.austin.rr.com [24.27.43.143])
	(using TLSv1 with cipher EDH-RSA-DES-CBC3-SHA (168/168 bits))
	(No client certificate requested)
	by mail.soaustin.net (Postfix) with ESMTP id 9333014730
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 17 Mar 2004 12:42:19 -0600 (CST)
Received: from lonesome.lonesome.com (localhost.lonesome.com [127.0.0.1])
	by lonesome.lonesome.com (8.12.9/8.12.9) with ESMTP id i2HIgUc7078848
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 17 Mar 2004 12:42:30 -0600 (CST)
	(envelope-from linimon@lonesome.lonesome.com)
Received: (from linimon@localhost)
	by lonesome.lonesome.com (8.12.9/8.12.9/Submit) id i2HIgUas078847;
	Wed, 17 Mar 2004 12:42:30 -0600 (CST)
	(envelope-from linimon)
Message-Id: <200403171842.i2HIgUas078847@lonesome.lonesome.com>
Date: Wed, 17 Mar 2004 12:42:30 -0600 (CST)
From: Mark Linimon <linimon@lonesome.com>
Reply-To: Mark Linimon <linimon@lonesome.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] add Workarounds section to Porter's Handbook
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         64384
>Category:       docs
>Synopsis:       [patch] add Workarounds section to Porter's Handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    josef
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed Mar 17 10:50:25 PST 2004
>Closed-Date:    Fri Mar 26 15:35:53 PST 2004
>Last-Modified:  Fri Mar 26 15:35:53 PST 2004
>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 #3: Thu Jan 22 20:41:05 CST 2004 root@lonesome.lonesome.com:/usr/src/sys/compile/MULTIMEDIA i386
>Description:
	Recently I got bit by committing a port that broke 'make
	index' -- but only on older versions of FreeBSD that had the
	buggy make.  I knew I had seen something about this, but had
	saved no email about it.  So, let's just define a place towards
	the end of the Porter's Handbook to hold gotchas like this.
>How-To-Repeat:
	Collect some "arrows in the back".
>Fix:
	Tested via make.

	Note to docs gurus: I don't know if there is a preferred
	style to refer to a particular FreeBSD release, so I have
	them listed in plain text.

Index: book.sgml
===================================================================
RCS file: /mnt/FreeBSD/dcvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v
retrieving revision 1.385
diff -u -r1.385 book.sgml
--- book.sgml	17 Mar 2004 07:14:41 -0000	1.385
+++ book.sgml	17 Mar 2004 18:30:38 -0000
@@ -6639,6 +6639,30 @@
 	  entirely.</para>
       </sect1>
 
+      <sect1 id="dads-workarounds">
+	<title>Necessary workarounds</title>
+
+	<para>Sometimes it is necessary to work around bugs in
+	  software included with older versions of FreeBSD.</para>
+
+	<itemizedlist>
+	  <listitem>
+	    <para>Some versions of &man.make.1; were broken
+	      on at least 4.8 and 5.0 with respect to handling
+	      comparisons based on <makevar>OSVERSION</makevar>.
+	      This would often lead to failures during
+	      <command>make describe</command> (and thus, the overall
+	      ports <command>make index</command>).  The workaround is
+	      to enclose the conditional comparison in spaces, e.g.:
+	      <programlisting>if ( OSVERSION > 500023 )</programlisting>
+	      Be aware that test-installing a port on 4.9 or 5.2
+	      will <emphasis>not</emphasis> detect this problem.</para>
+	  </listitem>
+
+	</itemizedlist>
+
+      </sect1>
+
       <sect1 id="dads-misc">
 	<title>Miscellanea</title>
 
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->josef 
Responsible-Changed-By: josef 
Responsible-Changed-When: Fri Mar 26 13:48:58 PST 2004 
Responsible-Changed-Why:  
i'll take thins one. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=64384 
State-Changed-From-To: open->closed 
State-Changed-By: josef 
State-Changed-When: Fri Mar 26 15:35:36 PST 2004 
State-Changed-Why:  
committed, thanks 

http://www.freebsd.org/cgi/query-pr.cgi?pr=64384 
>Unformatted:
