From: Eli Zaretskii <eliz@gnu.org>
To: help-gnu-emacs@gnu.org
Subject: Re: info reference syntax
Date: Mon, 12 Jan 2009 21:03:48 +0200 [thread overview]
Message-ID: <uab9wcpnv.fsf@gnu.org> (raw)
In-Reply-To: <bbc57e83-629f-4f39-b600-2f518fc27933@f20g2000yqg.googlegroups.com>
> From: Xah Lee <xahlee@gmail.com>
> Date: Mon, 12 Jan 2009 05:56:51 -0800 (PST)
>
> it'd be much better if emacs adopted html as its standard doc format.
Unless someone sets out to rewrite all the gazillion Emacs features in
info.el and info-look.el to work with HTML, this ain't gonna happen,
because those features are too useful to give up.
> this wouldn't effect emacs much since emacs can and should still use
> info doc in emacs as a integrated system. But down the road, say in 5
> years, emacs will need to deprecate texinfo eventually. The HTML/XHTML/
> CSS/JavaScript world is literally with few million more users and
> developers.
If you'd talk about XML or DocBook, I could perhaps believed you. But
the formats you mention cannot replace Texinfo because they are not
powerful enough to support features Texinfo has today, such as
indexing, and don't have a macro system to express useful constructs
such as @defun. Without these, it's a PITA to write any serious
software documentation.
We _could_ use HTML as an _output_ format (as opposed to source),
which is what I was talking above (makeinfo supports HTML output for a
very long time now). But to replace the source language with
something else, that something else needs to be at least as powerful
and convenient as Texinfo, and it needs tools to generated both
printed and on-line docs from the same source.
> In fact, i wouldn't be surprised that modern browser such as Firefox
> actually load html doc faster than a comparative info file.
Surprise me! give some measurements for a change.
> Today, as far as i know, nobody bothered with info version of docs.
"Nobody" is, of course, slightly exaggerated, as every GNU package has
Info docs, which in practice means every important piece of software
on a GNU/Linux machine is documented in Info.
next prev parent reply other threads:[~2009-01-12 19:03 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2009-01-09 19:22 info reference syntax Dan Davison
2009-01-09 19:27 ` Lennart Borgman
2009-01-09 21:12 ` Dan Davison
[not found] ` <mailman.4438.1231535588.26697.help-gnu-emacs@gnu.org>
2009-01-12 13:56 ` Xah Lee
2009-01-12 19:03 ` Eli Zaretskii [this message]
2009-01-12 17:00 ` B. T. Raven
[not found] <mailman.4426.1231528955.26697.help-gnu-emacs@gnu.org>
2009-01-12 16:51 ` B. T. Raven
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
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=uab9wcpnv.fsf@gnu.org \
--to=eliz@gnu.org \
--cc=help-gnu-emacs@gnu.org \
/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 external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.