Re: Bug: The `#+CAPTION' isn't documented well [7.9.3f (release_7.9.3f-17-g7524ef @ /usr/local/share/emacs/24.3.50/lisp/org/)]

[Bastien <bzg@gnu.org>]

Hi Xue,

Xue Fuqiao <xfq.free@gmail.com> writes:

> Remember to cover the basics, that is, what you expected to happen and
> what in fact did happen.  You don't know how to make a good report?  See
>
>      http://orgmode.org/manual/Feedback.html#Feedback
>
> Your bug report will be posted to the Org-mode mailing list.
> ------------------------------------------------------------------------
>
> In [info:org#Images and tables]:
>
>    Optionally, the caption can take the form:
>      #+CAPTION: [Caption for list of figures]{Caption for table (or link).}
>
> The Org manual doesn't explain what this form means clearly.  And I also
> can't find it in the FAQ and the mailing list archives.

The manual has been updated here and now says:

  @example
  #+CAPTION: This is the caption for the next table (or link)
  #+NAME:   tab:basic-data
     | ... | ...|
     |-----|----|
  @end example
  
  Optionally, the caption can take the form:
  @example
  #+CAPTION[Caption for list of tables]: Caption for table.
  @end example

Please double-check and tell us if it's clearer.

Thanks,

-- 
 Bastien