From owner-freebsd-doc Wed Mar 12 9: 3:55 2003 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D8C3737B401 for ; Wed, 12 Mar 2003 09:03:53 -0800 (PST) Received: from pakastelohi.cypherpunks.to (pakastelohi.cypherpunks.to [213.130.163.34]) by mx1.FreeBSD.org (Postfix) with ESMTP id C417443FBD for ; Wed, 12 Mar 2003 09:03:52 -0800 (PST) (envelope-from shamrock@cypherpunks.to) Received: from VAIO650 (adsl-208-201-229-160.sonic.net [208.201.229.160]) (using TLSv1 with cipher RC4-MD5 (128/128 bits)) (No client certificate requested) by pakastelohi.cypherpunks.to (Postfix) with ESMTP id 7DBDF3664D for ; Wed, 12 Mar 2003 18:03:50 +0100 (CET) From: "Lucky Green" To: Subject: vs. &man.command.section Date: Wed, 12 Mar 2003 09:03:44 -0800 Message-ID: <00a601c2e8b9$58625bb0$6601a8c0@VAIO650> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook, Build 10.0.2627 Importance: Normal X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1106 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org Doc gurus, I wrote a new section for the FreeBSD Handbook to help users employ the new gbde(8) disk encryption features. The content is currently under review by the author of gbde. This is my first attempt at writing FreeBSD documentation, so please bear with me if some of my questions may have been answered elsewhere. Just send me a pointer. :-) 1) I read section 4.2.5.4 of the Documentation guide, but I still don't understand when to use gbde 8 and when to use &man.gbde.8 Is the former indexed while the latter is not? What determines whether one should choose one format over the other? 2) Is it required that every time a FreeBSD command is mentioned the command _must_ be surrounded by the tags? I have explanatory text paragraphs in which gbde is mentioned multiple times and having all these bold instances of gbde in the same paragraph looks strange to me (in the html output). 3) Is there a graphical editor that allows tagging of SGML text using drop-down lists or the like, similar to any number of HTML editors out there? I am currently using KDE's Kate, typing each tag by hand, which is a pain. Also, is there a graphical editor that performs tag matching? I.e., you click on a closing tag and the editor highlights everything between the opening and closing tags? 4) Is there an SGML source beautifier script or program that will parse the SGML document and based on the parsing perform indentations in conformance with the style guide? Thanks, --Lucky To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message