Date: Sun, 30 Apr 2000 15:10:05 -0700 (PDT) From: Nik Clayton <nik@freebsd.org> To: freebsd-doc@freebsd.org Subject: Re: docs/16439: fdp-primer - difficulties with split SGML files Message-ID: <200004302210.PAA56742@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/16439; it has been noted by GNATS. From: Nik Clayton <nik@freebsd.org> To: Karlheinz.Eckmeier@t-online.de Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/16439: fdp-primer - difficulties with split SGML files Date: Sun, 30 Apr 2000 22:05:18 +0100 Long quote kept for context. On Sat, Jan 29, 2000 at 03:42:15PM +0100, Karlheinz.Eckmeier@t-online.de wrote: > The last part in of "6.3.1.1.3 directory/chapter/sgml" says: > > <quote> > Each chapter.sgml file will not be a complete SGML document. In > particular, they will not have their own DOCTYPE line at the start > of the file. > > This is unfortunate for two reasons; > > * It makes it impossible to treat these as generic SGML files and > simply convert them to HTML, RTF, PS, and other formats in the > same way the main Handbook is generated. This would force you to > rebuild the Handbook every time you want to see the effect a change > as had on just one chapter. > > * Emacs' sgml-mode can not use it to determine the DTD to use, losing > useful benefits of sgml-mode (element completion, automatic > validation, and so on). > </quote> <snip> > I propose to change or to drop these two paragraphs because of > the following reasons: > > 1) Regarding the first paragraph I would like to suggest a different > approach. It is true, one cannot treat these "partial" SGML-files > the same as a complete SGML document. But using a little workaround > would allow to generate the output formats of only the part > actually being worked on: > - Create a template SGML file containing all the elements the > partial SGML files is missing (DOCTYPE, <book>,<part>). It also > contains an template external general entity to include a > partial SGML file at the appropriate place. > - Create a script with the following functions: > + When called with a partial SGML file as parameter it > passes the template file through sed to change the template > entity to include the specified partial SGML file and thus > creating a valid SGML document. > + Start the appropriate make process to generate the desired > output format. > + Print the contents of the jade log file to stdout > - Configure the compile command of xemacs to start the above > script when editing a SGML file. All the errors discovered by > jade (i.e. the contents of the jade log file) will show up in > the compilation buffer of xemacs and can be stepped through via > the "next-error" command of xemacs. > > I've build something like this for some other project running > along much the same lines (one big SGML document split into many > partial SGML files and distributed across serveral directories). > I'm sure it can be adapted to the structures used here if there > is any interest. Well, is there?? Please do. I'm getting bored with having to rebuild the entire handbook every time I want to test a change :-) > 2) The second paragraph is no longer valid. Maybe this was a problem > with older versions of psgml, but at least with current versions > of xemacs and psgml (I'm using xemacs-20.4 and psgml 1.2.0) it is > possible to make this work. Quite right. In fact, we do that already. I'll reword this section. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery 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?200004302210.PAA56742>