From owner-freebsd-doc Tue Jun 4 19:06:48 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.5/8.7.3) id TAA02591 for doc-outgoing; Tue, 4 Jun 1996 19:06:48 -0700 (PDT) Received: from distortion.eng.umd.edu (distortion.eng.umd.edu [129.2.98.6]) by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id TAA02585 for ; Tue, 4 Jun 1996 19:06:44 -0700 (PDT) Received: from ginger.eng.umd.edu (ginger.eng.umd.edu [129.2.98.204]) by distortion.eng.umd.edu (8.7.5/8.7.3) with ESMTP id WAA13283; Tue, 4 Jun 1996 22:06:39 -0400 (EDT) Received: (from chuckr@localhost) by ginger.eng.umd.edu (8.7.5/8.7.3) id WAA01461; Tue, 4 Jun 1996 22:06:38 -0400 (EDT) Date: Tue, 4 Jun 1996 22:06:37 -0400 (EDT) From: Chuck Robey X-Sender: chuckr@ginger.eng.umd.edu To: "Jordan K. Hubbard" cc: Sean Kelly , jfieber@indiana.edu, grog@lemis.de, doc@freebsd.org Subject: Re: How do I write this SGML stuff? In-Reply-To: <6879.833939094@time.cdrom.com> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk On Tue, 4 Jun 1996, Jordan K. Hubbard wrote: > > If you guys would adopt any system for producing docs that's documented > > enough so I could actually use it, I'd be real happy. Tossing linuxdoc > > would make my day. > > Ain't gonna happen though - too much invested in it for a wholesale replacement, unless you're volunteering to rewrite the handbook and FAQ documents from > scratch in a comfortably finite period of time.. :-) > > I have to wonder why you can handle troff (yuck!) and not SGML > though. It's not as if the markup languages are THAT arcane, and if > you've learned one you should be able to learn the other (the rest of > us did, and we had nothing more to go on than the examples :-). I need examples of stuff. Show me an example of a table. I could do that trivially in either troff or LaTeX, but I can't find any in the handbook, and there's no explanation anywhere I can find. I could even turn on underlining, only one kind of emphasis. The idea of having to go thru thousands of lines looking for one example, it makes it too hard to figure out. I did do a doc, and it got me even more frustrated. ----------------------------+----------------------------------------------- Chuck Robey | Interests include any kind of voice or data chuckr@eng.umd.edu | communications topic, C programming, and Unix. 9120 Edmonston Ct #302 | Greenbelt, MD 20770 | I run Journey2 and n3lxx, both FreeBSD (301) 220-2114 | version 2.2 current -- and great FUN! ----------------------------+-----------------------------------------------