Function: org-clock-report

org-clock-report is an autoloaded, interactive and byte-compiled function defined in org-clock.el.gz.

Signature

(org-clock-report &optional ARG)

Documentation

Update or create a table containing a report about clocked time.

If point is inside an existing clocktable block, update it. Otherwise, insert a new one.

The new table inherits its properties from the variable org-clock-clocktable-default-properties.

The scope of the clocktable, when not specified in the previous variable, is subtree of the current heading when the function is called from inside heading, and file elsewhere (before the first heading).

When called with a prefix argument, move to the first clock table in the buffer and update it.

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/org/org-clock.el.gz
;;;###autoload
(defun org-clock-report (&optional arg)
  "Update or create a table containing a report about clocked time.

If point is inside an existing clocktable block, update it.
Otherwise, insert a new one.

The new table inherits its properties from the variable
`org-clock-clocktable-default-properties'.

The scope of the clocktable, when not specified in the previous
variable, is `subtree' of the current heading when the function is
called from inside heading, and `file' elsewhere (before the first
heading).

When called with a prefix argument, move to the first clock table
in the buffer and update it."
  (interactive "P")
  (org-clock-remove-overlays)
  (when arg
    (org-find-dblock "clocktable")
    (org-fold-show-entry))
  (pcase (org-in-clocktable-p)
    (`nil
     (org-create-dblock
      (org-combine-plists
       (list :scope (if (org-before-first-heading-p) 'file 'subtree))
       org-clock-clocktable-default-properties
       '(:name "clocktable"))))
    (start (goto-char start)))
  (org-update-dblock))