From owner-doc-jp@jp.freebsd.org  Tue Sep  3 12:02:11 1996
Received: by mail.jp.freebsd.org (8.7.3+2.6Wbeta5/8.7.3) id MAA01336
	Tue, 3 Sep 1996 12:02:11 +0900 (JST)
Received: by mail.jp.freebsd.org (8.7.3+2.6Wbeta5/8.7.3) with SMTP id MAA01331
	for <doc-jp@jp.freebsd.org>; Tue, 3 Sep 1996 12:02:06 +0900 (JST)
Received: from amont.astec.co.jp (amont.astec.co.jp [172.20.10.1]) by tokyonet-entrance.astec.co.jp (8.6.12+2.5Wb7/3.4Wbeta5-astecMX2.3) with ESMTP id MAA23732 for <doc-jp@jp.freebsd.org>; Tue, 3 Sep 1996 12:01:58 +0900
Received: from adjanta.astec.co.jp (adjanta [172.20.12.5]) by amont.astec.co.jp (8.6.9+2.4W/3.4Wbeta5-astecNoMX2.3) with SMTP id MAA05476 for <doc-jp@jp.freebsd.org>; Tue, 3 Sep 1996 12:01:58 +0900
Received: by adjanta.astec.co.jp (4.1/astec-1.2)
	id AA06345; Tue, 3 Sep 96 12:01:57 JST
Message-Id: <9609030301.AA06345@adjanta.astec.co.jp>
To: doc-jp@jp.freebsd.org
X-Mailer: Mew version 1.05+ on Emacs 19.28.1, Mule 2.3
Mime-Version: 1.0
Content-Type: Multipart/Mixed;
	boundary="--Next_Part(Tue_Sep__3_12:01:03_1996)--"
Date: Tue, 03 Sep 1996 12:01:56 +0900
From: Hanai Hiroyuki <hanai@astec.co.jp>
Reply-To: doc-jp@jp.freebsd.org
X-Distribute: distribute [version 2.1 (Alpha) patchlevel=19]
X-Sequence: doc-jp 816
Subject: [doc-jp 816] Forward: Warning: SGML doc changes
Errors-To: owner-doc-jp@jp.freebsd.org
Sender: owner-doc-jp@jp.freebsd.org

----Next_Part(Tue_Sep__3_12:01:03_1996)--
Content-Type: Text/Plain; charset=iso-2022-jp

$B$O$J$$!sLdBj$J$1$l$P$$$$$s$@$1$I!D(B $B$G$9(B.

FreeBSD$B%I%-%e%a%s%H$N07$$(B, $B$H$$$&$+07$&$?$a$N%D!<%k$,(B
$BJQ$o$j$^$9(B. doc@freebsd.org $B$KMh$?(B John Fieber $B$+$i$N%a!<%k$rIU$1$H$-$^$9(B.

$BMWE@(B
     $B!&(BSGML$BJ8=q%$%s%9%?%s%9$r07$&(B instant $B$H$+$C$F$$$&%D!<%k$r;H$&(B.
       $B$3$l$N%*%j%8%J%k$O(B OSF $B$+$iMh$F$$$k(B.

     $B!&(Bsgmlsasp $B$H(B rast $B$O$b$&I,MW$J$$(B.

     $B!&(BDTD$B$O<h$j4:$($:$^$@(B linuxdoc $B$@$,(B, $B$=$N$&$A(B Docbook $B$K0\9T$7$?$$(B.

$BLdBj$O(B instant $B$C$F$$$&%D!<%k$J$s$G$9$,(B, $BKM$O$3$l$OCN$i$J$+$C$?$N$G(B
$BO"Mm$r$H$C$F;H$C$F$_$h$&$H;W$$$^$9(B.
DTD $B$r(B Docbook(HaL Computer Systems, Inc. $B$H(B O'Reilly & Associates, Inc.
$B$,%a%$%s%F%J%s%9$7$F$$$k(B) $B$KJQ$($k$N$O;?@.$J$s$G$9$,(B.

$BNkLZ$5$s(B, $BCN$j$^$;$s$+(B?

-----$B$O$J$$(B

----Next_Part(Tue_Sep__3_12:01:03_1996)--
Content-Type: Message/rfc822

Return-Path: owner-freebsd-doc@freefall.freebsd.org
Received: from tokyonet-entrance.astec.co.jp (tokyonet-entrance.astec.co.jp [172.20.10.6]) by amont.astec.co.jp (8.6.9+2.4W/3.4Wbeta5-astecNoMX2.3) with ESMTP id LAA04831 for <hanai>; Tue, 3 Sep 1996 11:26:50 +0900
Received: from tora.eccosys.com (tora.eccosys.com [133.246.113.65]) by tokyonet-entrance.astec.co.jp (8.6.12+2.5Wb7/3.4Wbeta5-astecMX2.3) with ESMTP id LAA22604 for <hanai@astec.co.jp>; Tue, 3 Sep 1996 11:26:49 +0900
Received: from mail.jp.freebsd.org (mail.jp.freebsd.org [133.11.70.161]) by tora.eccosys.com (8.7.5/8.6.9) with ESMTP id LAA19315; Tue, 3 Sep 1996 11:26:37 +0900 (JST)
Received: by mail.jp.freebsd.org (8.7.3+2.6Wbeta5/8.7.3) with ESMTP id LAA01218
	Tue, 3 Sep 1996 11:26:30 +0900 (JST)
Received: from localhost (daemon@localhost)
          by freefall.freebsd.org (8.7.5/8.7.3) with SMTP id TAA24449;
          Mon, 2 Sep 1996 19:17:20 -0700 (PDT)
Received: (from root@localhost)
          by freefall.freebsd.org (8.7.5/8.7.3) id TAA24420
          for doc-outgoing; Mon, 2 Sep 1996 19:16:52 -0700 (PDT)
Received: from fallout.campusview.indiana.edu (fallout.campusview.indiana.edu [149.159.1.1])
          by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id TAA24413;
          Mon, 2 Sep 1996 19:16:46 -0700 (PDT)
Received: from localhost (jfieber@localhost) by fallout.campusview.indiana.edu (8.7.5/8.7.3) with SMTP id VAA04169; Mon, 2 Sep 1996 21:16:45 -0500 (EST)
X-Authentication-Warning: fallout.campusview.indiana.edu: jfieber owned process doing -bs
Date: Mon, 2 Sep 1996 21:16:44 -0500 (EST)
From: John Fieber <jfieber@indiana.edu>
X-Sender: jfieber@fallout.campusview.indiana.edu
Reply-To: John Fieber <jfieber@indiana.edu>
To: doc@freebsd.org, core@freebsd.org
Subject: Warning: SGML doc changes
Message-ID: <Pine.BSI.3.95.960725090235.2588E-100000@Fieber-John.campusview.indiana.edu>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: owner-doc@freebsd.org
X-Loop: FreeBSD.org
Precedence: bulk

For some time, I've been blabbering about changes coming to the
SGML documentation tools.  I've got things together to the point
where I'm about ready to bring them in so here is a brief
summary.

instant: A new tool for manipulating SGML document instances.
	This is the core of the new doc conversion and useful for
	a variety of tasks dealing with SGML documents.  The tool
	originally came from OSF but is only supported in an
	ad-hoc fashion.  It carries a BSD compatible license.
	This version has been customized and enhanced by myself.
	Uncompressed source is about 280k.

sgmlsasp and rast: Instant makes the former useless and rast was
	never (as far as I know used), therefore these will be
	*removed*. Uncompressed source is about 32K

ISO 8879:1986 entity sets: These provide standard names for
	symbols not commonly found on keyboards.
	These are used by many DTDs, including Docbook and now
	linuxdoc.  This adds about 90K

Linuxdoc: This DTD had a numerous ugly hacks put in
	place to make up for shortcomings in the conversion tool
	(sgmlsasp).  A switch to instant allowed me to clean a
        bunch of the cruft out.  I have also switched from the
        homebrew entity sets to the ISO entity sets.  This may
        cause some small, but trivial to fix problems with old
        documents.  The element structure is unchanged.

sgmlfmt: This is still the tool for processing the FAQ and
	handbook.  The interface is completely unchanged, but
	thanks to instant, it is a bit simpler and some
	longstanding bugs are gone.  Ultimately this may become
        simple enough that a shell script will do.

Docbook: Ultimately the FAQ, handbook and future documentation
	will use this DTD which is well supported and widely used
	in the software industry.  However, the conversion to
	[nt]roff and HTML is not yet ready for prime-time.  The
	question: should it be brought in now so people can start
	tinkering with it, or should it be kept out until a later
	date?

Questions and comments welcome.

-john


== jfieber@indiana.edu ===========================================
== http://fallout.campusview.indiana.edu/~jfieber ================






----Next_Part(Tue_Sep__3_12:01:03_1996)----
