[O] Clocktable: Put summary line as table caption

[Sebastien Vauban]

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 <address@hidden>
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