From owner-freebsd-doc Sat Jun 27 03:58:47 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id DAA26762 for freebsd-doc-outgoing; Sat, 27 Jun 1998 03:58:47 -0700 (PDT) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id DAA26747 for ; Sat, 27 Jun 1998 03:58:32 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.8.8/8.8.8) id LAA23028; Sat, 27 Jun 1998 11:25:26 +0100 (BST) (envelope-from nik) Message-ID: <19980627112526.06972@nothing-going-on.org> Date: Sat, 27 Jun 1998 11:25:26 +0100 From: Nik Clayton To: doc@FreeBSD.ORG Subject: SGML directory under /usr/doc, 'docproj' ports category Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.89.1i Organization: Nik at home, where there's nothing going on Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org 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