emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* [question/patch] How detailed may org.texi be?
@ 2014-10-29 13:24 Rasmus
  2014-10-29 20:44 ` Nicolas Goaziou
  0 siblings, 1 reply; 3+ messages in thread
From: Rasmus @ 2014-10-29 13:24 UTC (permalink / raw)
  To: emacs-orgmode

[-- Attachment #1: Type: text/plain, Size: 324 bytes --]

Hi,

I would like to push the following patch to org.texi on export
behavior of sub/superscripts and LaTeX delimiters.  To me it seems
relevant, but it's somewhat technical.  Is it relevant to include such
"implementation" details/choices in org.texi?

—Rasmus

-- 
You people at the NSA are becoming my new best friends!

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-org.texi-Clarifications-of-math-subscript-export.patch --]
[-- Type: text/x-diff, Size: 1694 bytes --]

From 04e0b5c7ed5329bf62175f58192577b895a10cdb Mon Sep 17 00:00:00 2001
From: rasmus <rasmus@gmx.us>
Date: Wed, 29 Oct 2014 14:15:41 +0100
Subject: [PATCH] org.texi: Clarifications of math/subscript export.

* org.texi (Subscripts and superscripts), (@LaTeX{} fragments):
	More information on export output.
---
 doc/org.texi | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/doc/org.texi b/doc/org.texi
index 3c1790a..0d8fa0e 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -10222,6 +10222,11 @@ The mass of the sun is M_sun = 1.989 x 10^30 kg.  The radius of
 the sun is R_@{sun@} = 6.96 x 10^8 m.
 @end example
 
+By default super- and subscript are exported as plain text, rather than math,
+when exporting to HTML and @LaTeX{}.  Thus @code{\beta_t} is exported as
+@code{&beta;<sub>t</sub>} for HTML and @code{\(\beta_@{\text@{t@}@}\)} for
+@LaTeX{}.
+
 @vindex org-use-sub-superscripts
 If you write a text where the underscore is often used in a different
 context, Org's convention to always interpret these as subscripts can get in
@@ -10269,7 +10274,9 @@ math delimiters if the enclosed text contains at most two line breaks, is
 directly attached to the @samp{$} characters with no whitespace in between,
 and if the closing @samp{$} is followed by whitespace, punctuation or a dash.
 For the other delimiters, there is no such restriction, so when in doubt, use
-@samp{\(...\)} as inline math delimiters.
+@samp{\(...\)} as inline math delimiters.  In HTML and @LaTeX{} exports,
+inline math are enclosed in @samp{\(...\)} irrespective of whether enclosed
+in @samp{$} or @samp{\(...\)} in the Org source.
 @end itemize
 
 @noindent For example:
-- 
2.1.2


^ permalink raw reply related	[flat|nested] 3+ messages in thread

* Re: [question/patch] How detailed may org.texi be?
  2014-10-29 13:24 [question/patch] How detailed may org.texi be? Rasmus
@ 2014-10-29 20:44 ` Nicolas Goaziou
  2014-10-30 16:13   ` Skip Collins
  0 siblings, 1 reply; 3+ messages in thread
From: Nicolas Goaziou @ 2014-10-29 20:44 UTC (permalink / raw)
  To: Rasmus; +Cc: emacs-orgmode

Hello,

Rasmus <rasmus@gmx.us> writes:

> I would like to push the following patch to org.texi on export
> behavior of sub/superscripts and LaTeX delimiters.  To me it seems
> relevant, but it's somewhat technical.  Is it relevant to include such
> "implementation" details/choices in org.texi?

FWIW, I think it's too technical.


Regards,

-- 
Nicolas Goaziou

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [question/patch] How detailed may org.texi be?
  2014-10-29 20:44 ` Nicolas Goaziou
@ 2014-10-30 16:13   ` Skip Collins
  0 siblings, 0 replies; 3+ messages in thread
From: Skip Collins @ 2014-10-30 16:13 UTC (permalink / raw)
  To: Rasmus, emacs-org list

Rasmus <rasmus@gmx.us> writes:
> I would like to push the following patch to org.texi on export

As long as you are tweaking the manual, please fix the typesetting of
LaTeX-verbatim-environments in the Variable Index. It should appear as
a simple string, not as a fancy logo. As a point of style, I would
prefer that all index entries stick with TeX and LaTeX rather than
\TeX and \LaTeX.

^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2014-10-31 15:40 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2014-10-29 13:24 [question/patch] How detailed may org.texi be? Rasmus
2014-10-29 20:44 ` Nicolas Goaziou
2014-10-30 16:13   ` Skip Collins

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).