Building documents outside doc/ tree impossible?

[Yar Tikhiy]

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 at bsd:~$cd ~/fbsd/doc/en_US.ISO8859-1/articles/zip-drive/
yar at 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 at bsd:~/fbsd/doc/en_US.ISO8859-1/articles/zip-drive$cp -R ../zip-drive /tmp
yar at bsd:~/fbsd/doc/en_US.ISO8859-1/articles/zip-drive$cd /tmp/zip-drive
yar at 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