Function: org-timer

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

Signature

(org-timer &optional RESTART NO-INSERT)

Documentation

Insert a H:MM:SS string from the timer into the buffer.

The first time this command is used, the timer is started.

When used with a C-u (universal-argument) prefix RESTART, force restarting the timer.

When used with a C-u (universal-argument) C-u (universal-argument) prefix RESTART, change all the timer strings in the region by a fixed amount. This can be used to re-calibrate a timer that was not started at the correct moment.

If NO-INSERT is non-nil, return the string instead of inserting it in the buffer.

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/org/org-timer.el.gz
;;;###autoload
(defun org-timer (&optional restart no-insert)
  "Insert a H:MM:SS string from the timer into the buffer.
The first time this command is used, the timer is started.

When used with a `\\[universal-argument]' prefix RESTART, force
restarting the timer.

When used with a `\\[universal-argument] \\[universal-argument]' prefix
RESTART, change all the timer strings in the region by a fixed amount.
This can be used to re-calibrate a timer that was not started at the
correct moment.

If NO-INSERT is non-nil, return the string instead of inserting it in
the buffer."
  (interactive "P")
  (if (equal restart '(16))
      (org-timer-start restart)
    (when (or (equal restart '(4)) (not org-timer-start-time))
      (org-timer-start))
    (if no-insert
	(org-timer-value-string)
      (insert (org-timer-value-string)))))