Hi,
I'm a long time LaTeX user starting to use the excellent org-mode.
I've noticed what I believe is a wrong interpretation of the LaTeX
syntax by org-mode:
According to the LaTeX manual and reference "LaTeX: A Document
Preparation System", L. Lamport, \[ ... \] is a short form for a
displaymath environment. Citing the reference:
"... Because displayed equations are used so frequently in
mathematics, LaTeX allows you to type \[ ... \] instead of
\begin{displaymath} ... \end{displaymath}. ..."
However, org-mode classify \[ ... \] as a latex-fragment, the same as
\(...\). The two are however very different in LaTeX because, while
the latter displays some mathematical expression *inline*, the former
makes its content stand out by putting it on *its own line*.
What I do not like about this is that "org-fill-paragraph" considers
the \[ ...\] environment part of a paragraph and therefore the
environment gets "lost" in the middle of a line.
Here a simple org file:
------------------------------------------------------------------
* Intro
First paragraph with equation environment:
\begin{equation}
E = mc^2 .
\end{equation}
Second paragraph with short form of displaymath environment:
\[
E = \hbar\omega .
\]
(setq fbe-tmp (org-element-parse-buffer))
------------------------------------------------------------------
and here how it is parsed
------------------------------------------------------------------
(org-data nil
(headline
(:raw-value "Intro" :begin 1 :end 226 :pre-blank 1 :hiddenp nil
:contents-begin 10 :contents-end 226 :level 1 :priority nil :tags nil
:todo-keyword nil :todo-type nil :post-blank 0 :footnote-section-p nil
:archivedp nil :commentedp nil :quotedp nil :CATEGORY nil :title
(#("Intro" 0 5
(:parent #1)))
:parent #0)
(section
(:begin 10 :end 226 :contents-begin 10 :contents-end 226
:post-blank 0 :parent #1)
(paragraph
(:begin 10 :end 53 :contents-begin 10 :contents-end 53
:post-blank 0 :post-affiliated 10 :parent #2)
#("First paragraph with equation environment:\n" 0 43
(:parent #3)))
(latex-environment
(:begin 53 :end 98 :value "\\begin{equation}\nE = mc^2
.\n\\end{equation}\n" :post-blank 1 :post-affiliated 53 :parent #2))
(paragraph
(:begin 98 :end 185 :contents-begin 98 :contents-end 184
:post-blank 1 :post-affiliated 98 :parent #2)
#("Second paragraph with short form of displaymath environment:\n" 0 61
(:parent #3))
(latex-fragment
(:value "\\[\nE = \\hbar\\omega .\n\\]" :begin 159 :end 183
:post-blank 0 :parent #3))
#("\n" 0 1
(:parent #3)))
(paragraph
(:begin 185 :end 226 :contents-begin 185 :contents-end 226
:post-blank 0 :post-affiliated 185 :parent #2)
#("(setq fbe-tmp (org-element-parse-buffer))" 0 41
(:parent #3))))))
------------------------------------------------------------------
Regards,
Fede
Emacs : GNU Emacs 24.3.1 (i386-mingw-nt6.1.7601)
of 2013-03-17 on MARVIN
Package: Org-mode version 8.2.6 (8.2.6-47-ge3d2c1-elpa @
c:/Users/beffa/.emacs.d/elpa/org-20140526/)
