Bug: wrong interpretation of LaTeX [8.2.6 (8.2.6-47-ge3d2c1-elpa @ c:/Users/beffa/.emacs.d/elpa/org-20140526/)]

[Federico Beffa <beffa@ieee.org>]

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