From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carsten Dominik Subject: Re: Notes on documentation Date: Sun, 12 Oct 2008 08:30:01 +0200 Message-ID: <8978330A-1E10-436E-9B9E-3ECDE765BDB9@uva.nl> References: <48F114F1.1000400@sift.info> Mime-Version: 1.0 (Apple Message framework v929.2) Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes Content-Transfer-Encoding: 7bit Return-path: Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1KouSw-0000YB-3m for emacs-orgmode@gnu.org; Sun, 12 Oct 2008 02:30:10 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1KouSt-0000Xx-It for emacs-orgmode@gnu.org; Sun, 12 Oct 2008 02:30:08 -0400 Received: from [199.232.76.173] (port=34139 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1KouSt-0000Xu-Cf for emacs-orgmode@gnu.org; Sun, 12 Oct 2008 02:30:07 -0400 Received: from mx20.gnu.org ([199.232.41.8]:59210) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1KouSt-0005p7-CY for emacs-orgmode@gnu.org; Sun, 12 Oct 2008 02:30:07 -0400 Received: from ey-out-1920.google.com ([74.125.78.147]) by mx20.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1KouSs-0004Lm-3q for emacs-orgmode@gnu.org; Sun, 12 Oct 2008 02:30:06 -0400 Received: by ey-out-1920.google.com with SMTP id 4so482722eyg.24 for ; Sat, 11 Oct 2008 23:30:04 -0700 (PDT) In-Reply-To: <48F114F1.1000400@sift.info> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Robert Goldman Cc: emacs-orgmode@gnu.org Hi Robert, On Oct 11, 2008, at 11:04 PM, Robert Goldman wrote: > I was reading over the agenda documentation in my current version of > org > (6.08c) and noted a couple of things: > > 1. (nit): in the discussion of finding stuck projects: > > "Lets[sic -- Let's] further" fixed, thanks. > > > 2. In "The weekly/daily agenda": > > " (1) For backward compatibility, the universal prefix `C-u' causes > all TODO entries to be listed before the agenda. This feature is > deprecated, use the dedicated TODO list, or a block agenda instead." > > Would it be possible to expand this a little? In particular: > > a. I use this because I like to have the todo list with my weekly > agenda, so that I can pick todo items to schedule in context. I > guess I > don't off-hand see how having a view that only has the todo items > would > replace this now-deprecated usage pattern. Including the TODO list with the agenda can serve two purposes. 1. To see the TODO list at all. This goal can be achieved by looking at the TODO list. 2. To see the TODO list together with the agenda. For this use a block agenda. > b. Reading this, I didn't know what a "block agenda" was. Would it > be > possible to add a cross reference to the Block Agenda section at this > point so that ignorant readers like me could easily find out more > about > block agendas? I know that one need only look to the table of > contents > to find this page, but when reading hypertext documentation one often > drills in deep and doesn't have a good sense of context. And it would > be an easy addition to make. [Indeed, the block agenda is exactly > what > I should be using...] I have added the cross reference, thanks. - Carsten