Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 30 May 2005 18:16:15 +0400
From:      Yar Tikhiy <yar@comp.chem.msu.su>
To:        freebsd-doc@freebsd.org
Subject:   Building documents outside doc/ tree impossible?
Message-ID:  <20050530141615.GA55963@comp.chem.msu.su>

next in thread | raw e-mail | index | archive | help
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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20050530141615.GA55963>