all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Juri Linkov <juri@jurta.org>
To: Eli Zaretskii <eliz@gnu.org>
Cc: ruediger@c-plusplus.de, 16439@debbugs.gnu.org, sva-news@mygooglest.com
Subject: bug#16439: [feature request] Highlighting of strings within Info	buffers
Date: Tue, 21 Jan 2014 09:54:39 +0200	[thread overview]
Message-ID: <8738khzs5c.fsf@mail.jurta.org> (raw)
In-Reply-To: <83ioteisx1.fsf@gnu.org> (Eli Zaretskii's message of "Mon, 20 Jan 2014 17:17:46 +0200")

>>   Most optional features in Emacs are grouped into "packages".
>>
>> Should "packages" be highlighted as a string.  Of course not.
>
> Why not?  This particular example is produced from @dfn in Texinfo,
> which should emphasize its argument.  In the printed version
> "packages" is typeset in slanted typeface (and without the quotes).

It makes sense to emphasize either 1) using quotes and no additional
highlighting or 2) using italic without the quotes, but not both styles
(italic and quotes) at the same time.

>> There is no additional emphasis on quotations in books.
>
> But we are not talking about books, are we?  We are talking about Info
> manuals, which are mostly documentation of software.

Ideally, the look of on-line documentation should not differ from
the printed version.  How this could be achieved is a difficult
question.  In the comments of http://esr.ibiblio.org/?p=5211
someone suggested using Markdown for Emacs documentation,
but ESR strongly disagreed.  Maybe using the natively
supported Org format would be better.

But actually I see no much need in replacing Texinfo as the source format.
As for the output format, we could try to migrate in the direction of HTML.
However, HTML has its own problems (no index, slow rendering, etc.)





  reply	other threads:[~2014-01-21  7:54 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2014-01-14 10:15 bug#16439: [feature request] Highlighting of strings within Info buffers Sebastien Vauban
2014-01-14 14:34 ` Rüdiger Sonderfeld
2014-01-14 20:05   ` Drew Adams
2014-01-20  9:18     ` Juri Linkov
2014-01-20 14:10       ` Stefan Monnier
2020-09-18 14:03         ` Lars Ingebrigtsen
2014-01-20 15:17       ` Eli Zaretskii
2014-01-21  7:54         ` Juri Linkov [this message]
2014-01-21 15:53           ` Eli Zaretskii
2014-01-22  8:09             ` Juri Linkov
2014-01-22 15:42               ` Eli Zaretskii
2014-01-20 18:06       ` Drew Adams

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=8738khzs5c.fsf@mail.jurta.org \
    --to=juri@jurta.org \
    --cc=16439@debbugs.gnu.org \
    --cc=eliz@gnu.org \
    --cc=ruediger@c-plusplus.de \
    --cc=sva-news@mygooglest.com \
    /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.