* Bug: second batch of small documentation problems [9.0 (9.0-elpaplus @ /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/)]
@ 2016-11-06 12:55 Jorge Morais Neto
2016-11-07 0:20 ` Nicolas Goaziou
0 siblings, 1 reply; 6+ messages in thread
From: Jorge Morais Neto @ 2016-11-06 12:55 UTC (permalink / raw)
To: org mode
Finally the second batch I promised. Sorry for having taken this long.
- org-table-convert-region docstring is less complete than the manual\\
The docstring contains the line:
#+BEGIN_QUOTE
integer When a number, use that many spaces as field separator
#+END_QUOTE
[[info:org#Built-in table editor]] says:
#+BEGIN_QUOTE
a numeric argument N indicates that at least N consecutive spaces, or
alternatively a TAB will be the separator.
#+END_QUOTE
In the latter, notice the "or alternatively a TAB". I believe the docstring
should be complete, so please add this information.
- org-archive-to-archive-sibling ARCHIVE_TIME property\\
org-archive-to-archive-sibling adds an ARCHIVE_TIME property. This should be
documented in the docstring and probably also in the manual.
- [[info:org#The very busy C-c C-c key]]
#+BEGIN_QUOTE
− If the current buffer is a capture buffer, close the note and file it.
With a prefix argument, file it, without further interaction, to the
default location.
#+END_QUOTE
Actually, according to [[info:org#Using capture]] and to my quick test,
C-c C-c restores the original window configuration, /and the effect of C-u is
to make it also jump to the captured item/.
- org-match-sparse-tree’s docstring omits it can also match properties.
- [[info:org#Setting tags]] should inform that tag letters for the single-key
interface are case-sensitive. In "For this to work well you should assign
unique letters to most of your commonly used tags.", replace "assign unique
letters" → "assign unique letters (case-sensitive)". After "In this
interface, you can use the following keys:", please write "a-zA-Z" instead of
"a-z". Finally, in the docstring of org-tag-alist, please replace "SELECT is
a character" → "SELECT is a case-sensitive letter".
- org-capture’s docstring could mention ID creation\\
org-capture creates an ID property if org-id-link-to-org-use-id is set to t.
This is already documented in that option’s docstring, but perhaps it should
also be documented in org-capture’s docstring and [[info:org#Using capture]].
The reason is that if a user is surprised that org-capture created an ID
property, he will look in org-capture’s docstring or perhaps in the manual
section. He may not remember to check org-id-link-to-org-use-id’s docstring.
- org-startup-folded’s docstring misreports the default value of
org-agenda-inhibit-startup. The docstring’s last paragraph need changing.
- org-agenda-todo-ignore-deadlines’ docstring about ’far
The documentation of 'far says:
#+BEGIN_QUOTE
Don’t show TODO entries where a deadline has been defined, but the deadline
is not near. This is useful if you don’t want to use the todo list to figure
out what to do now.
#+END_QUOTE
I do not understand this reasoning.
- I believe that many people use .emacs.d/init.el instead of .emacs. To better
reflect this reality, should not Org’s manual use the expression "Emacs init
file" instead of ".emacs"?
- Typos and small corrections:
- Docstring of org-agenda-show-inherited-tags
#+BEGIN_QUOTE
when the value of ‘org-agenda-use-tag-inheritance’ has been taken into
account.
#+END_QUOTE
"has been taken into account." → "enables tag inheritance for the given
agenda type."
- Docstring of org-agenda-week-view\\
In "Switch to daily view for agenda", "daily" → "weekly".
Emacs : GNU Emacs 25.1.1 (x86_64-unknown-linux-gnu, GTK+ Version 3.18.9)
of 2016-09-18
Package: Org mode version 9.0 (9.0-elpaplus @
/home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/)
current state:
==============
(setq
org-capture-prepare-finalize-hook '(J-insert-created-and-id-all)
org-clocktable-defaults '(:maxlevel 2 :lang "en" :scope file :block nil
:wstart 1
:mstart 1 :tstart nil :tend nil :step nil :stepskip0
nil
:fileskip0 nil :tags nil :emphasize nil :link nil
:narrow 40!
:indent t :formula nil :timestamp nil :level nil
:tcolumns nil
:formatter nil)
org-tab-first-hook '(org-babel-hide-result-toggle-maybe
org-babel-header-arg-expand)
org-footnote-section "Notas de rodapé"
org-icalendar-combined-agenda-file "~/org/org.ics"
org-insert-heading-hook '(org-id-get-create t)
org-speed-command-hook '(org-speed-command-default-hook
org-babel-speed-command-hook)
org-special-ctrl-k t
org-agenda-entry-text-maxlines 3
org-occur-hook '(org-first-headline-recenter)
org-metaup-hook '(org-babel-load-in-session-maybe)
org-html-format-drawer-function #[514 "\207" [] 3 "\n\n(fn NAME CONTENTS)"]
org-priority-faces '((65 :slant italic :weight bold :foreground "red"
:background
"black")
(66 :slant italic :weight bold :foreground "red"
:background "cyan")
(67 :slant italic :weight bold :foreground "red")
(68 :slant italic :weight bold) (69 . italic) (70
. default)
(71 :foreground "gold") (72 :foreground "yellow")
(73 :foreground "#ffff50"))
org-latex-format-inlinetask-function
'org-latex-format-inlinetask-default-function
org-confirm-shell-link-function 'yes-or-no-p
org-id-link-to-org-use-id 'create-if-interactive
org-finalize-agenda-hook '(J-org-agenda-to-appt-refresh)
org-after-tags-change-hook '(org-expiry-insert-created)
org-ascii-format-inlinetask-function 'org-ascii-format-inlinetask-default
org-icalendar-use-deadline '(event-if-not-todo event-if-todo todo-due)
org-export-default-language "pt_BR"
org-agenda-sticky t
org-list-allow-alphabetical t
org-special-ctrl-a/e t
org-ascii-text-width 79
org-agenda-custom-commands '(("j" "Now, agenda and TODOs"
((tags "now" nil)
(agenda ""
((org-agenda-span 1)
(org-agenda-time-grid (quote (nil nil nil))))
)
(tags-todo "-dia-@GYNO"
((org-agenda-todo-ignore-deadlines (quote
all))
(org-agenda-todo-ignore-scheduled (quote
all))
(org-agenda-todo-ignore-timestamp
org-deadline-warning-days)
)
)
)
((org-agenda-compact-blocks t)
(org-agenda-tags-todo-honor-ignore-options t)
(org-agenda-tag-filter-preset (quote
("-hide"))))
)
("p" "Now, agenda and TODOs (personal)"
((tags "now" nil)
(agenda ""
((org-agenda-span 1)
(org-agenda-time-grid (quote (nil nil nil))))
)
(tags-todo "-dia-@GYNO"
((org-agenda-todo-ignore-deadlines (quote
all))
(org-agenda-todo-ignore-scheduled (quote
all))
(org-agenda-todo-ignore-timestamp
org-deadline-warning-days)
)
)
)
((org-agenda-compact-blocks t)
(org-agenda-tags-todo-honor-ignore-options t)
(org-agenda-tag-filter-preset (quote ("-@WO"
"-hide"))))
)
("w" "Now, agenda and TODOs (work)"
((tags "now" nil)
(agenda ""
((org-agenda-span 1)
(org-agenda-time-grid (quote (nil nil nil))))
)
(tags-todo "-dia"
((org-agenda-todo-ignore-deadlines (quote
all))
(org-agenda-todo-ignore-scheduled (quote
all))
(org-agenda-todo-ignore-timestamp
org-deadline-warning-days)
)
)
)
((org-agenda-compact-blocks t)
(org-agenda-tags-todo-honor-ignore-options t)
(org-agenda-tag-filter-preset
(quote ("+@w" "-@CASAO" "-hide")))
)
)
)
org-latex-format-headline-function 'org-latex-format-headline-default-function
org-expiry-handler-function 'org-toggle-archive-tag
org-expiry-inactive-timestamps t
org-todo-keyword-faces '(("DELEGATED" . "cyan") ("FEEDBACK_" . "#0080FF")
("FEEDBACK" . "blue") ("FIX_COMMITTED" . "cyan"))
org-capture-templates '(("g" "Tarefa pessoal" entry
(id "700430e5-0c9d-498a-beb6-db384cd34655") "* TODO
%i%?")
("G" "Entrada pessoal" entry
(id "700430e5-0c9d-498a-beb6-db384cd34655") "* %i%?")
("w" "Tarefa de trabalho" entry
(id "9f62fc99-2050-40a9-a751-cdab2051c629") "* TODO
%i%?")
("W" "Entrada de trabalho" entry
(id "9f62fc99-2050-40a9-a751-cdab2051c629") "* %i%?")
("a" "Templates com tags :now:mtnt:")
("ag" "Tarefa pessoal :now:mtnt:" entry
(id "4be6b760-4677-450c-a0a3-84955a413547") "* TODO
%i%?")
("aG" "Entrada pessoal :now:mtnt:" entry
(id "4be6b760-4677-450c-a0a3-84955a413547") "* %i%?")
("aw" "Tarefa de trabalho :now:mtnt:" entry
(id "2fce891b-3836-484f-adeb-0d5d43daad1c") "* TODO
%i%?")
("aW" "Entrada de trabalho :now:mtnt:" entry
(id "2fce891b-3836-484f-adeb-0d5d43daad1c") "* %i%?")
)
org-icalendar-use-scheduled '(event-if-todo todo-start)
org-after-todo-state-change-hook '(org-clock-out-if-current
org-expiry-insert-created)
org-latex-format-drawer-function #[514 "\207" [] 3 "\n\n(fn _ CONTENTS)"]
org-odt-format-headline-function 'org-odt-format-headline-default-function
org-use-tag-inheritance "[^_]$"
org-icalendar-timezone "Brazil/East"
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-global-properties '(("Effort_ALL" .
"0:02 0:05 0:15 0:30 1:00 2:00 4:00 8:00 16:00 40:00
80:00 160:00")
)
org-log-redeadline 'note
org-mobile-allpriorities "A B C D E F G H I"
org-trigger-hook '(org-depend-trigger-todo)
org-mode-hook '(J-org-init
#[0 "\300\301\302\303\304$\207"
[add-hook change-major-mode-hook org-show-block-all append
local] 5]
#[0 "\300\301\302\303\304$\207"
[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-eldoc-load)
org-refile-targets '((org-agenda-files :tag . "target_")
(org-agenda-files :maxlevel . 3))
org-outline-path-complete-in-steps nil
org-archive-hook '(org-attach-archive-delete-maybe)
org-agenda-sorting-strategy '((agenda habit-down time-up priority-down
category-keep)
(todo priority-down category-keep)
(tags todo-state-down priority-down
category-keep)
(search category-keep))
org-ascii-format-drawer-function #[771 " \207" [] 4 "\n\n(fn NAME
CONTENTS WIDTH)"]
org-odt-format-inlinetask-function 'org-odt-format-inlinetask-default-function
org-refile-use-outline-path t
org-enforce-todo-dependencies t
org-cycle-hook '(org-cycle-hide-archived-subtrees org-cycle-hide-drawers
org-cycle-show-empty-lines org-optimize-window-after-visibility-change)
org-load-hook '((lambda nil (require (quote J-org))))
org-log-refile 'time
org-agenda-finalize-hook '(J-org-agenda-to-appt-refresh)
org-lowest-priority 73
org-log-reschedule 'note
org-todo-keywords '((sequence "TODO(t@)" "FEEDBACK_(F@)" "FEEDBACK(f@)"
"CONTINUE(o@)"
"|" "DONE(d@)")
(sequence "|" "CANCELED(c@)") (sequence "|"
"DELEGATED(e@)")
(sequence "|" "FIX_COMMITTED(i@)"))
org-modules '(org-bbdb org-bibtex org-docview org-gnus org-id org-info org-irc
org-mhe
org-rmail org-w3m org-depend org-expiry)
org-fast-tag-selection-single-key t
org-link-abbrev-alist '(("google" . "https://www.google.com/search?q="))
org-catch-invisible-edits 'error
org-confirm-elisp-link-function 'yes-or-no-p
org-metadown-hook '(org-babel-pop-to-session-maybe)
org-expiry-wait "+10y"
org-odt-format-drawer-function #[514 "\207" [] 3 "\n\n(fn NAME CONTENTS)"]
org-icalendar-store-UID t
org-default-priority 70
org-blocker-hook '(org-depend-block-todo
org-block-todo-from-children-or-siblings-or-parent)
org-icalendar-alarm-time 20
org-html-format-headline-function 'org-html-format-headline-default-function
org-link-parameters '(("w3m" :store org-w3m-store-link)
("rmail" :follow org-rmail-open :store
org-rmail-store-link)
("mhe" :follow org-mhe-open :store org-mhe-store-link)
("irc" :follow org-irc-visit :store org-irc-store-link)
("info" :follow org-info-open :export org-info-export
:store
org-info-store-link)
("id" :follow org-id-open)
("gnus" :follow org-gnus-open :store
org-gnus-store-link)
("docview" :follow org-docview-open :export
org-docview-export
:store org-docview-store-link)
("bibtex" :follow org-bibtex-open :store
org-bibtex-store-link)
("bbdb" :follow org-bbdb-open :export org-bbdb-export
:complete
org-bbdb-complete-link :store org-bbdb-store-link)
("file+sys") ("file+emacs") ("doi" :follow
org--open-doi-link)
("elisp" :follow org--open-elisp-link)
("file" :complete org-file-complete-link)
("ftp" :follow (lambda (path) (browse-url (concat "ftp:"
path))))
("help" :follow org--open-help-link)
("http" :follow (lambda (path) (browse-url (concat
"http:" path))))
("https" :follow
(lambda (path) (browse-url (concat "https:" path))))
("mailto" :follow
(lambda (path) (browse-url (concat "mailto:" path))))
("message" :follow
(lambda (path) (browse-url (concat "message:" path))))
("news" :follow (lambda (path) (browse-url (concat
"news:" path))))
("shell" :follow org--open-shell-link))
org-mobile-directory "~/Dropbox/MobileOrg"
org-icalendar-with-timestamps nil
org-export-with-smart-quotes t
org-tag-faces '(("now" . "red") ("MR" . "#C00000") ("h" . "#C0C0C0") ("dia"
. "#606060")
("r" . "#900000") ("va_" . "red"))
org-html-format-inlinetask-function
'org-html-format-inlinetask-default-function
org-agenda-files '("~/org/agenda/"
"~/Dropbox/wanessa_e_jorge/administração_clínica/derma-prime.org")
org-clock-out-hook '(org-clock-remove-empty-clock-drawer)
org-mobile-inbox-for-pull "~/org/agenda/from-mobile.org"
org-tag-alist '(("va_" . 97) ("carreira") (:startgroup) ("@casa" . 99)
(:grouptags)
("@CASAO" . 67) (:endgroup) (:startgroup) ("dia" . 100)
(:grouptags)
("h" . 104) (:endgroup) ("target_" . 101) ("distração")
("gagá")
(:startgroup) ("@gyn" . 103) (:grouptags) ("@GYNO" . 71)
(:endgroup)
(:startgroup) ("hide") (:grouptags) ("hide_" . 72) (:endgroup)
("Igreja" . 105) ("cai_muito" . 109) ("memorize" . 77)
(:startgroup)
("r" . 114) (:grouptags) ("MR" . 82) (:endgroup) ("now" . 110)
(:startgroup) ("pd" . 112) (:grouptags) ("{pd_.*}")
(:endgroup)
("política") ("saúde" . 115) ("social" . 83) ("mtnt" . 116)
("TIC" . 84)
(:startgroup) ("@w" . 119) (:grouptags) ("@w_") ("@WO" . 87) (:endgroup))
)
--
• I am Brazilian. I hope my English is correct and I welcome corrections.
• Please adopt free formats like PDF, ODF, Org, LaTeX, Opus, WebM and 7z.
• Free (as in free speech) software for Android: https://f-droid.org/
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Bug: second batch of small documentation problems [9.0 (9.0-elpaplus @ /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/)]
2016-11-06 12:55 Bug: second batch of small documentation problems [9.0 (9.0-elpaplus @ /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/)] Jorge Morais Neto
@ 2016-11-07 0:20 ` Nicolas Goaziou
2016-11-07 10:57 ` Jorge Morais Neto
0 siblings, 1 reply; 6+ messages in thread
From: Nicolas Goaziou @ 2016-11-07 0:20 UTC (permalink / raw)
To: Jorge Morais Neto; +Cc: org mode
Hello,
Jorge Morais Neto <jorge13515@gmail.com> writes:
> Finally the second batch I promised.
Thank you.
> - org-table-convert-region docstring is less complete than the manual\\
> The docstring contains the line:
>
> #+BEGIN_QUOTE
> integer When a number, use that many spaces as field separator
> #+END_QUOTE
>
>
> [[info:org#Built-in table editor]] says:
>
> #+BEGIN_QUOTE
> a numeric argument N indicates that at least N consecutive spaces, or
> alternatively a TAB will be the separator.
> #+END_QUOTE
>
> In the latter, notice the "or alternatively a TAB". I believe the docstring
> should be complete, so please add this information.
Fixed.
> - org-archive-to-archive-sibling ARCHIVE_TIME property\\
> org-archive-to-archive-sibling adds an ARCHIVE_TIME property.This should be
> documented in the docstring
Done.
> and probably also in the manual.
I'm not sure it belongs to the manual, as it is more of an
implementation detail. For the time being, I don't add it.
> - [[info:org#The very busy C-c C-c key]]
>
> #+BEGIN_QUOTE
> If the current buffer is a capture buffer, close the note and file it.
> With a prefix argument, file it, without further interaction, to the
> default location.
> #+END_QUOTE
>
> Actually, according to [[info:org#Using capture]] and to my quick test,
> C-c C-c restores the original window configuration, /and the effect of C-u is
> to make it also jump to the captured item/.
Fixed.
> - org-match-sparse-tree’s docstring omits it can also match
> properties.
Fixed.
> - [[info:org#Setting tags]] should inform that tag letters for the single-key
> interface are case-sensitive. In "For this to work well you should assign
> unique letters to most of your commonly used tags.", replace "assign unique
> letters" → "assign unique letters (case-sensitive)". After "In this
> interface, you can use the following keys:", please write "a-zA-Z" instead of
> "a-z". Finally, in the docstring of org-tag-alist, please replace "SELECT is
> a character" → "SELECT is a case-sensitive letter".
Done.
> - org-capture’s docstring could mention ID creation\\
> org-capture creates an ID property if org-id-link-to-org-use-id is set to t.
> This is already documented in that option’s docstring, but perhaps it should
> also be documented in org-capture’s docstring and [[info:org#Using capture]].
> The reason is that if a user is surprised that org-capture created an ID
> property, he will look in org-capture’s docstring or perhaps in the manual
> section. He may not remember to check org-id-link-to-org-use-id’s
> docstring
`org-capture' itself doesn't check `org-id-link-to-org-use-id' so it
would be confusing to write about it in the docstring. I didn't find an
adequate location for this (`org-capture-templates' maybe), so I didn't
change anything here.
> - org-startup-folded’s docstring misreports the default value of
> org-agenda-inhibit-startup. The docstring’s last paragraph need changing.
Done.
> - org-agenda-todo-ignore-deadlines’ docstring about ’far
> The documentation of 'far says:
>
> #+BEGIN_QUOTE
> Dont show TODO entries where a deadline has been defined, but the deadline
> is not near. This is useful if you dont want to use the todo list to figure
> out what to do now.
> #+END_QUOTE
>
> I do not understand this reasoning.
Fixed.
> - I believe that many people use .emacs.d/init.el instead of .emacs. To better
> reflect this reality, should not Org’s manual use the expression "Emacs init
> file" instead of ".emacs"?
I agree. Done.
> - Typos and small corrections:
> - Docstring of org-agenda-show-inherited-tags
>
> #+BEGIN_QUOTE
> when the value of org-agenda-use-tag-inheritance has been taken into
> account.
> #+END_QUOTE
>
> "has been taken into account." → "enables tag inheritance for the given
> agenda type."
Done.
> - Docstring of org-agenda-week-view\\
> In "Switch to daily view for agenda", "daily" → "weekly".
Done.
Regards,
--
Nicolas Goaziou
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Bug: second batch of small documentation problems [9.0 (9.0-elpaplus @ /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/)]
2016-11-07 0:20 ` Nicolas Goaziou
@ 2016-11-07 10:57 ` Jorge Morais Neto
2016-11-12 0:47 ` Nicolas Goaziou
0 siblings, 1 reply; 6+ messages in thread
From: Jorge Morais Neto @ 2016-11-07 10:57 UTC (permalink / raw)
To: Jorge Morais Neto, org mode
I have some observations about your fixes:
1. Tag keys (for fast selection)
1) When clarifying that tag keys are case-sensitive letters, we
forgot to adjust
org-tag-persistent-alist’s docstring. Please adjust it.
2) And now that I think of it, is it appropriate to write "a-zA-Z" in
[[info:org#Setting tags]]? Are only these characters allowed
and no others?
2. Your changes to [[info:org#The very busy C-c C-c key]]:
#+BEGIN_QUOTE
-If the current buffer is a capture buffer, close the note and file it.
-With a prefix argument, file it, without further interaction, to the
-default location.
+If the current buffer is a capture buffer, close the note and file it. With
+a prefix argument, jump to the target location, without capturing anything.
#+END_QUOTE
The last added sentence seems to actually describe "C-u C-c c" instead of
"C-u C-c C-c".
3. The new docstring of org-startup-folded
#+BEGIN_QUOTE
Set `org-agenda-inhibit-startup' to a non-nil value so as to ignore this
option when Org opens agenda files for the first time.
#+END_QUOTE
The way that excerpt is written, it seems to me that it actively recommends
setting org-agenda-inhibit-startup to a non-nil value. We could replace "so
as to" → "if you want to". But maybe this is me misunderstanding English –
my second language – or just being pedantic, I don’t know.
And thank you very much for helping Org! When the Brazilian real gains a little
more value, I intend to make a donation. And when I become less overloaded, I
intend to study Emacs Lisp and start writing some patches.
Regards.
--
• I am Brazilian. I hope my English is correct and I welcome corrections.
• Please adopt free formats like PDF, ODF, Org, LaTeX, Opus, WebM and 7z.
• Free (as in free speech) software for Android: https://f-droid.org/
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Bug: second batch of small documentation problems [9.0 (9.0-elpaplus @ /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/)]
2016-11-07 10:57 ` Jorge Morais Neto
@ 2016-11-12 0:47 ` Nicolas Goaziou
2016-11-12 19:56 ` Jorge Morais Neto
0 siblings, 1 reply; 6+ messages in thread
From: Nicolas Goaziou @ 2016-11-12 0:47 UTC (permalink / raw)
To: Jorge Morais Neto; +Cc: org mode
Hello,
Jorge Morais Neto <jorge13515@gmail.com> writes:
> I have some observations about your fixes:
>
> 1. Tag keys (for fast selection)
> 1) When clarifying that tag keys are case-sensitive letters, we
> forgot to adjust
> org-tag-persistent-alist’s docstring. Please adjust it.
`org-tag-persistent-alist' is about "characters". I think it is clear
that characters are case-sensitive already.
> 2) And now that I think of it, is it appropriate to write "a-zA-Z" in
> [[info:org#Setting tags]]? Are only these characters allowed
> and no others?
AFAICT any character is allow, but how could we formulate this?.
>
> 2. Your changes to [[info:org#The very busy C-c C-c key]]:
>
> #+BEGIN_QUOTE
> -If the current buffer is a capture buffer, close the note and file it.
> -With a prefix argument, file it, without further interaction, to the
> -default location.
> +If the current buffer is a capture buffer, close the note and file it. With
> +a prefix argument, jump to the target location, without capturing anything.
> #+END_QUOTE
>
> The last added sentence seems to actually describe "C-u C-c c" instead of
> "C-u C-c C-c".
Fixed.
> 3. The new docstring of org-startup-folded
>
> #+BEGIN_QUOTE
> Set `org-agenda-inhibit-startup' to a non-nil value so as to ignore this
> option when Org opens agenda files for the first time.
> #+END_QUOTE
>
> The way that excerpt is written, it seems to me that it actively recommends
> setting org-agenda-inhibit-startup to a non-nil value. We could replace "so
> as to" → "if you want to". But maybe this is me misunderstanding English –
> my second language – or just being pedantic, I don’t know.
Done.
Thank you.
Regards,
--
Nicolas Goaziou
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Bug: second batch of small documentation problems [9.0 (9.0-elpaplus @ /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/)]
2016-11-12 0:47 ` Nicolas Goaziou
@ 2016-11-12 19:56 ` Jorge Morais Neto
2016-11-13 17:22 ` Nicolas Goaziou
0 siblings, 1 reply; 6+ messages in thread
From: Jorge Morais Neto @ 2016-11-12 19:56 UTC (permalink / raw)
To: Jorge Morais Neto, org mode
On 11 November 2016 at 22:47, Nicolas Goaziou <mail@nicolasgoaziou.fr> wrote:
> `org-tag-persistent-alist' is about "characters". I think it is clear
> that characters are case-sensitive already.
Currently, the docstring of org-tag-alist says "SELECT is a case-sensitive
letter" and the docstring of org-tag-persistent-alist says "SELECT is a
character". I thought I should point this out, but it is your call whether this
inconsistency needs to be fixed.
> AFAICT any character is allow, but how could we formulate this?.
Any Emacs character is allowed? If so, perhaps we could just say "SELECT is an
Emacs character (this includes all Unicode characters)". But beware that I
know little Org and very little Elisp, so please take my suggestion with a
grain of salt.
Regards
--
• I am Brazilian. I hope my English is correct and I welcome corrections.
• Please adopt free formats like PDF, ODF, Org, LaTeX, Opus, WebM and 7z.
• Free (as in free speech) software for Android: https://f-droid.org/
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Bug: second batch of small documentation problems [9.0 (9.0-elpaplus @ /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/)]
2016-11-12 19:56 ` Jorge Morais Neto
@ 2016-11-13 17:22 ` Nicolas Goaziou
0 siblings, 0 replies; 6+ messages in thread
From: Nicolas Goaziou @ 2016-11-13 17:22 UTC (permalink / raw)
To: Jorge Morais Neto; +Cc: org mode
Hello,
Jorge Morais Neto <jorge13515@gmail.com> writes:
> On 11 November 2016 at 22:47, Nicolas Goaziou <mail@nicolasgoaziou.fr> wrote:
>> `org-tag-persistent-alist' is about "characters". I think it is clear
>> that characters are case-sensitive already.
> Currently, the docstring of org-tag-alist says "SELECT is a case-sensitive
> letter" and the docstring of org-tag-persistent-alist says "SELECT is a
> character". I thought I should point this out, but it is your call whether this
> inconsistency needs to be fixed.
Fixed.
>> AFAICT any character is allow, but how could we formulate this?.
> Any Emacs character is allowed? If so, perhaps we could just say "SELECT is an
> Emacs character (this includes all Unicode characters)". But beware that I
> know little Org and very little Elisp, so please take my suggestion with a
> grain of salt.
I was speaking about Org manual. In any case, I worked around this.
Thank you.
Regards,
--
Nicolas Goaziou
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2016-11-13 17:22 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2016-11-06 12:55 Bug: second batch of small documentation problems [9.0 (9.0-elpaplus @ /home/jorge/.emacs.d/elpa/org-plus-contrib-20161102/)] Jorge Morais Neto
2016-11-07 0:20 ` Nicolas Goaziou
2016-11-07 10:57 ` Jorge Morais Neto
2016-11-12 0:47 ` Nicolas Goaziou
2016-11-12 19:56 ` Jorge Morais Neto
2016-11-13 17:22 ` Nicolas Goaziou
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).