emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: David Zelinsky <dzpost@dedekind.net>
To: emacs-orgmode@gnu.org
Subject: emphasis in embedded text
Date: Thu, 24 Nov 2022 22:56:47 -0500	[thread overview]
Message-ID: <86y1rzelfk.fsf@rubiaceae.dedekind.net> (raw)

I wanted to have some text emphasized when immediately following a
comma.  I found in the manual the suggestion to use a zero-width space
character.  That works, except that it turns out that by default emacs
actually displays the zero-width space as 1-pixel wide.  That's not
noticeable in a paragraph.  But in an org-mode table, it causes cell
boundaries to be slightly misaligned.  And with more than one of these
in a row, it becomes more than slightly.  That is very annoying.

At first I did not understand what was happening.  But then I found this
post on stackexchange that explains it all very clearly, along with how
to change emacs' default, either globally or just in certain modes:

https://emacs.stackexchange.com/questions/65108/zero-width-space-shows-as-underscore

Before I found this, I also stumbled on suggestions (apparently
predating adoption of the zero-width space paradigm) to customize
`org-emphasis-regexp-components'.  That actually works very nicely for
my purpose, so I'll probably stick with that.


But the point of this post is to suggest that the org-mode manual ought
to document these things more fully.  The section (12.2 Emphasis and
Monospace) that mentions the zero-width space approach ought to also
mention that by default in emacs these are not actually zero width.
Something like the description in the linked post would be great.

And for `org-emphasis-regexp-components', as far as I can tell this
variable is not mentioned at all anywhere in the manual.  I suspect
maybe this is because it's a kind of kludgy variable and maybe its use
should not be encouraged.  But it could at least be mentioned.  I only
learned of its existence from those older posts I mentioned above.


I don't know if this list is the right place to make such a suggestion.
Should I submit a bug report with some suggested modifications to the
manual?  Or is this all documented somewhere already and I just didn't
find it?


***NOTE***: I gather there's some controversy about the zero-width space
approach, especially in regard to exports.  I very much don't want to
trigger that debate!  I'm merely suggesting the manual say a bit more
about how things currently work, so others won't spend as much time as I
did figuring it out :)


-David



             reply	other threads:[~2022-11-25 14:23 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2022-11-25  3:56 David Zelinsky [this message]
2022-11-25 14:38 ` emphasis in embedded text Ihor Radchenko
2022-11-25 15:27 ` Max Nikulin

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.orgmode.org/

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

  git send-email \
    --in-reply-to=86y1rzelfk.fsf@rubiaceae.dedekind.net \
    --to=dzpost@dedekind.net \
    --cc=emacs-orgmode@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 public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.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).