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

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

[Xue Fuqiao]

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.

Emacs  : GNU Emacs 24.3.50.1 (x86_64-unknown-linux-gnu, GTK+ Version 3.6.0)
 of 2013-03-17 on Emacs
Package: Org-mode version 7.9.3f (release_7.9.3f-17-g7524ef @ /usr/local/share/emacs/24.3.50/lisp/org/)

-- 
Xue Fuqiao
http://www.gnu.org/software/emacs/

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]

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

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

[Xue Fuqiao]

On Sun, 14 Apr 2013 12:04:09 +0200
Bastien <bzg@gnu.org> wrote:

> Hi Xue,

Hi,

> > 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.

Looks clearer to me, thanks.

-- 
Xue Fuqiao
http://www.gnu.org/software/emacs/