* Hook Function Examples
@ 2010-01-25 0:40 Mark Elston
2010-01-25 5:24 ` Nick Dokos
0 siblings, 1 reply; 5+ messages in thread
From: Mark Elston @ 2010-01-25 0:40 UTC (permalink / raw)
To: org-mode emacs-orgmode
I am trying to make use of some of the hooks for exporting and haven't
found any docs about what they take or how to make use of them (elisp
is *not* my native language).
In particular, I am trying to figure out how to use the following
to see if any of them are going to help me:
org-export-preprocess-hook
org-export-preprocess-after-tree-selection-hook
org-export-preprocess-final-hook
Any examples of a hook function for these would help a lot. In
particular, what are the parameters, is the point "looking at"
anything in particular, etc.
Mark
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Hook Function Examples
2010-01-25 0:40 Hook Function Examples Mark Elston
@ 2010-01-25 5:24 ` Nick Dokos
2010-01-25 6:21 ` Mark Elston
0 siblings, 1 reply; 5+ messages in thread
From: Nick Dokos @ 2010-01-25 5:24 UTC (permalink / raw)
To: Mark Elston; +Cc: org-mode emacs-orgmode
Mark Elston <m_elston@comcast.net> wrote:
> I am trying to make use of some of the hooks for exporting and haven't
> found any docs about what they take or how to make use of them (elisp
> is *not* my native language).
>
The Emacs Lisp Reference manual has a section (23.1: Hooks) on hooks,
but I'm not sure how helpful it will be to you. The most important note
is that "normal" hook variables are, by convention, named
<foo>-hook. "normal" means that the functions that are added to the hook
take no arguments and return no useful values.
> In particular, I am trying to figure out how to use the following
> to see if any of them are going to help me:
>
> org-export-preprocess-hook
> org-export-preprocess-after-tree-selection-hook
> org-export-preprocess-final-hook
>
> Any examples of a hook function for these would help a lot. In
> particular, what are the parameters, is the point "looking at"
> anything in particular, etc.
>
Use the source, Luke! (erm... Mark!)
C-h v org-export-preprocess-hook <RET>
gives me:
(org-export-blocks-preprocess)
so we have here an example of a hook function!
C-h f org-export-blocks-preprocess <RET>
gives you the function's doc string, including a link to where it is
defined, and clicking on the link will take you to the function: no
params (it is a "normal" hook after all), and I think you can make no
assumptions about the context. In particular, the above function wraps
everything in a save-excursion, goes to the beginning of the buffer and
searches for interesting things, doing something on each interesting
thing it finds.
The other two hooks are nil in my case, but I think similar things
would apply there too.
HTH,
Nick
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Hook Function Examples
2010-01-25 5:24 ` Nick Dokos
@ 2010-01-25 6:21 ` Mark Elston
2010-01-25 15:48 ` Nick Dokos
2010-01-28 18:22 ` Carsten Dominik
0 siblings, 2 replies; 5+ messages in thread
From: Mark Elston @ 2010-01-25 6:21 UTC (permalink / raw)
To: org-mode emacs-orgmode
On 1/24/2010 9:24 PM, Nick Dokos wrote:
> Mark Elston<m_elston@comcast.net> wrote:
>
>> I am trying to make use of some of the hooks for exporting and haven't
>> found any docs about what they take or how to make use of them (elisp
>> is *not* my native language).
>>
>
> The Emacs Lisp Reference manual has a section (23.1: Hooks) on hooks,
> but I'm not sure how helpful it will be to you. The most important note
> is that "normal" hook variables are, by convention, named
> <foo>-hook. "normal" means that the functions that are added to the hook
> take no arguments and return no useful values.
>
>> In particular, I am trying to figure out how to use the following
>> to see if any of them are going to help me:
>>
>> org-export-preprocess-hook
>> org-export-preprocess-after-tree-selection-hook
>> org-export-preprocess-final-hook
>>
>> Any examples of a hook function for these would help a lot. In
>> particular, what are the parameters, is the point "looking at"
>> anything in particular, etc.
>>
>
> Use the source, Luke! (erm... Mark!)
>
> C-h v org-export-preprocess-hook<RET>
>
> gives me:
>
> (org-export-blocks-preprocess)
>
Thanks, Nick. I had checked a few hooks (but not that one) and
couldn't find any that had any functions assigned.
> so we have here an example of a hook function!
>
> C-h f org-export-blocks-preprocess<RET>
>
> gives you the function's doc string, including a link to where it is
> defined, and clicking on the link will take you to the function: no
> params (it is a "normal" hook after all), and I think you can make no
> assumptions about the context. In particular, the above function wraps
> everything in a save-excursion, goes to the beginning of the buffer and
> searches for interesting things, doing something on each interesting
> thing it finds.
OK. From what I read I am assuming that a buffer is created with some
already-processed (though not completely) org data as its initial
content. Then, at some point, these hook functions are called on this
new buffer. I assume this is the case since you wouldn't want to go
modifying the original buffer - though this is not stated anywhere that
I can find.
Some hook functions apparently *do* take parameters (e.g.
org-cycle-hook, etc) and I wasn't sure about the ones that didn't
mention any.
I was just trying to find my way and didn't have a map of what was
where. Even the org-export-blocks-preprocess() function is a little
difficult to wade through for someone not really familiar with elisp.
I think I have pieced it together, though. This may give me what I need
to do what I want (remove some specific kinds of headers when creating
certain LaTeX files).
Are my assumptions above correct, then?
Mark
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Hook Function Examples
2010-01-25 6:21 ` Mark Elston
@ 2010-01-25 15:48 ` Nick Dokos
2010-01-28 18:22 ` Carsten Dominik
1 sibling, 0 replies; 5+ messages in thread
From: Nick Dokos @ 2010-01-25 15:48 UTC (permalink / raw)
To: Mark Elston; +Cc: org-mode emacs-orgmode
Mark Elston <m_elston@comcast.net> wrote:
>
> OK. From what I read I am assuming that a buffer is created with some
> already-processed (though not completely) org data as its initial
> content. Then, at some point, these hook functions are called on this
> new buffer. I assume this is the case since you wouldn't want to go
> modifying the original buffer - though this is not stated anywhere that
> I can find.
>
> Some hook functions apparently *do* take parameters (e.g.
> org-cycle-hook, etc) and I wasn't sure about the ones that didn't
> mention any.
>
Yes - it is (in the terminology of the Elisp Ref manual) an "abnormal"
hook and should not be called ``org-cycle-hook'', but the convention is not
enforced.
> I was just trying to find my way and didn't have a map of what was
> where. Even the org-export-blocks-preprocess() function is a little
> difficult to wade through for someone not really familiar with elisp.
> I think I have pieced it together, though. This may give me what I need
> to do what I want (remove some specific kinds of headers when creating
> certain LaTeX files).
>
> Are my assumptions above correct, then?
>
I think so.
Nick
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: Hook Function Examples
2010-01-25 6:21 ` Mark Elston
2010-01-25 15:48 ` Nick Dokos
@ 2010-01-28 18:22 ` Carsten Dominik
1 sibling, 0 replies; 5+ messages in thread
From: Carsten Dominik @ 2010-01-28 18:22 UTC (permalink / raw)
To: Mark Elston; +Cc: org-mode emacs-orgmode
On Jan 25, 2010, at 7:21 AM, Mark Elston wrote:
> On 1/24/2010 9:24 PM, Nick Dokos wrote:
>> Mark Elston<m_elston@comcast.net> wrote:
>>
>>> I am trying to make use of some of the hooks for exporting and
>>> haven't
>>> found any docs about what they take or how to make use of them
>>> (elisp
>>> is *not* my native language).
>>>
>>
>> The Emacs Lisp Reference manual has a section (23.1: Hooks) on hooks,
>> but I'm not sure how helpful it will be to you. The most important
>> note
>> is that "normal" hook variables are, by convention, named
>> <foo>-hook. "normal" means that the functions that are added to the
>> hook
>> take no arguments and return no useful values.
>>
>>> In particular, I am trying to figure out how to use the following
>>> to see if any of them are going to help me:
>>>
>>> org-export-preprocess-hook
>>> org-export-preprocess-after-tree-selection-hook
>>> org-export-preprocess-final-hook
>>>
>>> Any examples of a hook function for these would help a lot. In
>>> particular, what are the parameters, is the point "looking at"
>>> anything in particular, etc.
>>>
>>
>> Use the source, Luke! (erm... Mark!)
>>
>> C-h v org-export-preprocess-hook<RET>
>>
>> gives me:
>>
>> (org-export-blocks-preprocess)
>>
>
> Thanks, Nick. I had checked a few hooks (but not that one) and
> couldn't find any that had any functions assigned.
>
>> so we have here an example of a hook function!
>>
>> C-h f org-export-blocks-preprocess<RET>
>>
>> gives you the function's doc string, including a link to where it is
>> defined, and clicking on the link will take you to the function: no
>> params (it is a "normal" hook after all), and I think you can make no
>> assumptions about the context. In particular, the above function
>> wraps
>> everything in a save-excursion, goes to the beginning of the buffer
>> and
>> searches for interesting things, doing something on each interesting
>> thing it finds.
>
> OK. From what I read I am assuming that a buffer is created with some
> already-processed (though not completely) org data as its initial
> content. Then, at some point, these hook functions are called on this
> new buffer. I assume this is the case since you wouldn't want to go
> modifying the original buffer - though this is not stated anywhere
> that
> I can find.
That is correct, the "preprocess" hooks are called in a temporary
buffer,
they can be used to modify that buffer in any way you like without
affecting the original buffer.
>
> Some hook functions apparently *do* take parameters (e.g.
> org-cycle-hook, etc) and I wasn't sure about the ones that didn't
> mention any.
Yes, the only way to find out is to look at the docstring.
If that says nothing about arguments and return values, you can assume
the they do not expect arguments and do not return anything useful,
respectively.
>
> I was just trying to find my way and didn't have a map of what was
> where. Even the org-export-blocks-preprocess() function is a little
> difficult to wade through for someone not really familiar with elisp.
> I think I have pieced it together, though. This may give me what I
> need
> to do what I want (remove some specific kinds of headers when creating
> certain LaTeX files).
>
> Are my assumptions above correct, then?
>
> Mark
>
>
>
> _______________________________________________
> Emacs-orgmode mailing list
> Please use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
- Carsten
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2010-01-28 23:12 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2010-01-25 0:40 Hook Function Examples Mark Elston
2010-01-25 5:24 ` Nick Dokos
2010-01-25 6:21 ` Mark Elston
2010-01-25 15:48 ` Nick Dokos
2010-01-28 18:22 ` Carsten Dominik
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).