all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Eli Zaretskii <eliz@gnu.org>
To: Robert Pluim <rpluim@gmail.com>
Cc: raman@google.com, emacs-devel@gnu.org
Subject: Re: Faces for strong, emph and friends in Info?
Date: Wed, 10 Apr 2024 19:51:27 +0300	[thread overview]
Message-ID: <86le5lupo0.fsf@gnu.org> (raw)
In-Reply-To: <878r1lrydu.fsf@gmail.com> (message from Robert Pluim on Wed, 10 Apr 2024 18:11:25 +0200)

> From: Robert Pluim <rpluim@gmail.com>
> Cc: raman@google.com,  emacs-devel@gnu.org
> Date: Wed, 10 Apr 2024 18:11:25 +0200
> 
> >>>>> On Tue, 09 Apr 2024 12:56:43 +0300, Eli Zaretskii <eliz@gnu.org> said:
> 
>     Eli> Here's the first hit I found:
> 
>     Eli>   ‘woman-use-topic-at-point’
>     Eli>        A boolean value that defaults to ‘nil’.  If non-‘nil’ then the
>     Eli>        ‘woman’ command uses the word at point as the topic, _without
>     Eli>        interactive confirmation_, if it exists as a topic.
> 
>     Eli> We never wrap @emph and @strong in @w, so it's small wonder this
>     Eli> happens quite a lot.
> 
> In the original texi "without interactive confirmation" is all on the
> same line, so this one is understandable.

This can happen in Texinfo anywhere, and there's nothing we can do to
avoid this, in general.

> And thereʼs indentation in the resulting info file, which means when
> we use '_' to simulate italics, the indentation does not look good. So
> hereʼs what needs deciding:

Forgive me, but I think you are trying to solve too many loosely
related problems at once, so you take a simple problem and conclude
that it's almost unsolvable.  Let me try to simplify things:

> - what do we fontify? There are instances of eg @strong{Warning:}
> where I could argue that the ':' should be outside the @strong{}. So
> we either match ?: (and ?.) as well, or move those chars outside the
> {}

We match whatever the Texinfo source produced.  In the above case, the
colon will be included, and if the author doesn't like the results,
they need to say @strong{Warning}: instead.  (But since this produces
bold in the printed version, I guess including the colon is actually
perfectly okay.)

> - do we match across newlines?

Yes, we do.

> - if we match across newlines, do we go around wraping @w around all
> the multiword @emph and @strong? (could we persuade the texinfo
> project to do this for us or emit a warning?)

Not a problem for this feature to solve.  If people dislike what it
will produce, they will either turn off this feature (which must be
optional, btw) or go back and wrap in @w what they want.  We do that
already with the likes of @code and @kbd, where it matters, so how are
these markups different?

> - how configurable does this need to be? Iʼd say a single toggle is
> enough, but Drew might disagree. I guess adding a defcustom for the
> matching regexp is easy enough as well.

A single toggle is enough.



  parent reply	other threads:[~2024-04-10 16:51 UTC|newest]

Thread overview: 24+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-04-08 14:49 Faces for strong, emph and friends in Info? T.V Raman
2024-04-08 14:59 ` Eli Zaretskii
2024-04-08 16:57   ` Robert Pluim
2024-04-08 17:28     ` T.V Raman
2024-04-08 18:06     ` [External] : " Drew Adams
2024-04-08 18:27     ` Eli Zaretskii
2024-04-08 19:32       ` [External] : " Drew Adams
2024-04-09  9:01       ` Robert Pluim
2024-04-09  9:56         ` Eli Zaretskii
2024-04-10 16:11           ` Robert Pluim
2024-04-10 16:17             ` T.V Raman
2024-04-10 16:27               ` Robert Pluim
2024-04-10 16:53                 ` Eli Zaretskii
2024-04-11 12:59                   ` Robert Pluim
2024-04-11 14:10                     ` T.V Raman
2024-04-10 16:51             ` Eli Zaretskii [this message]
2024-04-08 22:02     ` T.V Raman
2024-04-08 22:29     ` T.V Raman
2024-04-09  1:47       ` [External] : " Drew Adams
2024-04-09  2:23         ` T.V Raman
2024-04-09  4:22           ` Eli Zaretskii
2024-04-09  1:35     ` T.V Raman
2024-04-09  4:21       ` Eli Zaretskii
2024-04-09 13:29         ` T.V Raman

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=86le5lupo0.fsf@gnu.org \
    --to=eliz@gnu.org \
    --cc=emacs-devel@gnu.org \
    --cc=raman@google.com \
    --cc=rpluim@gmail.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.