From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Robert J. Chassell" Newsgroups: gmane.emacs.devel Subject: Re: Texinfo doc for GDB-UI Date: Tue, 24 Dec 2002 12:43:45 +0000 (UTC) Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <15879.34324.916528.669630@nick.uklinux.net> Reply-To: bob@rattlesnake.com NNTP-Posting-Host: main.gmane.org X-Trace: main.gmane.org 1040733900 22973 80.91.224.249 (24 Dec 2002 12:45:00 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Tue, 24 Dec 2002 12:45:00 +0000 (UTC) Cc: emacs-devel@gnu.org Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 18QoQc-0005yH-00 for ; Tue, 24 Dec 2002 13:44:58 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 18QoUB-0007ge-00 for ; Tue, 24 Dec 2002 13:48:39 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18QoPo-0005wv-03 for emacs-devel@quimby.gnus.org; Tue, 24 Dec 2002 07:44:08 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 18QoPX-0005vo-00 for emacs-devel@gnu.org; Tue, 24 Dec 2002 07:43:51 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 18QoPV-0005vY-00 for emacs-devel@gnu.org; Tue, 24 Dec 2002 07:43:50 -0500 Original-Received: from megalith.rattlesnake.com ([140.186.114.245] helo=localhost) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18QoPU-0005tF-00 for emacs-devel@gnu.org; Tue, 24 Dec 2002 07:43:49 -0500 Original-Received: by rattlesnake.com via sendmail from stdin id (Debian Smail3.2.0.114) Tue, 24 Dec 2002 12:43:45 +0000 (UTC) Original-To: nick@nick.uklinux.net In-reply-to: <15879.34324.916528.669630@nick.uklinux.net> (message from Nick Roberts on Mon, 23 Dec 2002 21:54:28 +0000) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1b5 Precedence: list List-Id: Emacs development discussions. List-Help: List-Post: List-Subscribe: , List-Archive: List-Unsubscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:10333 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:10333 Here is my attempt at writing something for gdb-ui.el for the emacs manual. ... Any comments ? In smallbook format, the @verb section produces overfull \hboxes, since the lines are too wide. Also, the offset vertical bars remain visibly offset. For an example of an Emacs screenshot as complex as this, you might follow the @image route. You already have a .txt file for Info; the GIMP can produce a screen shot in PostScript, PNG, or HTML format for other output formats. As a minimum, the doc has to look good when typeset for printing and on a Web page as well as in Info. Also, you will need alternative text for people who listen to the document using Emacspeak. (Think of someone driving a car as `situationally blind', as well as the permanently blind. With Eflite, you can now run Emacspeak using only free software. You have no need for proprietary software packages that its vendor no longer supports or for expensive hardware cards.) A side effect of creating a document that listens well is that it is also likely to work well for sighted people. I have not had time (nor will I) to read or listen to the contents... :-( Minor typo + It isalso possible to dive into structures.. ^^^^^^ ^^ should be + It is also possible to dive into structures. -- Robert J. Chassell Rattlesnake Enterprises http://www.rattlesnake.com GnuPG Key ID: 004B4AC8 http://www.teak.cc bob@rattlesnake.com