Re: Org mode and Emacs (was: Convert README.org to plain text README while installing package)

[Eli Zaretskii]

> From: Ihor Radchenko <yantar92@gmail.com>
> Cc: Tim Cross <theophilusx@gmail.com>,  eliz@gnu.org,
>  monnier@iro.umontreal.ca,  acm@muc.de,  emacs-devel@gnu.org
> Date: Sun, 12 Jun 2022 09:27:57 +0800
> 
> Richard Stallman <rms@gnu.org> writes:
> 
> > One of Texinfo's crucial features is a wide range of semantic markup
> > constructs, each of which can generate different output depending on
> > the output format.  For instance, Texinfo has @var, @emph and @dfn,
> > all of which generate italics in printed output, but they differ in
> > what they generate for other output formats.  There are probably 15
> > other such constructs.
> 
> Could you please point to the place where I can read about the different
> generated output?

In the Texinfo manual.  It describes, for each markup, what that
produces in every major output format.

> > Does Org format have the ability to make all these distinctions?
> > If not, I suspect that the Org mode documentation isn't following
> > all our style conventions for documentation.
> 
> Org manual does not AFAIK, other than various index entries.

That is strange to hear.  I was under the impression that Org can
export to various format, and each such output format has its own
export support.  So at least in principle, the distinction Richard is
talking about should be not only possible, but quite easy to
implement, if not already implemented.

> However, I am not sure what exactly you are referring to.
> Could you please provide a link describing the conventions you are
> referring to?

Most of them are in the Texinfo manual, and some are in the GNU Coding
Standards manual.

To take one example, @dfn produces italics in HTML and in printed
formats (PDF etc.), and quoted text in Info.