From mboxrd@z Thu Jan 1 00:00:00 1970 From: Suvayu Ali Subject: Re: User Defined Functions in Agenda Views Date: Sun, 22 Sep 2013 11:03:48 +0200 Message-ID: <20130922090348.GF28580@kuru.dyndns-at-home.com> References: <6F30E9CD-36ED-4281-BD6F-0D3B623393B9@pobox.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:57909) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VNfaA-0007Mv-Te for emacs-orgmode@gnu.org; Sun, 22 Sep 2013 05:04:04 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VNfa5-0003AC-75 for emacs-orgmode@gnu.org; Sun, 22 Sep 2013 05:03:58 -0400 Received: from mail-wi0-x22a.google.com ([2a00:1450:400c:c05::22a]:42154) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VNfa5-0003A5-0V for emacs-orgmode@gnu.org; Sun, 22 Sep 2013 05:03:53 -0400 Received: by mail-wi0-f170.google.com with SMTP id cb5so1159373wib.1 for ; Sun, 22 Sep 2013 02:03:52 -0700 (PDT) Content-Disposition: inline In-Reply-To: <6F30E9CD-36ED-4281-BD6F-0D3B623393B9@pobox.com> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org Hi Mike, On Sat, Sep 21, 2013 at 02:18:47PM -0400, Mike McLean wrote: > Hello > > I looked at the doc string for ~org-agenda-custom-commands~ and noticed that the you can use a user-defined function as a valid command type. I did not find anything in the documentation that describes how that user-defined function should work, what it should do, or how to write one. I looked at the code for other agenda types, such as ~tags-todo~ and ~occur-tree~ and have guessed at how to form one of these. > > I can write documentation and samples if anyone want it (either to add to Org documentation or as a page on Worg), but want to ensure that I understand completely and correctly, first. > My understanding of the Agenda is not great so I'll point you to a Worg page: If you think you can add to it, please go ahead. That said, I think it would be worthwhile to add some information on the expected function signature in the docstring instead of just – "A user-defined function". Hope this helps, -- Suvayu Open source is the future. It sets us free.