From nobody@FreeBSD.ORG Sat Aug 28 10:31:36 1999
Return-Path: <nobody@FreeBSD.ORG>
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id 695A115601; Sat, 28 Aug 1999 10:31:36 -0700 (PDT)
Message-Id: <19990828173136.695A115601@hub.freebsd.org>
Date: Sat, 28 Aug 1999 10:31:36 -0700 (PDT)
From: efrias@sg505.net
Sender: nobody@FreeBSD.ORG
To: freebsd-gnats-submit@freebsd.org
Subject: docproj-primer does not mention where to get docbook extensions
X-Send-Pr-Version: www-1.0

>Number:         13442
>Category:       docs
>Synopsis:       docproj-primer does not mention where to get docbook extensions
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    nik
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Aug 28 10:40:01 PDT 1999
>Closed-Date:    Sun Oct 29 13:18:34 PST 2000
>Last-Modified:  Sun Oct 29 13:47:23 PST 2000
>Originator:     Eric Frias
>Release:        3.2-RELEASE
>Organization:
>Environment:
Standard 3.2-release with up-to-date ports collection
>Description:
Chapter 4 of Docproj-primer mentions using the FreeBSD extensions to DocBook,
"-//FreeBSD//DTD DocBook V3.1-Based Extension//EN", but never mentions
where to find these.  The extensions were not installed as part of the
textproj/docproj port, and it was not obvious where to find them.  

>How-To-Repeat:

>Fix:
* Include a section on where to find the extended DTD and how to install it, or
* add a port for it, and add it to the docproj meta-port, or
* make it obvious that this DTD is not to be used, and suggest an alternate DTD


>Release-Note:
>Audit-Trail:

From: Nik Clayton <nik@freebsd.org>
To: efrias@sg505.net
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/13442: docproj-primer does not mention where to get docbook extensions
Date: Sun, 29 Aug 1999 14:24:43 +0100

 On Sat, Aug 28, 1999 at 10:31:36AM -0700, efrias@sg505.net wrote:
 > >Description:
 > Chapter 4 of Docproj-primer mentions using the FreeBSD extensions to DocBook,
 > "-//FreeBSD//DTD DocBook V3.1-Based Extension//EN", but never mentions
 > where to find these.  The extensions were not installed as part of the
 > textproj/docproj port, and it was not obvious where to find them.  
 
 Ah.  That's because they're not in any port, they're part of the FreeBSD
 Documentation Project tree, which is the doc/ directory tree.
 
 I'm loathe to pull them out of there, because then
 
   a) other members of the FDP can't commit changes to them as necessary.
 
   b) we lose the publically visible CVS commit log and diffs as they
      are altered.
 
 This could, presumably be fixed by either updating the documentation to
 say this, or create a freebsd-docbook port that just grabs the files from
 wcarchive, or similar, and splats them in to the right place in the
 directory tree.
 
 However, the FDP would still use the ones in doc/share/sgml.
 
 Thoughts?
 
 N
 -- 
  [intentional self-reference] can be easily accommodated using a blessed,
  non-self-referential dummy head-node whose own object destructor severs
  the links.
     -- Tom Christiansen in <375143b5@cs.colorado.edu>
 

From: Paul Southworth <pauls@etext.org>
To: freebsd-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/13442: docproj-primer does not mention where to get docbook 
 extensions
Date: Tue, 02 May 2000 08:35:26 -0400

 This "bug" bit me too.  My problem was that the FreeBSD Doc Project
 Primer
 did not mention the FreeBSD extensions when discussing how to set up
 the SGML_CATALOG_FILES environment variable.
 
 Section 3.2.1, examples 3-6 and 3-7 should at least mention that you'll
 need
 to add /usr/doc/share/sgml/catalog to SGML_CATALOG_FILES.
 
 I agree that these extensions should not be separated from the doc tree
 - 
 it sounds like a recipe for trouble.
 
Responsible-Changed-From-To: freebsd-doc->nik 
Responsible-Changed-By: hoek 
Responsible-Changed-When: Sun May 21 00:32:52 PDT 2000 
Responsible-Changed-Why:  
Over to MAINTAINER. 

Re: "Thoughts" 

How about you put a copy of your email into the fdp.  Apropriately 
marked-up, of course.  This bugreport didn't sound like a "please move 
the files" request, but rather a "put this information into the fdp" 
suggestion. 
State-Changed-From-To: open->closed 
State-Changed-By: nik 
State-Changed-When: Sun Oct 29 13:18:34 PST 2000 
State-Changed-Why:  
Actually fixed this in 1.9 of fdp-primer/sgml-markup/chapter.sgml, back 
in September 1999.  Thanks for the PR. 

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