From ast@rumori.com  Wed Mar  6 23:12:33 2002
Return-Path: <ast@rumori.com>
Received: from rumori.com (client62-2-193-38.hispeed.ch [62.2.193.38])
	by hub.freebsd.org (Postfix) with ESMTP id 6C58837B404
	for <FreeBSD-gnats-submit@freebsd.org>; Wed,  6 Mar 2002 23:12:23 -0800 (PST)
Received: (from ast@localhost)
	by rumori.com (8.11.6/8.11.6) id g277CIi10345;
	Thu, 7 Mar 2002 08:12:18 +0100 (MET)
	(envelope-from ast)
Message-Id: <200203070712.g277CIi10345@rumori.com>
Date: Thu, 7 Mar 2002 08:12:18 +0100 (MET)
From: Adrian Steinmann <ast@marabu.ch>
Reply-To: Adrian Steinmann <ast@marabu.ch>
To: FreeBSD-gnats-submit@freebsd.org
Subject: make release fails in documentation for RELEASETAG=RELENG_4_5 as of Feb 28th
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         35620
>Category:       docs
>Synopsis:       make release fails in documentation for RELEASETAG=RELENG_4_5 as of Feb 28th
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    murray
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Mar 06 23:20:01 PST 2002
>Closed-Date:    Sat Apr 12 20:53:12 PDT 2003
>Last-Modified:  Sat Apr 12 20:53:12 PDT 2003
>Originator:     ast
>Release:        FreeBSD 4.4-STYX i386
>Organization:
Webgroup Consulting AG
>Environment:
System: FreeBSD rumori.com 4.4-STYX FreeBSD 4.4-STYX #2: Fri Aug 31 13:23:17 MEST 2001 root@rumori.com:/usr/src/sys/compile/RUM i386


	make release environment
>Description:
	make release fails in documentation for RELEASETAG=RELENG_4_5
	
	It seems that as of Feb 27th the
	src/release/doc/en_US.ISO8859-1/relnotes/common/new.sgml file
	contains <port> tags which causes make release on the RELENG_4_5
	branch to fail because that tag is not defined.
	
	
	cvs di -u -D27-Feb-02 -D28-Feb-02 /usr/src/release/doc/en_US.ISO8859-1/relnotes/common
	
	-  <pubdate>$FreeBSD: src/release/doc/en_US.ISO8859-1/relnotes/common/new.sgml,v 1.286 2002/02/23 06:00:56 bmah Exp $</pubdate>
	+  <pubdate>$FreeBSD: src/release/doc/en_US.ISO8859-1/relnotes/common/new.sgml,v 1.287 2002/02/27 05:10:38 dd Exp $</pubdate>
	
	...
	
	-    <port>emulators/linux_base-7</port> (RedHat 7.X emulation)
	+    <filename role="package">emulators/linux_base-7</filename> (RedHat 7.X emulation)
	
	..
	
	From make log:
	===> en_US.ISO8859-1/relnotes/alpha
	/bin/cp -p /usr/src/release/doc/en_US.ISO8859-1/relnotes/alpha/../../../../../../doc/share/misc/docbook.css docbook.css
	/usr/local/bin/jade -V nochunks -ioutput.html -d /usr/src/release/doc/en_US.ISO8859-1/relnotes/alpha/../../../share/sgml/default.dsl  -ioutput.html.images  -V %generate-article-toc% -D /usr/obj/usr/src/release/doc/en_US.ISO8859-1/relnotes/alpha -c /usr/src/release/doc/en_US.ISO8859-1/relnotes/alpha/../../../../../../doc/en_US.ISO8859-1/share/sgml/catalog -c /usr/src/release/doc/en_US.ISO8859-1/relnotes/alpha/../../../../../../doc/share/sgml/catalog  -c /usr/local/share/sgml/docbook/dsssl/modular/catalog -c /usr/local/share/sgml/iso8879/catalog  -c /usr/local/share/sgml/docbook/catalog -c /usr/local/share/sgml/jade/catalog  -c /usr/src/release/doc/en_US.ISO8859-1/relnotes/alpha/../../../en_US.ISO8859-1/share/sgml/catalog -c /usr/src/release/doc/en_US.ISO8859-1/relnotes/alpha/../../../share/sgml/catalog -t sgml /usr/src/release/doc/en_US.ISO8859-1/relnotes/alpha/article.sgml > article.html ||  (/bin/rm -f article.html && false)
	/usr/local/bin/jade:/usr/src/release/doc/en_US.ISO8859-1/relnotes/alpha/../common/../common/new.sgml:110:9:E: element "PORT" undefined
	/usr/local/bin/jade:/usr/src/release/doc/en_US.ISO8859-1/relnotes/alpha/../common/../common/new.sgml:279:44:E: element "PORT" undefined
	/usr/local/bin/jade:/usr/src/release/doc/en_US.ISO8859-1/relnotes/alpha/../common/../common/new.sgml:766:41:E: element "PORT" undefined
	/usr/local/bin/jade:/usr/src/release/doc/en_US.ISO8859-1/relnotes/alpha/../common/../common/new.sgml:777:43:E: element "PORT" undefined
	*** Error code 1

>How-To-Repeat:
	make release with RELEASETAG=RELENG_4_5
>Fix:

	define <port> tag or go back to pre-Feb 28th version of new.sgml
>Release-Note:
>Audit-Trail:

From: "Bruce A. Mah" <bmah@FreeBSD.ORG>
To: Adrian Steinmann <ast@marabu.ch>
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/35620: make release fails in documentation for RELEASETAG=RELENG_4_5 as of Feb 28th 
Date: Thu, 07 Mar 2002 10:38:26 -0800

 If memory serves me right, Adrian Steinmann wrote:
 
 > 	It seems that as of Feb 27th the
 > 	src/release/doc/en_US.ISO8859-1/relnotes/common/new.sgml file
 > 	contains <port> tags which causes make release on the RELENG_4_5
 > 	branch to fail because that tag is not defined.
 
 Support for <port> was removed, for reasons that are too long to go into
 here (the discussion is in the doc@ archive).
 
 As a work around, you can try building your release like this:
 
 make release RELEASETAG=RELENG_4_5 DOCRELEASETAG=RELEASE_4_5_0 ...
 
 This will use a slightly older version of the doc/ tree that still
 supports the <port> tag.  This means that if you build the Handbook, 
 FAQ, or other FDP documents as a part of your release, they'll have the 
 older content as well.
 
 FYI:  Nobody updates the release notes on the security fix branches.  
 They remain frozen with the contents that they had at the time the 
 corresponding release was tagged.  src/UPDATING contains patchlevel 
 information for security fix branches.
 
 It'd be nice if this "just worked", but I'm opposed to messing around
 with the release documentation on the security fix branches just to fix
 this.
 
 Bruce.
 
 

From: Dima Dorfman <dima@trit.org>
To: "Bruce A. Mah" <bmah@freebsd.org>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/35620: make release fails in documentation for RELEASETAG=RELENG_4_5 as of Feb 28th 
Date: Sun, 10 Mar 2002 08:59:48 +0000

 "Bruce A. Mah" <bmah@freebsd.org> wrote:
 >  If memory serves me right, Adrian Steinmann wrote:
 >  
 >  > 	It seems that as of Feb 27th the
 >  > 	src/release/doc/en_US.ISO8859-1/relnotes/common/new.sgml file
 >  > 	contains <port> tags which causes make release on the RELENG_4_5
 >  > 	branch to fail because that tag is not defined.
 >  
 >  Support for <port> was removed, for reasons that are too long to go into
 >  here (the discussion is in the doc@ archive).
 >  
 >  As a work around, you can try building your release like this:
 >  
 >  make release RELEASETAG=RELENG_4_5 DOCRELEASETAG=RELEASE_4_5_0 ...
 ...
 >  It'd be nice if this "just worked", but I'm opposed to messing around
 >  with the release documentation on the security fix branches just to fix
 >  this.
 
 I agree with this.  Do you have any suggestions on where we could
 document the fact that building older release notes with a newer doc
 tree may not work?  I'm mostly interested in preventing any
 hair-pulling this could result in.  In this case, the failure mode is
 pretty obvious, but that may not always be the case.  Worse yet, it
 might just produce incorrect output instead of failing to compile.
 
 [For those on -doc listening in: The general problem is that any
 infrastructure changes to the doc/ tree that aren't
 backwards-compatible might cause the release notes in the release
 branches to break.]
State-Changed-From-To: open->analyzed 
State-Changed-By: murray 
State-Changed-When: Mon Apr 7 03:50:11 PDT 2003 
State-Changed-Why:  
I have added a note to the new 'BUGS' section of release(7).  Thanks 
for bringing this to our attention.  I will MFC the man page addition 
later this week. 



Responsible-Changed-From-To: freebsd-doc->murray 
Responsible-Changed-By: murray 
Responsible-Changed-When: Mon Apr 7 03:50:11 PDT 2003 
Responsible-Changed-Why:  
I have added a note to the new 'BUGS' section of release(7).  Thanks 
for bringing this to our attention.  I will MFC the man page addition 
later this week. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=35620 
State-Changed-From-To: analyzed->closed 
State-Changed-By: murray 
State-Changed-When: Sat Apr 12 20:52:42 PDT 2003 
State-Changed-Why:  
The workaround has not been documented in both -CURRENT and -STABLE. 
Thanks for bringing this to our attention. 


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