org-caption-shortn

["Thomas S. Dye" <tsd@tsdye.com>]

Aloha all,

I stumbled across code in org-exp.el and org-latex.el that appears to  
my untrained eye to be designed to parse the optional argument to the  
LaTeX \caption command.

This bit in org-exp.el appears to parse out the optional command:

	  (when (string-match "\\[\\(.*\\)\\]{\\(.*\\)}" cap)
	    (setq shortn (match-string 1 cap)
		  cap (match-string 2 cap)))

Then it is easy to find code in org-latex.el by searching for 'shortn'  
that looks like it writes out the full command to the .tex file.

I can't find documentation for this, though.  It looks (to my  
untrained eye) like it should be possible to write something like:

#+CAPTION: [short]{long}

and get

\caption[short]{long} in the .tex file.

But this doesn't work for me.  The [short] part doesn't make it into  
the .tex file.

I don't know enough lisp to figure this out in a reasonable amount of  
time, so have come to the list to ask if anyone familiar with the code  
knows whether this should work or not, and if it should work, how to  
markup the org file.

All the best,
Tom