From mboxrd@z Thu Jan  1 00:00:00 1970
From: "Sebastien Vauban" <wxhgmqzgwmuf-geNee64TY+gS+FvcfC7Uqw@public.gmane.org>
Subject: Clocktable: Put summary line as table caption
Date: Mon, 01 Oct 2012 23:20:19 +0200
Message-ID: <80d311evos.fsf@somewhere.org>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org-mXXj517/zsQ@public.gmane.org>
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-mXXj517/zsQ@public.gmane.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode-mXXj517/zsQ@public.gmane.org>
List-Help: <mailto:emacs-orgmode-request-mXXj517/zsQ@public.gmane.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request-mXXj517/zsQ@public.gmane.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org-mXXj517/zsQ@public.gmane.org
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org-mXXj517/zsQ@public.gmane.org
To: emacs-orgmode-mXXj517/zsQ@public.gmane.org

Hello,

Looking at the presentation of the clocktable, I find that its "summary" line
should be converted into a caption, as any legend would be for any regular
table.

You can test it, and see its effect, with such a ECM file:

--8<---------------cut here---------------start------------->8---
* Development
  :LOGBOOK:
  CLOCK: [2012-09-28 Fri 10:00]--[2012-09-28 Fri 11:00] =>  1:00
  :END:

** Task 1
   :LOGBOOK:
   CLOCK: [2012-09-28 Fri 11:00]--[2012-09-28 Fri 12:00] =>  1:00
   :END:

** Task 2

*** Task 2a
    :LOGBOOK:
    CLOCK: [2012-09-28 Fri 12:00]--[2012-09-28 Fri 13:00] =>  1:00
    :END:

*** Task 2b
    :LOGBOOK:
    CLOCK: [2012-09-28 Fri 13:00]--[2012-09-28 Fri 14:00] =>  1:00
    :END:

* Clock tables

#+BEGIN: clocktable :maxlevel 1 :scope file
#+CAPTION: Clock summary at [2012-10-01 Mon 23:18]

| Headline    | Time |
|-------------+------|
| Total time  | 4:00 |
|-------------+------|
| Development | 4:00 |
#+END:
--8<---------------cut here---------------end--------------->8---

The following patch does it...

>From db65cf37d8d28f492e2a36b2fe69307786eff5ce Mon Sep 17 00:00:00 2001
From: Sebastien Vauban <svauban-D0wtAvR13HarG/iDocfnWg@public.gmane.org>
Date: Mon, 1 Oct 2012 17:03:30 +0200
Subject: [PATCH 2/2] Put the clocktable summary line as a CAPTION

* org-clock.el (org-clocktable-write-default): Insert the summary as a
  standard #+CAPTION keyword for the (clock) table.

TINYCHANGE
---
 lisp/org-clock.el |    1 +
 1 files changed, 1 insertions(+), 0 deletions(-)

diff --git a/lisp/org-clock.el b/lisp/org-clock.el
index c743605..54c812e 100644
--- a/lisp/org-clock.el
+++ b/lisp/org-clock.el
@@ -2339,6 +2339,7 @@ from the dynamic block definition."
      (or header
 	 ;; Format the standard header
 	 (concat
+	  "#+CAPTION: "
 	  (nth 9 lwords) " ["
 	  (substring
 	   (format-time-string (cdr org-time-stamp-formats))
--
1.7.9

--
Sebastien Vauban