[Orgmode] Re: Docs submitted

2009-02-11 Thread Bernt Hansen
Carsten Dominik domi...@science.uva.nl writes:

 On Feb 11, 2009, at 2:08 AM, Tom Breton (Tehom) wrote:

 (eval-after-load 'org
  '(progn
 ;;^--HERE.
 (add-to-list 'org-todo-setup-filter-hook
#'org-choose-setup-filter)
 (add-to-list 'org-todo-get-default-hook
#'org-choose-get-default-mark)
 (add-to-list 'org-trigger-hook
#'org-choose-keep-sensible)
 (add-to-list 'org-todo-interpretation-widgets
'(:tag Choose   (to record decisions) choose)
'append)
   ))


 Hi Tom,

 maybe you can educate me:  I have never understood what the # does
 in code like the one you have here.  You are using it, so maybe you
 know?

As I understand it (from my book on Common Lisp) #'some-function is used
to quote function names.  'some-function quotes a variable.

It means Get me the function with the following name - without the #',
Lisp would treat some-function as the name of a variable and look up the
value of the variable, not the function.

-Bernt


___
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode


[Orgmode] Re: Docs submitted (really #')

2009-02-11 Thread Robert Goldman

 Date: Wed, 11 Feb 2009 09:58:43 -0500
 From: Bernt Hansen be...@norang.ca
 Subject: [Orgmode] Re: Docs submitted
 To: Carsten Dominik domi...@science.uva.nl
 Cc: emacs-orgmode@gnu.org, Tom Breton \(Tehom\) te...@panix.com
 Message-ID: 87fxilggv0@gollum.intra.norang.ca
 Content-Type: text/plain; charset=us-ascii
 
 Carsten Dominik domi...@science.uva.nl writes:
 
 On Feb 11, 2009, at 2:08 AM, Tom Breton (Tehom) wrote:

 (eval-after-load 'org
  '(progn
 ;;^--HERE.
 (add-to-list 'org-todo-setup-filter-hook
   #'org-choose-setup-filter)
 (add-to-list 'org-todo-get-default-hook
   #'org-choose-get-default-mark)
 (add-to-list 'org-trigger-hook
   #'org-choose-keep-sensible)
 (add-to-list 'org-todo-interpretation-widgets
   '(:tag Choose   (to record decisions) choose)
   'append)
   ))

 Hi Tom,

 maybe you can educate me:  I have never understood what the # does
 in code like the one you have here.  You are using it, so maybe you
 know?
 
 As I understand it (from my book on Common Lisp) #'some-function is used
 to quote function names.  'some-function quotes a variable.
 
 It means Get me the function with the following name - without the #',
 Lisp would treat some-function as the name of a variable and look up the
 value of the variable, not the function.
 

In Common Lisp, #' is a reader macro that is an abbreviation for
function.  So #'foo is read as (function foo).

I'm not at all sure what #' means in elisp, which is not the same
programming language.  A quick peek at the Elisp info file didn't find
reader macros anywhere in there.

AFAIK for defining hooks a symbol will be interpreted as a function
name, won't it?  So replacing all of the #'s with 's above would work,
wouldn't it?

Best,
r


___
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode


Re: [Orgmode] Re: Docs submitted

2009-02-11 Thread Samuel Wales
The CL spec is online: http://www.lispworks.com/documentation/HyperSpec/Front/

In emacs lisp:

function is a special form in `C source code'.
(function arg)

Like `quote', but preferred for objects which are functions.
In byte compilation, `function' causes its argument to be compiled.
`quote' cannot do that.

[back]
--

-- 
Myalgic encephalomyelitis denialists are causing massive suffering and
25-years-early death by grossly corrupting science.
http://www.meactionuk.org.uk/What_Is_ME_What_Is_CFS.htm


___
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode


[Orgmode] Re: Docs submitted (Was Re: Advice sought on managing decision alternatives.)

2009-02-09 Thread Carsten Dominik

Hi Tom,

it looks like efficiency is *not* one of your problems.
Thanks a lot for getting this done so quickly.

I have just released Org-mode 6.22 which included org-choose.el.

As for the documentation, I have made some minor layout
changes (turned the level-1 heading into a title,
and promoted the level-2 headings).  I also modified
the Loading it section to reflect the fact that org-module
now has a checkbox for this package.

The resulting file is up on Worg at

http://orgmode.org/worg/org-contrib/org-choose.php

If you ever want to change anything in that document, just do
it yourself, in Worg.

Thanks for your contribution!

- Carsten



On Feb 10, 2009, at 4:14 AM, Tom Breton (Tehom) wrote:


Hi, Carsten.


Well, some ASCII documentation could be inserted into org-choose.el
as a file commentary.  If you use a standard header with keywords
for the finder (M-x finder-commentary and friends), that would be
useful.

Tutorials on Worg are usually written in Org, but you can upload
any format you like (or send it it me) and we wil publish it there.


OK, I've add comments, keywords, and some docstrings I forgot to
org-choose.el, and I wrote a standalone doc.  Both are attached.

Tom Breton (Tehom)
docs.org-choose.el.diffdocs.org-choose-docs.org




___
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode