Bug: Missing command description in org-mode manual [8.2.10 (release_8.2.10 @ c:/Users/j.haustedt/AppData/Roaming/.emacs.d/elpa/org-20150119/)]

Bug: Missing command description in org-mode manual [8.2.10 (release_8.2.10 @ c:/Users/j.haustedt/AppData/Roaming/.emacs.d/elpa/org-20150119/)]

[Haustedt, Jens]

[-- Attachment #1: Type: text/plain, Size: 7128 bytes --]


Remember to cover the basics, that is, what you expected to happen and
what in fact did happen.  You don't know how to make a good report?  See

     http://orgmode.org/manual/Feedback.html#Feedback

Your bug report will be posted to the Org-mode mailing list.
------------------------------------------------------------------------



Emacs  : GNU Emacs 24.4.1 (i686-pc-mingw32)
of 2014-10-24 on LEG570
Package: Org-mode version 8.2.10 (release_8.2.10 @ c:/Users/j.haustedt/AppData/Roaming/.emacs.d/elpa/org-20150119/)

current state:
==============
(setq
org-ctrl-c-ctrl-c-hook '(org-babel-hash-at-point org-babel-execute-safely-maybe)
org-clock-in-resume t
org-clock-out-when-done nil
org-agenda-skip-scheduled-if-done t
org-clock-persist t
org-agenda-window-setup 'current-window
org-tab-first-hook '(org-hide-block-toggle-maybe org-src-native-tab-command-maybe org-babel-hide-result-toggle-maybe
                                                                                                                                                                            org-babel-header-arg-expand)
org-cycle-hook '(org-cycle-hide-archived-subtrees org-cycle-hide-drawers org-cycle-hide-inline-tasks
                                                                                                                                             org-cycle-show-empty-lines org-optimize-window-after-visibility-change)
org-agenda-custom-commands '(("s" "SOMEDAY" tags "someday"
                                                                                                                                                                                                                                           ((org-agenda-filter-preset (quote ("+someday"))) (org-agenda-todo-ignore-with-date nil)))
                                                                                                                                                                                                                                           ("z" todo "ZKTO")
                                                                                                                                                                                                                                           ("f" "Agenda and flagged tasks" ((tags "zkto") (tags "flagged") (agenda ""))))
org-agenda-before-write-hook '(org-agenda-add-entry-text)
org-speed-command-hook '(org-speed-command-default-hook org-babel-speed-command-hook)
org-babel-pre-tangle-hook '(save-buffer)
org-return-follows-link t
org-occur-hook '(org-first-headline-recenter)
org-clock-history-length 35
org-log-done 'time
org-metaup-hook '(org-babel-load-in-session-maybe)
org-confirm-elisp-link-function 'yes-or-no-p
org-log-into-drawer t
org-agenda-window-frame-fractions '(1.0 . 1.0)
org-columns-default-format "%80ITEM(Task) %10Effort(Effort){:} %10CLOCKSUM"
org-agenda-span 1
org-agenda-format-date "%Y-%m-%d ---------------------------------------------------------------------"
org-refile-use-outline-path 'file
org-clock-auto-clock-resolution nil
org-global-properties '(("Effort_ALL" . "0:10 0:30 1:00 2:00 3:00 4:00 5:00 6:00 8:00"))
org-agenda-fontify-priorities '((65 (:foreground "Red")) (66 (:foreground "Blue")) (67 (:foreground "Darkgreen")))
org-clock-out-hook '(org-clock-remove-empty-clock-drawer)
org-completion-use-ido t
org-agenda-skip-deadline-if-done t
org-mode-hook '(org-clock-load
                                                                                                                             #[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-agenda-clockreport-parameter-plist '(:link t :maxlevel 4)
org-clock-into-drawer "CLOCK"
org-agenda-mode-hook '((lambda nil (hl-line-mode 1)))
org-finalize-agenda-hook '(my-org-agenda-to-appt voice-recordings)
org-from-is-user-regexp nil
org-metadown-hook '(org-babel-pop-to-session-maybe)
org-todo-keywords '((sequence "TODO(t)" "STARTED(s!)" "WAITING(w@/!)" "APPT(a)" "PROJ(p)" "DELEGATED(g@/!)" "|" "DONE(d!)"
                                                                                                                                                                            "ZKTO(z)" "CANCELED(c@)")
                                                                                                                                                             )
org-agenda-files '("~/org/start.org" "~/org/RandomAccess.org")
org-drawers '("PROPERTIES" "CLOCKTABLE" "LOGBOOK" "CLOCK")
org-agenda-finalize-hook '(my-org-agenda-to-appt voice-recordings)
org-src-mode-hook '(org-src-babel-configure-edit-buffer org-src-mode-configure-edit-buffer)
org-after-todo-state-change-hook '(org-clock-out-if-current)
org-todo-keyword-faces '(("TODO" :foreground "#b70101" :weight bold) ("STARTED" :foreground "#b70101" :weight bold)
                                                                                                                                                                                                            ("APPT" :foreground "sienna" :weight bold) ("PROJ" :foreground "blue" :weight bold)
                                                                                                                                                                                                            ("ZKTO" :foreground "orange" :weight bold) ("WAITING" :foreground "orange" :weight bold)
                                                                                                                                                                                                            ("DONE" :foreground "forestgreen" :weight bold)
                                                                                                                                                                                                            ("DELEGATED" :foreground "forestgreen" :weight bold) ("CANCELED" . shadow))
org-agenda-start-with-clockreport-mode t
org-confirm-shell-link-function 'yes-or-no-p
)


Dear Sirs,
in the description of the date/time prompt, a section describes the
control of the calendar from the minibuffer.

There, a description of scrolling the calendar by 1 year is missing. The
keyboard shortcut is M-S-<up>/<down> and works perfectly.

Best regards, Jens Haustedt

-- 
Pflichtinformationen: siehe www.euroimmun.de/impressum.htm


[-- Attachment #2: Type: text/html, Size: 25978 bytes --]

PATCH: Document how to scroll calendar by one year at date prompt. (was: Re: Bug: Missing command description in org-mode manual)

[Gregor Zattler]

Hi Jens, org-mode developers,
* Haustedt, Jens <j.haustedt@euroimmun.de> [19. Mar. 2015]:
> in the description of the date/time prompt, a section describes the
> control of the calendar from the minibuffer.
> 
> There, a description of scrolling the calendar by 1 year is missing. The
> keyboard shortcut is M-S-<up>/<down> and works perfectly.

The following patch adds this info to the manual.  It also
justifies the lines to look prettier in info.

Gregor


---
 doc/org.texi | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/doc/org.texi b/doc/org.texi
index 6d25df1..49bc562 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -6136,13 +6136,14 @@ from the minibuffer:
 @kindex M-S-@key{left}
 @kindex @key{RET}
 @example
-@key{RET}           @r{Choose date at cursor in calendar.}
-mouse-1        @r{Select date by clicking on it.}
-S-@key{right}/@key{left}     @r{One day forward/backward.}
-S-@key{down}/@key{up}     @r{One week forward/backward.}
-M-S-@key{right}/@key{left}   @r{One month forward/backward.}
-> / <          @r{Scroll calendar forward/backward by one month.}
-M-v / C-v      @r{Scroll calendar forward/backward by 3 months.}
+@key{RET}              @r{Choose date at cursor in calendar.}
+mouse-1            @r{Select date by clicking on it.}
+S-@key{right}/@key{left}   @r{One day forward/backward.}
+S-@key{down}/@key{up}      @r{One week forward/backward.}
+M-S-@key{right}/@key{left} @r{One month forward/backward.}
+> / <              @r{Scroll calendar forward/backward by one month.}
+M-v / C-v          @r{Scroll calendar forward/backward by 3 months.}
+M-S-@key{down}/@key{up}    @r{Scroll calendar forward/backward by one year.}
 @end example
 
 @vindex org-read-date-display-live
-- 
2.1.4


Ciao, Gregor
-- 
 -... --- .-. . -.. ..--.. ...-.-

Re: PATCH: Document how to scroll calendar by one year at date prompt.

[Nicolas Goaziou]

Hello,

Gregor Zattler <telegraph@gmx.net> writes:

> Hi Jens, org-mode developers,
> * Haustedt, Jens <j.haustedt@euroimmun.de> [19. Mar. 2015]:
>> in the description of the date/time prompt, a section describes the
>> control of the calendar from the minibuffer.
>> 
>> There, a description of scrolling the calendar by 1 year is missing. The
>> keyboard shortcut is M-S-<up>/<down> and works perfectly.
>
> The following patch adds this info to the manual.  It also
> justifies the lines to look prettier in info.

Thank you. 

Could you send it again using "git format-patch" and add an appropriate
commit message?

Regards,

-- 
Nicolas Goaziou

Re: PATCH: Document how to scroll calendar by one year at date prompt.

[Gregor Zattler]

Hi Nicolas,
* Nicolas Goaziou <mail@nicolasgoaziou.fr> [22. Mar. 2015]:
> Gregor Zattler <telegraph@gmx.net> writes:
>> * Haustedt, Jens <j.haustedt@euroimmun.de> [19. Mar. 2015]:
>>> in the description of the date/time prompt, a section describes the
>>> control of the calendar from the minibuffer.
>>> 
>>> There, a description of scrolling the calendar by 1 year is missing. The
>>> keyboard shortcut is M-S-<up>/<down> and works perfectly.
>>
>> The following patch adds this info to the manual.  It also
>> justifies the lines to look prettier in info.
> 
> Thank you. 
> 
> Could you send it again using "git format-patch" and add an appropriate
> commit message?

Sure.  In this iteration I also added the respective keys to the
Key index.

Ciao, Gregor
-- >8 --
Subject: [PATCH 1/1] How to scroll calendar by one year at date prompt.

Add respective keys to the Key index.  Also justify the lines in this
block to look prettier in info.
---
 doc/org.texi | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/doc/org.texi b/doc/org.texi
index 6d25df177d93847dba0f310e6506e5c3c8d2aa40..6b56c4aac6bb802c36a3b076f2ef4bb97019b788 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -6135,14 +6135,18 @@ from the minibuffer:
 @kindex M-S-@key{right}
 @kindex M-S-@key{left}
 @kindex @key{RET}
-@example
-@key{RET}           @r{Choose date at cursor in calendar.}
-mouse-1        @r{Select date by clicking on it.}
-S-@key{right}/@key{left}     @r{One day forward/backward.}
-S-@key{down}/@key{up}     @r{One week forward/backward.}
-M-S-@key{right}/@key{left}   @r{One month forward/backward.}
-> / <          @r{Scroll calendar forward/backward by one month.}
-M-v / C-v      @r{Scroll calendar forward/backward by 3 months.}
+@kindex M-S-@key{down}
+@kindex M-S-@key{up}
+
+@example
+@key{RET}              @r{Choose date at cursor in calendar.}
+mouse-1            @r{Select date by clicking on it.}
+S-@key{right}/@key{left}   @r{One day forward/backward.}
+S-@key{down}/@key{up}      @r{One week forward/backward.}
+M-S-@key{right}/@key{left} @r{One month forward/backward.}
+> / <              @r{Scroll calendar forward/backward by one month.}
+M-v / C-v          @r{Scroll calendar forward/backward by 3 months.}
+M-S-@key{down}/@key{up}    @r{Scroll calendar forward/backward by one year.}
 @end example
 
 @vindex org-read-date-display-live
-- 
2.1.4

Re: PATCH: Document how to scroll calendar by one year at date prompt.

[Nicolas Goaziou]

Gregor Zattler <telegraph@gmx.net> writes:

> Sure.  In this iteration I also added the respective keys to the
> Key index.

Applied. Thank you.

I added TINYCHANGE at the end of the commit message, since you don't
seem to have signed FSF papers. Please correct me if I'm wrong.

Regards,

signing of FSF papers needed for documentation changes? (was: Re: PATCH: Document how to scroll calendar by one year at date prompt.)

[Gregor Zattler]

Hi Nicolas,
* Nicolas Goaziou <mail@nicolasgoaziou.fr> [23. Mar. 2015]:
> I added TINYCHANGE at the end of the commit message, since you don't
> seem to have signed FSF papers. Please correct me if I'm wrong.

You are right.  Thanks.

Do these copyright/assigment issues also apply to documentation
chenges?  One would only be allowed to do max n lines of
documentation changes without legal paperwork with the FSF?

Ciao, Gregor
-- 
 -... --- .-. . -.. ..--.. ...-.-

Re: signing of FSF papers needed for documentation changes?

[Nicolas Goaziou]

Gregor Zattler <telegraph@gmx.net> writes:

> Do these copyright/assigment issues also apply to documentation
> chenges?

I think so.

Regards,