[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: docstrings and elisp reference

From: Chad Brown
Subject: Re: docstrings and elisp reference
Date: Thu, 08 Jun 2017 17:25:35 -0700

On 8Jun, 2017, at 08:42, Jean-Christophe Helary <address@hidden> wrote:

On Jun 9, 2017, at 0:11, Eli Zaretskii <address@hidden> wrote:

From: Jean-Christophe Helary <address@hidden>
Date: Thu, 8 Jun 2017 17:12:37 +0900

Could you perhaps talk about what you see as the benefit to “an alternative to the info system, with exactly the same contents”?

An HTML page with the whole API with visual cues.

Can you elaborate on the "visual cues" part?

I mean a data set that makes full use of CSS selectors and provides visual information about where are the function names, the arguments, the types of arguments, etc. by using something like syntax highlighting and things like this.

But the contents would be exclusively the docstrings, with 2 way links to the elisp reference. I guess when we develop an extraction process for l10n, it will be possible to implement.

You might be interested in some work that Nic Ferrier did on Info and HTML a while back. There’s a (long) emacs-devel thread on the topic that ranged around a bit. This looks like a reasonable place to start in the archives, on “HTML-Info design"


Two more literal starting points for the discussion, perhaps not quite as helpful, are here:

There used to be a good-looking web-based example of Nic’s work, but it seems to be down now; trying to access it gets me errors that suggest a caching server sitting in front of a down or non-existant origin server.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]