From mboxrd@z Thu Jan  1 00:00:00 1970
From: Bastien <bzg@gnu.org>
Subject: 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/)]
Date: Sun, 14 Apr 2013 12:04:09 +0200
Message-ID: <87mwt177ja.fsf@bzg.ath.cx>
References: <20130318180238.e93beb98766619930b459b34@gmail.com>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([208.118.235.92]:37203)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bastienguerry@gmail.com>) id 1URJnC-0000Cq-8I
	for emacs-orgmode@gnu.org; Sun, 14 Apr 2013 06:04:15 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <bastienguerry@gmail.com>) id 1URJnA-0000DT-WB
	for emacs-orgmode@gnu.org; Sun, 14 Apr 2013 06:04:14 -0400
Received: from mail-wi0-x22e.google.com ([2a00:1450:400c:c05::22e]:45429)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bastienguerry@gmail.com>) id 1URJnA-0000DH-PM
	for emacs-orgmode@gnu.org; Sun, 14 Apr 2013 06:04:12 -0400
Received: by mail-wi0-f174.google.com with SMTP id hj8so717942wib.13
	for <emacs-orgmode@gnu.org>; Sun, 14 Apr 2013 03:04:12 -0700 (PDT)
In-Reply-To: <20130318180238.e93beb98766619930b459b34@gmail.com> (Xue Fuqiao's
	message of "Mon, 18 Mar 2013 18:02:38 +0800")
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: <http://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.org@gnu.org
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: Xue Fuqiao <xfq.free@gmail.com>
Cc: emacs-orgmode@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