From owner-freebsd-doc@FreeBSD.ORG Mon May 30 14:16:18 2005 Return-Path: X-Original-To: freebsd-doc@freebsd.org Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 40E6516A41C for ; Mon, 30 May 2005 14:16:18 +0000 (GMT) (envelope-from yar@comp.chem.msu.su) Received: from comp.chem.msu.su (comp.chem.msu.su [158.250.32.97]) by mx1.FreeBSD.org (Postfix) with ESMTP id 76BF043D4C for ; Mon, 30 May 2005 14:16:17 +0000 (GMT) (envelope-from yar@comp.chem.msu.su) Received: from comp.chem.msu.su (localhost [127.0.0.1]) by comp.chem.msu.su (8.13.3/8.13.3) with ESMTP id j4UEGFjg057005 for ; Mon, 30 May 2005 18:16:15 +0400 (MSD) (envelope-from yar@comp.chem.msu.su) Received: (from yar@localhost) by comp.chem.msu.su (8.13.3/8.13.3/Submit) id j4UEGFw6057004 for freebsd-doc@freebsd.org; Mon, 30 May 2005 18:16:15 +0400 (MSD) (envelope-from yar) Date: Mon, 30 May 2005 18:16:15 +0400 From: Yar Tikhiy To: freebsd-doc@freebsd.org Message-ID: <20050530141615.GA55963@comp.chem.msu.su> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.5.9i Subject: Building documents outside doc/ tree impossible? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 30 May 2005 14:16:18 -0000 Hi friends, My memory fails to tell me reliably if this was ever possible, but I've just found that building a document outside the doc/ tree fails due to errors regarding mailing list entities. Of course, I'm setting DOC_PREFIX to the actual location of the doc/ tree. Is this by design, due to a bug, or my fault? I've failed to find any suspicious Makefile.inc files in the tree or whatever. Here is an example using the "zip-drive" article with a very simple Makefile: %%% yar@bsd:~$cd ~/fbsd/doc/en_US.ISO8859-1/articles/zip-drive/ yar@bsd:~/fbsd/doc/en_US.ISO8859-1/articles/zip-drive$make lint /usr/local/bin/nsgmls -wempty -wunclosed -s -ifreebsd.urls.absolute -D /usr/obj/usr/home/yar/fbsd/doc/en_US.ISO8859-1/articles/zip-drive -c /usr/home/yar/fbsd/doc/en_US.ISO8859-1/share/sgml/catalog -c /usr/home/yar/fbsd/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/local/share/sgml/catalog.ports /usr/home/yar/fbsd/doc/en_US.ISO8859-1/articles/zip-drive/article.sgml # I.e., everything is OK if the document is built or lint'ed in the tree. # Now let's copy the document's directory to a different location... yar@bsd:~/fbsd/doc/en_US.ISO8859-1/articles/zip-drive$cp -R ../zip-drive /tmp yar@bsd:~/fbsd/doc/en_US.ISO8859-1/articles/zip-drive$cd /tmp/zip-drive yar@bsd:/tmp/zip-drive$make lint DOC_PREFIX=$HOME/fbsd/doc /usr/local/bin/nsgmls -wempty -wunclosed -s -ifreebsd.urls.absolute -D /usr/obj/usr/tmp/zip-drive -c /usr/home/yar/fbsd/doc/./share/sgml/catalog -c /usr/home/yar/fbsd/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/local/share/sgml/catalog.ports /usr/tmp/zip-drive/article.sgml /usr/local/bin/nsgmls:/usr/home/yar/fbsd/doc/./share/sgml/articles.ent:15:88:W: cannot generate system identifier for public text "-//FreeBSD//ENTITIES DocBook Mailing List Entities//EN" /usr/local/bin/nsgmls:/usr/home/yar/fbsd/doc/./share/sgml/articles.ent:16:14:E: reference to entity "mailing-lists" for which no system identifier could be generated /usr/local/bin/nsgmls:/usr/home/yar/fbsd/doc/./share/sgml/articles.ent:15:0: entity was defined here *** Error code 1 Stop in /usr/tmp/zip-drive. %%% -- Yar