Bug 13441

Summary: incorrect path in SGML_CATALOG_FILES env variable
Product: Documentation Reporter: efrias <efrias>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description efrias 1999-08-28 18:30:01 UTC
In the FreeBSD Documentation Project Primer, 
example 3-6 and 3-7 suggest setting SGML_CATALOG_FILES to
${SGML_ROOT}/docbook/catalog:$SGML_CATALOG_FILES which 
was incorrect on my system.

Fix: 

$SGML_ROOT/docbook on my system contains subdirectories for each version:
2.4.1, 3.0, 3.1, and dsssl.  SGML_CATALOG_FILES should be pointed at
${SGML_ROOT}/docbook/3.1/catalog, or perhaps add a line for each versions.
Comment 1 nik freebsd_committer freebsd_triage 1999-08-29 14:21:45 UTC
On Sat, Aug 28, 1999 at 10:29:55AM -0700, efrias@sg505.net wrote:
> >Fix:
> $SGML_ROOT/docbook on my system contains subdirectories for each version:
> 2.4.1, 3.0, 3.1, and dsssl.  SGML_CATALOG_FILES should be pointed at
> ${SGML_ROOT}/docbook/3.1/catalog, or perhaps add a line for each versions.

Hmm.  The post-install target of the textproc/docbook port (which is a 
meta-port, which exists just to install all the others for you) builds
this catalog file.

It might make more sense if the individual docbook-* ports appended to this
file in their post-install target, and removed their entries when they
are pkg_delete'ed.  Suggestions for the best way to do this would be
appreciated.

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>
Comment 2 pauls 2000-05-02 13:30:15 UTC
I think doing a 'make install' in /usr/ports/textproc/dtd-catalogs
solves this problem.  That way everything shows up in
/usr/local/share/sgml/catalog.
Comment 3 alex freebsd_committer freebsd_triage 2000-06-20 12:22:02 UTC
State Changed
From-To: open->closed

Problem seems fixed as shown in the audit trail. 
In fact, all the docbook ports I have installed their part into 
the catalog file, e.g. the 3.1 one: 
@${ECHO} "CATALOG "${ISOCAT}"" >> ${INSTDIR}/3.1/catalog