From martink@bredband.net  Thu Mar  6 10:10:00 2003
Return-Path: <martink@bredband.net>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 9FA8D37B40C
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  6 Mar 2003 10:10:00 -0800 (PST)
Received: from mf2.bredband.net (mf2.bredband.net [195.54.106.37])
	by mx1.FreeBSD.org (Postfix) with ESMTP id DF83743F3F
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  6 Mar 2003 10:09:58 -0800 (PST)
	(envelope-from martink@bredband.net)
Received: from c-e93a70d5.036-23-6f72652.cust.bredbandsbolaget.se
          ([213.112.58.233]) by mf2.bredband.net with ESMTP
          id <20030306180957.DBJB273.mf2@c-e93a70d5.036-23-6f72652.cust.bredbandsbolaget.se>
          for <FreeBSD-gnats-submit@freebsd.org>;
          Thu, 6 Mar 2003 19:09:57 +0100
Received: by c-e93a70d5.036-23-6f72652.cust.bredbandsbolaget.se (Postfix, from userid 1001)
	id 7E9B22E021; Thu,  6 Mar 2003 19:09:57 +0100 (CET)
Message-Id: <20030306180957.7E9B22E021@c-e93a70d5.036-23-6f72652.cust.bredbandsbolaget.se>
Date: Thu,  6 Mar 2003 19:09:57 +0100 (CET)
From: Martin Karlsson <mk-freebsd@bredband.net>
Reply-To: Martin Karlsson <mk-freebsd@bredband.net>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] nsgmls -s errors and sect. 3.2.1 of the fdp-primer
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         48980
>Category:       docs
>Synopsis:       [patch] nsgmls -s errors and sect. 3.2.1 of the fdp-primer
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Mar 06 10:10:08 PST 2003
>Closed-Date:    Sun Nov 05 18:34:04 GMT 2006
>Last-Modified:  Sun Nov  5 18:40:27 GMT 2006
>Originator:     Martin Karlsson
>Release:        FreeBSD 5.0-RELEASE-p4 i386
>Organization:
>Environment:
System: FreeBSD c-e93a70d5.036-23-6f72652.cust.bredbandsbolaget.se 5.0-RELEASE-p4 FreeBSD 5.0-RELEASE-p4 #0: Tue Mar 4 10:51:59 CET 2003 root@:/usr/obj/usr/src/sys/K20030304 i386


	
>Description:
	Section 3.2.1 of the fdp-primer shows some environment variables
for use with the FDP and SGML files. As pointed out by Warren Block 
(Message-ID: Pine.BSF.4.21.0212021241330.8913-100000@wonkity.com) in 
an e-mail to the doc mailing list, running nsgmls -s on an SGML file,
with these environment variables set, produces errors. This patch swaps 
the docbook and iso8879 lines so that the docbook line is first 
(per Warren's suggestion), and this appears to fix the problem.
>How-To-Repeat:
	Use the environment variables shown in section 3.2.1 of the
fdp-primer, and test an SGML file with nsgmls -s foo.sgml.
>Fix:

	 
--- books/fdp-primer/sgml-primer/chapter.sgml.orig	Thu Mar  6 04:21:08 2003
+++ books/fdp-primer/sgml-primer/chapter.sgml	Thu Mar  6 04:58:34 2003
@@ -360,9 +360,9 @@
 	    
 	    <programlisting>SGML_ROOT=/usr/local/share/sgml	    
 SGML_CATALOG_FILES=${SGML_ROOT}/jade/catalog
-SGML_CATALOG_FILES=${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
-SGML_CATALOG_FILES=${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
 SGML_CATALOG_FILES=${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES
+SGML_CATALOG_FILES=${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
+SGML_CATALOG_FILES=${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
 SGML_CATALOG_FILES=/usr/doc/share/sgml/catalog:$SGML_CATALOG_FILES
 SGML_CATALOG_FILES=/usr/doc/en_US.ISO8859-1/share/sgml/catalog:$SGML_CATALOG_FILES
 export SGML_CATALOG_FILES</programlisting>
@@ -374,9 +374,9 @@
 	    
 	    <programlisting>setenv SGML_ROOT /usr/local/share/sgml
 setenv SGML_CATALOG_FILES ${SGML_ROOT}/jade/catalog
-setenv SGML_CATALOG_FILES ${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
-setenv SGML_CATALOG_FILES ${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
 setenv SGML_CATALOG_FILES ${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES
+setenv SGML_CATALOG_FILES ${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
+setenv SGML_CATALOG_FILES ${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
 setenv SGML_CATALOG_FILES /usr/doc/share/sgml/catalog:$SGML_CATALOG_FILES
 setenv SGML_CATALOG_FILES /usr/doc/en_US.ISO8859-1/share/sgml/catalog:$SGML_CATALOG_FILES</programlisting>
           </example>


>Release-Note:
>Audit-Trail:

From: Giorgos Keramidas <keramida@freebsd.org>
To: Martin Karlsson <mk-freebsd@bredband.net>
Cc: bug-followup@freebsd.org
Subject: Re: docs/48980: [PATCH] nsgmls -s errors and sect. 3.2.1 of the fdp-primer
Date: Sun, 5 Nov 2006 19:56:35 +0200

 On 2003-03-06 19:09, Martin Karlsson <mk-freebsd@bredband.net> wrote:
 > 	Section 3.2.1 of the fdp-primer shows some environment variables
 > for use with the FDP and SGML files. As pointed out by Warren Block 
 > (Message-ID: Pine.BSF.4.21.0212021241330.8913-100000@wonkity.com) in 
 > an e-mail to the doc mailing list, running nsgmls -s on an SGML file,
 > with these environment variables set, produces errors. This patch swaps 
 > the docbook and iso8879 lines so that the docbook line is first 
 > (per Warren's suggestion), and this appears to fix the problem.
 > >How-To-Repeat:
 > 	Use the environment variables shown in section 3.2.1 of the
 > fdp-primer, and test an SGML file with nsgmls -s foo.sgml.
 
 Hi Martin,
 
 Using nsgmls is not the recommended way of building or testing the
 documentation, as far as I know.  If you use the doc/ Makefiles, then
 the correct SGML_CATALOG_FILES will be used.  You can even build the
 doc/ tree _without_ _anything_ in SGML_CATALOG_FILES.
 
 I'm not sure I would find it nice if we started recommending that people
 bypass the entire doc/ Makefile framework and use nsgmls manually
 themselves.
 
 - Giorgos
 
Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Sun Nov 5 18:26:42 UTC 2006 
Responsible-Changed-Why:  
I know why this happens.  I'll take care of documenting the 
cause and commiting the fix. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=48980 
State-Changed-From-To: open->closed 
State-Changed-By: keramida 
State-Changed-When: Sun Nov 5 18:32:39 UTC 2006 
State-Changed-Why:  
Committed in revision 1.46 of 
doc/en_US.ISO8859-1/books/fdp-primer/sgml-primer/chapter.sgml,v 

Thanks 

http://www.freebsd.org/cgi/query-pr.cgi?pr=48980 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/48980: commit references a PR
Date: Sun,  5 Nov 2006 18:32:12 +0000 (UTC)

 keramida    2006-11-05 18:32:05 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/fdp-primer/sgml-primer chapter.sgml 
   Log:
   The docbook/4.1 `dbcent.mod' module contains references to public entities
   first defined in ${SGMLROOT}/html/catalog and ${SGML_ROOT}/iso8879/catalog.
   By setting the SGML_CATALOG_FILES in the order suggested until now, we end
   up with a value of SGML_CATALOG_FILES like (wrapped to keep the length of
   the lines reasonable):
   
     /usr/doc/en_US.ISO8859-1/share/sgml/catalog:/usr/doc/share/sgml/catalog:\
     /usr/local/share/sgml/docbook/4.1/catalog:/usr/local/share/sgml/html/catalog:\
     /usr/local/share/sgml/iso8879/catalog:/usr/local/share/sgml/jade/catalog
   
   This means that when `dbcent.mod' refers to entities like %ISOamsa; they
   are not known already (because they are defined in catalog files later in
   the search path, not loaded by nsgmls yet).  This results in errors like:
   
     nsgmls:/usr/local/share/sgml/docbook/4.1/dbcent.mod:54:0:E: \
     cannot open "/usr/local/share/sgml/docbook/4.1/iso-amsa.gml" \
     (No such file or directory)
   
   By rearranging the order of the catalog files a bit, we can convince nsgmls
   to load the `html' and `iso8879' public entities first, and make it
   possible to use nsgmls to validate DocBook SGML documents too (instead of
   HTML only).
   
   PR:             docs/48980
   Submitted by:   Martin Karlsson <mk-freebsd@bredband.net>
   
   Revision  Changes    Path
   1.46      +4 -4      doc/en_US.ISO8859-1/books/fdp-primer/sgml-primer/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"
 
>Unformatted:
