From: Andrew Francis Swann <swann@math.au.dk>
To: Org mode <emacs-orgmode@gnu.org>
Subject: Bug: Description of org agenda columns format in manual not correct/misleading
Date: Wed, 14 Aug 2019 10:22:26 +0000 [thread overview]
Message-ID: <444878CE-0B62-47D1-9C6D-E9D1FD2ED01F@math.au.dk> (raw)
I am trying to work out how to specify the column view from the standard org-agenda-list command. The manual is confusing me, and I can see some of the variables have changed in commit cc020dbe4d . The documentation only seems to partially address this and does not fit with the documentation of the variables themselves. Please see below for more details.
This manual is for Org version 9.2.
Emacs : GNU Emacs 26.2 (build 1, x86_64-apple-darwin18.5.0, Carbon Version 158 AppKit 1671.4)
of 2019-04-14
Package: Org mode version 9.2.5 (9.2.5-1-gff6508-elpaplus @ /Users/au5316/.emacs.d/elpa/org-plus-contrib-20190812/)
In the info pages under Agenda Views > Agenda Column View point 1. says
1. Org needs to make a decision which columns format to use. Since
the entries in the agenda are collected from different files, and
different files may have different columns formats, this is a
non-trivial problem. Org first checks if the variable
‘org-overriding-columns-format’ is currently set, and if so, takes
the format from there. Otherwise it takes the format associated
with the first item in the agenda, or, if that item does not have a
specific format (defined in a property, or in its file), it uses
‘org-columns-default-format’.
However, it does not say how to set org-overriding-columns-format. The documentation for this variable gives
When set, overrides any other format definition for the agenda.
Don’t set this, this is meant for dynamic scoping. Set
‘org-local-columns-format’ instead.
and the documentation for org-local-columns-format says
When set, overrides any other format definition for the agenda.
This can be set as a buffer local value to avoid interfering with
dynamic scoping for ‘org-overriding-columns-format’.
--
Andrew Swann | Associate Professor | Tel +45 871 55767 | swann@math.au.dk | http://home.math.au.dk/swann/ | Department of Mathematics, Aarhus University, Ny Munkegade 118, Bldg 1530, DK-8000 Aarhus C, Denmark | Dept +45 871 50000 | Fax +45 8613 1769
next reply other threads:[~2019-08-14 10:22 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-08-14 10:22 Andrew Francis Swann [this message]
2019-08-14 10:33 ` Bug: Description of org agenda columns format in manual not correct/misleading Fraga, Eric
[not found] ` <10CB20C9-FCC0-45F5-8B34-CBFB24FAA185@math.au.dk>
2019-08-14 10:43 ` FW: " Andrew Francis Swann
2019-08-14 10:47 ` Fraga, Eric
[not found] ` <87tvak81rd.fsf@ucl.ac.uk>
2019-08-14 10:49 ` Andrew Francis Swann
2019-08-14 19:57 ` Nick Dokos
2019-08-15 7:50 ` Fraga, Eric
2019-08-16 7:52 ` Carsten Dominik
2019-08-16 11:46 ` Andrew Francis Swann
2019-08-16 12:26 ` Carsten Dominik
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=444878CE-0B62-47D1-9C6D-E9D1FD2ED01F@math.au.dk \
--to=swann@math.au.dk \
--cc=emacs-orgmode@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
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).