From mboxrd@z Thu Jan  1 00:00:00 1970
From: Anthony Cowley <acowley@gmail.com>
Subject: Short captions
Date: Mon, 10 Feb 2020 23:20:33 -0500
Message-ID: <m2zhdpwy9a.fsf@gmail.com>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane-mx.org@gnu.org>
Received: from eggs.gnu.org ([2001:470:142:3::10]:37656)
 by lists.gnu.org with esmtp (Exim 4.90_1)
 (envelope-from <acowley@gmail.com>) id 1j1N2M-00068h-QK
 for emacs-orgmode@gnu.org; Mon, 10 Feb 2020 23:20:39 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <acowley@gmail.com>) id 1j1N2L-0007bA-Np
 for emacs-orgmode@gnu.org; Mon, 10 Feb 2020 23:20:38 -0500
Received: from mail-qt1-x831.google.com ([2607:f8b0:4864:20::831]:44270)
 by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
 (Exim 4.71) (envelope-from <acowley@gmail.com>) id 1j1N2L-0007Wb-HK
 for emacs-orgmode@gnu.org; Mon, 10 Feb 2020 23:20:37 -0500
Received: by mail-qt1-x831.google.com with SMTP id w8so6970420qts.11
 for <emacs-orgmode@gnu.org>; Mon, 10 Feb 2020 20:20:37 -0800 (PST)
Received: from Sonmi451.local (c-73-150-130-220.hsd1.nj.comcast.net.
 [73.150.130.220])
 by smtp.gmail.com with ESMTPSA id 16sm1346956qkm.93.2020.02.10.20.20.34
 for <emacs-orgmode@gnu.org>
 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
 Mon, 10 Feb 2020 20:20:34 -0800 (PST)
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane-mx.org@gnu.org
Sender: "Emacs-orgmode"
 <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane-mx.org@gnu.org>
To: Emacs Org-Mode Help <emacs-orgmode@gnu.org>

I am having trouble understanding how short captions are supposed to work. Consider this org document:

#+begin_src org
,#+title: Short Caption Test
,#+author: Org User

,#+label: table1
,#+caption[This is table1]: And here go on at length in a longer caption.
| Name | Favorite Number |
|------+-----------------|
| Sue  | 42              |
| Tom  | 99              |

,#+label: table2
,#+caption[This is table2]: But *with* /this/ table, the /short/ caption is *lost*.
| Name  | Favorite Color |
|-------+----------------|
| Alice | Red            |
| Bob   | Also Red       |

,#+label: table3
,#+caption[This is table3]: No org markup is used in this long caption, but some $\LaTeX$ is!
| Number | Favorite Person |
|--------+-----------------|
| 0      | Zed             |
| 1      | Solo            |
#+end_src

When I export it as a LaTeX file, the captions are:

#+begin_src latex
\caption[This is table1]{\label{table1}And here go on at length in a longer caption.}
#+end_src

#+begin_src latex
\caption[\textbf{lost}]{\label{table2}But \textbf{with} \emph{this} table, the \emph{short} caption is \textbf{lost}.}
#+end_src

and

#+begin_src latex
\caption{\label{table3}No org markup is used in this long caption, but some \(\LaTeX\) is!}
#+end_src

The first matches my expectations. The second is an example of taking the last bit of markup as the short caption. The third seems to lose the short caption altogether.

When I look at 

#+begin_src emacs-lisp
(org-element-map 
    (org-element-parse-buffer) 
    'table 
  (lambda (x) (org-element-property :caption x)))
#+end_src

Only the first caption seems to have the short caption in the parse results at all. Is this a bug, or should I avoid using markup in captions?

Thank you,
Anthony

#+begin_src emacs-lisp
(org-version)
#+end_src

#+RESULTS:
: 9.3