Bug: org-clock-display dependence on org-clock-display-default-range is undocumented [8.3.2 (8.3.2-dist @ /usr/share/emacs24/site-lisp/org-mode/)]

Bug: org-clock-display dependence on org-clock-display-default-range is undocumented [8.3.2 (8.3.2-dist @ /usr/share/emacs24/site-lisp/org-mode/)]

[David Bremner]

Emacs  : GNU Emacs 24.5.1 (x86_64-pc-linux-gnu, GTK+ Version 3.18.2)
 of 2015-10-24 on trouble, modified by Debian
Package: Org-mode version 8.3.2 (8.3.2-dist @ /usr/share/emacs24/site-lisp/org-mode/)

Today being January first, the definition of 'thisyear changed rather
suddenly, and I spent a while trying to understand why org-display-clock
was "broken". Of course it wasn't really broken, but I could have solved
my problem quicker if the docstring and/or the info page had mentiond
variable org-clock-display-default-range

current state:
==============
(setq
 org-tab-first-hook '(org-hide-block-toggle-maybe org-babel-hide-result-toggle-maybe org-babel-header-arg-expand)
 org-latex-classes '(("beamer" "\\documentclass[presentation]{beamer}" ("\\section{%s}" . "\\section*{%s}")
		      ("\\subsection{%s}" . "\\subsection*{%s}") ("\\subsubsection{%s}" . "\\subsubsection*{%s}"))
		     ("article" "\\documentclass[11pt]{article}" ("\\section{%s}" . "\\section*{%s}")
		      ("\\subsection{%s}" . "\\subsection*{%s}") ("\\subsubsection{%s}" . "\\subsubsection*{%s}")
		      ("\\paragraph{%s}" . "\\paragraph*{%s}") ("\\subparagraph{%s}" . "\\subparagraph*{%s}"))
		     ("report" "\\documentclass[11pt]{report}" ("\\part{%s}" . "\\part*{%s}")
		      ("\\chapter{%s}" . "\\chapter*{%s}") ("\\section{%s}" . "\\section*{%s}")
		      ("\\subsection{%s}" . "\\subsection*{%s}") ("\\subsubsection{%s}" . "\\subsubsection*{%s}"))
		     ("book" "\\documentclass[11pt]{book}" ("\\part{%s}" . "\\part*{%s}")
		      ("\\chapter{%s}" . "\\chapter*{%s}") ("\\section{%s}" . "\\section*{%s}")
		      ("\\subsection{%s}" . "\\subsection*{%s}") ("\\subsubsection{%s}" . "\\subsubsection*{%s}"))
		     )
 org-agenda-clockreport-parameter-plist '(:link t :maxlevel 3)
 org-texinfo-format-drawer-function '(lambda (name contents) contents)
 org-speed-command-hook '(org-speed-command-default-hook org-babel-speed-command-hook)
 org-clock-display-default-range 'untilnow
 org-notmuch-search-open-function 'org-notmuch-search-follow-link
 org-reverse-note-order t
 org-time-clocksum-format '(:hours "%d" :require-hours t :minutes ":%02d" :require-minutes t)
 org-occur-hook '(org-first-headline-recenter)
 org-metaup-hook '(org-babel-load-in-session-maybe)
 org-html-format-drawer-function '(lambda (name contents) contents)
 org-clock-into-drawer "CLOCK"
 org-latex-format-inlinetask-function 'org-latex-format-inlinetask-default-function
 org-confirm-shell-link-function 'yes-or-no-p
 org-columns-default-format "%25ITEM %TODO %3PRIORITY %TAGS %5CLOCKSUM"
 org-ascii-format-inlinetask-function 'org-ascii-format-inlinetask-default
 org-latex-pdf-process '("lualatex -interaction nonstopmode -output-directory %o %f"
			 "lualatex -interaction nonstopmode -output-directory %o %f"
			 "lualatex -interaction nonstopmode -output-directory %o %f")
 org-agenda-skip-scheduled-if-done t
 org-return-follows-link t
 org-latex-format-headline-function 'org-latex-format-headline-default-function
 org-default-notes-file "~/.org/notes.org"
 org-agenda-include-diary t
 org-after-todo-state-change-hook '(org-clock-out-if-current)
 org-latex-format-drawer-function '(lambda (name contents) contents)
 org-odt-format-headline-function 'org-odt-format-headline-default-function
 org-src-mode-hook '(org-src-babel-configure-edit-buffer org-src-mode-configure-edit-buffer)
 org-agenda-before-write-hook '(org-agenda-add-entry-text)
 org-babel-pre-tangle-hook '(save-buffer)
 org-mode-hook '(#[nil "\300\301\302\303\304$\207" [org-add-hook change-major-mode-hook org-show-block-all append local] 5]
		 #[nil "\300\301\302\303\304$\207"
		   [org-add-hook change-major-mode-hook org-babel-show-result-all append local] 5]
		 org-babel-result-hide-spec org-babel-hide-all-hashes)
 org-refile-targets '((org-agenda-files :level . 1) (nil :level . 1) (nil :level . 2) (nil :level . 3))
 org-texinfo-format-headline-function 'org-texinfo-format-headline-default-function
 org-archive-hook '(org-attach-archive-delete-maybe)
 org-agenda-sorting-strategy '((agenda time-up priority-down category-up) (todo category-keep priority-down)
			       (tags category-keep priority-down) (search category-keep))
 org-ascii-format-drawer-function '(lambda (name contents width) contents)
 org-odt-format-inlinetask-function 'org-odt-format-inlinetask-default-function
 org-ctrl-c-ctrl-c-hook '(org-babel-hash-at-point org-babel-execute-safely-maybe)
 org-refile-use-outline-path t
 org-directory "~/.org"
 org-cycle-hook '(org-cycle-hide-archived-subtrees org-cycle-hide-drawers org-cycle-show-empty-lines
		  org-optimize-window-after-visibility-change)
 org-notmuch-open-function 'org-notmuch-follow-link
 org-archive-location "archive/%s::"
 org-lowest-priority 69
 org-archive-default-command 'org-archive-to-archive-sibling
 org-confirm-elisp-link-function 'yes-or-no-p
 org-metadown-hook '(org-babel-pop-to-session-maybe)
 org-odt-format-drawer-function '(lambda (name contents) contents)
 org-default-priority 67
 org-agenda-skip-deadline-if-done t
 org-html-format-headline-function 'org-html-format-headline-default-function
 org-html-format-inlinetask-function 'org-html-format-inlinetask-default-function
 org-texinfo-format-inlinetask-function 'org-texinfo-format-inlinetask-default-function
 org-clock-out-hook '(org-clock-remove-empty-clock-drawer)
 )

Re: Bug: org-clock-display dependence on org-clock-display-default-range is undocumented [8.3.2 (8.3.2-dist @ /usr/share/emacs24/site-lisp/org-mode/)]

[Nicolas Goaziou]

Hello,

David Bremner <david@tethera.net> writes:

> Today being January first, the definition of 'thisyear changed rather
> suddenly, and I spent a while trying to understand why org-display-clock
> was "broken". Of course it wasn't really broken, but I could have solved
> my problem quicker if the docstring and/or the info page had mentiond
> variable org-clock-display-default-range

I improved the docstring. Thank you.

Regards,

-- 
Nicolas Goaziou