From owner-freebsd-doc Mon May 12 09:28:58 1997 Return-Path: Received: (from root@localhost) by hub.freebsd.org (8.8.5/8.8.5) id JAA19734 for doc-outgoing; Mon, 12 May 1997 09:28:58 -0700 (PDT) Received: from dutton4.it.siu.edu (dutton4.it.siu.edu [131.230.2.151]) by hub.freebsd.org (8.8.5/8.8.5) with ESMTP id JAA19723 for ; Mon, 12 May 1997 09:28:55 -0700 (PDT) Received: from dutton4.it.siu.edu (localhost [127.0.0.1]) by dutton4.it.siu.edu (8.8.5/8.8.5) with ESMTP id LAA06781 for ; Mon, 12 May 1997 11:32:02 -0500 (CDT) Message-Id: <199705121632.LAA06781@dutton4.it.siu.edu> Date: Mon, 12 May 1997 11:31:58 -0500 (CDT) From: Jim Dutton Subject: Fwd: Re: comp.mail.sendmail Frequently Asked Questions (fwd) To: freebsd-doc@freebsd.org MIME-Version: 1.0 Content-Type: TEXT/plain; CHARSET=US-ASCII Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk I am trying to help someone expand their FAQ capabilities similar to what y'all do. What do you use to generate your HTML docs and non-HTML docs? Thanks. ------ Forwarded message ------ From: jimd@slip106.termserv.siu.edu (Jim Dutton) Subject: Re: comp.mail.sendmail Frequently Asked Questions (fwd) Date: Sun, 11 May 1997 22:55:32 CST To: jimd@dutton4.it.siu.edu On May 10, Brad Knowles wrote: |-------------------- text of forwarded message follows --------------------| At 10:27 PM -0400 4/27/1997, Jim Dutton wrote: >I would like to ask that plus/minus signs or asterisks be used in the index to >denote new or changed items it would make the FAQ vastly more useful as then I >don't have to spend a lot of time rereading every "issue", just to find out >what has changed. Thanks. If I did anything with the current format, I'd do it with context diffs. However, I'm going to be doing a complete change of the FAQ when I "port" it over to using SGML-Tools (probably version 0.99.10 or later), so that the web page and text version can be generated from the same SGML source. At that point, since it will get regenerated each time, I don't know whether even context diffs would be able to help. If you can suggest a tool along the lines of SGML-Tools (where I could maintain one canonical source, and have that generate either HTML or text, with modifications to the actual output as appropriate for those formats), but which would also include some ability to retain a notion of what's "changed" since the last version, I'm all ears. -- Brad Knowles, MIME/PGP: brad@his.com comp.mail.sendmail FAQ Maintainer finger brad@his.com for my PGP Public Keys and Geek Code The comp.mail.sendmail FAQ is at |------------------------- end of forwarded message ------------------------|