Date: Sat, 27 Jun 1998 11:25:26 +0100 From: Nik Clayton <nik@nothing-going-on.demon.co.uk> To: doc@FreeBSD.ORG Subject: SGML directory under /usr/doc, 'docproj' ports category Message-ID: <19980627112526.06972@nothing-going-on.org>
next in thread | raw e-mail | index | archive | help
Folks,
I think I need a new directory in the doc/ collection, and I want some
feedback before I go off and do it.
As part of the LinuxDoc to DocBook conversion, I've built an extended
DocBook DTD with a few new elements ('hostname', 'username', 'devicename',
'faqlist'). This DTD is obviously in its own file. In addition, I'll need
a 'catalog' file that maps the public identifier for the DTD to the file.
That's (at least) 2 files that will be common to all the documentation.
There will probably be more as publically available stylesheets are
modified for the project. I'm wondering where to put them.
Two obvious choices.
doc/sgml/[freebsd.dtd|catalog]
or
doc/sgml/freebsd/[freebsd.dtd|catalog]
The first approach minimises the depth of the directory structure. The
second approach more closely mirrors the scheme under /usr/local/share/sgml.
Anyone got any particular preferences? If not, I'll probably go for the
first approach.
Secondly, I've just submitted a PR with a new port, textproc/docproj. This
is a meta-port, along the lines of 'x11/kde'. It just references the other
programs that are used by the documentation project, so
# cd /usr/ports/textproc/docproj
# make
will get you all the applications you need to build the FAQ and Handbook.
I plan on comitting it next week.
Does anyone think this is worthy of a ports virtual category as well,
in the same fashion that the kde applications are handled?
N
--
Work: nik@iii.co.uk | FreeBSD + Perl + Apache
Rest: nik@nothing-going-on.demon.co.uk | Remind me again why we need
Play: nik@freebsd.org | Microsoft?
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19980627112526.06972>