unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: "Robert J. Chassell" <bob@rattlesnake.com>
Cc: psgml-devel@lists.sourceforge.net, emacs-devel@gnu.org
Subject: Re: Re: Key sequence C-c C-f C-e uses invalid prefix characters
Date: Fri, 17 Jan 2003 12:42:54 +0000 (UTC)	[thread overview]
Message-ID: <m18ZVpm-000IeIC@localhost> (raw)
In-Reply-To: <3E271D54.4060206@silmaril.ie> (message from Peter Flynn on Thu, 16 Jan 2003 21:00:04 +0000)

   ... The OP's complaint was -- in effect -- that he couldn't care
   less whether the "SGML" he produced was valid or not ...

Here is a possible solution for XML:

  * If the person provides a DTD use that ....

  * If the person does *not* provide a DTD use the texinfo.dtd
    provided in the texinfo-4.3 distribution in makeinfo/texinfo.dtd

  * Provide and document a simple command to convert an XML document
    using the texinfo.dtd and the texinfo.xsl to Texinfo.  (I am
    pretty sure a suitable conversion program already exists, but it
    needs documentation and maybe packaging in a shell script that
    calls the appropriate ancillary files.)

`makeinfo' already provides the option to convert a Texinfo source
file to an XML output file with the texinfo.dtd using the --xml option 

There is a major advantage to making the texinfo.dtd the default; with
it, you can convert the source XML (or "deep representation") file to
all the various different output (or "surface representation") formats
that people use.

Here is the argument favoring Texinfo, or a Texinfo-like mark up
language, using DocBook as the prime villain, and LaTeX as a
secondary.

DocBook is a widely used format that has a more complex DTD than
texinfo.dtd.  (Incidentally, `makeinfo' provides an option to convert
a Texinfo source to DocBook, but as said here, depending on how the
author writes the document, the reverse may be harder or impossible.)

  DocBook suffers two major problems, both fatal, neither technical:

     * DocBook documents are generally harder to read (both by novices
       and by experts) in their `deep representation' form, before
       being converted to formats to which readers listen or view.

       This means it is harder to edit the document.  Many people who
       use interfaces that hide the looks of the document do not
       perceive this as a problem because they write for that single
       interface or `surface representation'.  This leads us to the
       second, fatal problem:

     * Writers often use DocBook features.  Indeed, this is something
       you would expect and generally welcome!  The features were
       designed to be used!

       Unfortunately, DocBook was designed for people who are
       situationally sighted -- not blind, not driving a car, not
       working on something to which they must apply visual attention.
       In this sense, DocBook is like LaTeX.

       The problem, and this is the key, is that most people who write
       DocBook documents fail to write them for a wide range of
       readers.

    People who write for Texinfo also often fail to consider their
    different kinds of readers, but Texinfo discourages `high res
    visual presumptions'.  

    Texinfo does a better job of ensuring that authors write documents
    that are readable and listenable by everyone than does the
    alternative, which for DocBook or LaTeX is to ask authors to
    describe their picture, an action which may take `a thousand
    words', in addition to displaying the picture for those who can
    view it.

    Technically, you can write a document using DocBook or LaTeX that
    converts well to widely different output representations, not just
    to one output representation.  The problem is, enough people
    don't.

    Every time you write, please write for the following readers:

      * the blind person, whether permanently or situationally blind,
        who is listening to your work using Emacspeak

      * the person reading your document on a Web site, who has a fast
        Internet connection

      * the person reading your document on a Web site who has a slow
        Internet connection to your Web site and who is paying by the
        downloaded byte

      * the person reading your document efficiently, navigating
        around to parts quickly

      * the person reading your document on paper that has been
        printed by a high resolution printer

      * the person working on a slow machine or over a slow
        connection, who is reading your work, which is coming to him
        or her at less than 300 baud.  (And before those of you who
        are fortunate say that slowness is obsolete and never occurs
        nowadays, please note that that in my experience, slow
        connections still occur, even though most of the time, I have
        a 40kb/s telephone connection.)

    And, yes, as I was typing that last sentence, my Internet
    connection vanished, my dialer redialed and a voice said, "If you
    would like to make a call, please hang up and try again" ....
    Awkward connections occur everywhere.

-- 
    Robert J. Chassell                         Rattlesnake Enterprises
    http://www.rattlesnake.com                  GnuPG Key ID: 004B4AC8
    http://www.teak.cc                                     bob@gnu.org


-------------------------------------------------------
This SF.NET email is sponsored by: Thawte.com
Understand how to protect your customers personal information by implementing
SSL on your Apache Web Server. Click here to get our FREE Thawte Apache 
Guide: http://ads.sourceforge.net/cgi-bin/redirect.pl?thaw0029en

  reply	other threads:[~2003-01-17 12:42 UTC|newest]

Thread overview: 39+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <m3ofieak95.fsf@Janik.cz>
     [not found] ` <5x3czq4lzb.fsf@kfs2.cua.dk>
     [not found]   ` <m3664m4ie3.fsf@Janik.cz>
     [not found]     ` <200202271030.MAA22372@is.elta.co.il>
     [not found]       ` <m3g03mabog.fsf@Janik.cz>
     [not found]         ` <5x8z9e5ymx.fsf@kfs2.cua.dk>
     [not found]           ` <m3zo1u5d44.fsf@Janik.cz>
     [not found]             ` <5xpu2q2aof.fsf@kfs2.cua.dk>
     [not found]               ` <200203010011.g210BRc05072@rum.cs.yale.edu>
2002-12-10  7:05                 ` Key sequence C-c C-f C-e uses invalid prefix characters Karl Eichwalder
2002-12-10 13:20                   ` Stefan Monnier
2002-12-10 18:27                   ` Kevin Rodgers
2002-12-11 17:44                   ` Richard Stallman
2002-12-12  3:08                     ` Galen Boyer
2002-12-11 17:44                   ` Richard Stallman
2002-12-12  6:34                     ` Karl Eichwalder
2002-12-12  6:57                       ` Miles Bader
2002-12-12  7:53                         ` Karl Eichwalder
2002-12-12 20:32                           ` Kevin Rodgers
2002-12-13 18:22                       ` Lennart Staflin
2002-12-14 15:15                         ` Felix Gatzemeier
2002-12-15  7:28                           ` Karl Eichwalder
2002-12-16 16:42                             ` Richard Stallman
2002-12-15 23:39                         ` Richard Stallman
2002-12-16 22:07                           ` Peter Flynn
2002-12-16 22:48                             ` Stefan Monnier
2002-12-17 23:34                               ` Ron Ross
2003-01-11 20:10                                 ` [Psgml-devel] " Stefan Monnier
2003-01-12  0:53                                   ` Peter Flynn
2002-12-18  0:34                               ` Peter Flynn
2002-12-18  9:10                                 ` Kai Großjohann
2002-12-18 22:32                                   ` [Psgml-devel] " Peter Flynn
2002-12-19 22:52                                   ` Dave Love
2003-01-12  4:06                                 ` [Psgml-devel] " Miles Bader
2003-01-12 14:11                                   ` Robert J. Chassell
2003-01-12 14:29                                   ` Peter Flynn
2003-01-12 16:25                                     ` Robert J. Chassell
2003-01-12 23:25                                       ` Peter Flynn
2003-01-13 12:33                                         ` Robert J. Chassell
2003-01-14  6:02                                   ` Karl Eichwalder
2003-01-15 22:57                                     ` Peter Flynn
2003-01-15 23:32                                       ` Stefan Monnier
2003-01-16 21:00                                         ` [Psgml-devel] " Peter Flynn
2003-01-17 12:42                                           ` Robert J. Chassell [this message]
2002-12-19 22:50                             ` Dave Love
2002-12-31  8:00                               ` Adding PSGML to the Emacs CVS (Re: Key sequence C-c C-f C-e uses invalid prefix characters) Karl Eichwalder
2003-01-02 18:39                                 ` Richard Stallman
2003-01-11 19:53                                 ` Stefan Monnier

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=m18ZVpm-000IeIC@localhost \
    --to=bob@rattlesnake.com \
    --cc=bob@gnu.org \
    --cc=emacs-devel@gnu.org \
    --cc=psgml-devel@lists.sourceforge.net \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).