[O] [PATCH]Optional argument to LaTeX caption command

[Thomas S. Dye]

Aloha all,

I proposed a similar patch a few weeks ago, but it seems to have  
slipped through the cracks or was ignored.  I'm proposing it again  
because Org-mode's handling of captions during LaTeX export is  
inconsistent and limiting.

The optional argument to the LaTeX caption command is used to set the  
caption in the List of Figures, List of Tables, and similar lists at  
the beginning of an article or the front matter of a book.  Nowadays,  
the caption under a figure is often quite long, and frequently  
includes the caption proper and the legend.  The optional argument to  
the LaTeX caption command is typically used to pass the caption proper  
to the List of Figures, etc., without the legend.  One goal of the  
typesetter here is to keep each entry in the List of Figures, etc. to  
one line, even when the corresponding caption (plus legend) under the  
figure spans many lines.  Even with captions that fit on a single  
line, it is often the case that the optional argument to the caption  
command is used to pass a version of the caption that doesn't end in a  
period.  Many LaTeX List of Figure, etc. styles run a line of dots  
from the caption to the page number.  If the caption ends in a period,  
then the line of dots is irregular, which looks inelegant.

Now, currently Org-mode correctly parses a caption command of the form:
#+CAPTION: [Caption to list]{Caption to figure.}
The part in square brackets is put in a variable =shortn= and the part  
in curly braces is put in a variable =cap= in the source file org- 
exp.el.

During export to LaTeX, the =shortn= variable is recognized if the  
figure is wrapped by text, but not if it is set as a float in either a  
single or multicolumn layout.  There is no logical reason for this to  
be so.  The optional argument to the caption command is needed in all  
three cases.

The attached patch corrects a bug in org-exp.el and makes the =shortn=  
variable available to captions of floats in single and multicolumn  
layouts in org-latex.el.  In org-exp.el, the =shortn= variable was not  
being initialized with the other variables having to do with captions  
and labels.  This meant that the optional argument used in one figure  
would be used for a subsequent figure that lacked an optional argument.

I believe this qualifies as a minor patch; it is only 3 lines.  I have  
signed the FSF papers needed to contribute to Org-mode, but for many  
months have waited in vain for a response from FSF.  At any rate, I  
don't believe there are any legal barriers to applying the patch.

I've been using the patch for a while now and haven't discovered any  
ill side effects.

All the best,
Tom

0001-lisp-org-exp.el-initialize-shortn.patch
Description: Binary data