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 via email to