emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Thorsten Jolitz <tjolitz@gmail.com>
To: emacs-orgmode@gnu.org
Subject: Re: Directly search for Headlines?
Date: Mon, 07 Jul 2014 19:54:28 +0200	[thread overview]
Message-ID: <877g3pgiln.fsf@gmail.com> (raw)
In-Reply-To: m2a98lb1lz.fsf@gmail.com

Ken Mankoff <mankoff@gmail.com> writes:

> On 2014-07-07 at 11:19, Nick Dokos wrote:
>> John Durden <johndurden@yandex.com> writes:
>>
>>> Can you search directly for headlines in all agenda-files, with the
>>> name of the headline, not tags? If so, how? If not, wouldn't this be
>>> useful?
>>>
>>
>> Try `s' in the agenda perhaps?
>
> Yes this feature would be useful. 
>
> "s" in agenda just saves all Org Buffers for me.

for me too

> My work-around is to search for "* Foo", but this doesn't find headlines
> with TODO items.

Internally, the necessary functionality already exists:

,----[ C-h f org-map-entries RET ]
| org-map-entries is a compiled Lisp function in `org.el'.
| 
| (org-map-entries FUNC &optional MATCH SCOPE &rest SKIP)
| 
| Call FUNC at each headline selected by MATCH in SCOPE.
| 
| [...] 
| MATCH is a tags/property/todo match as it is used in the agenda tags view.
| Only headlines that are matched by this query will be considered during
| the iteration.  When MATCH is nil or t, all headlines will be
| visited by the iteration.
| 
| SCOPE determines the scope of this command.  It can be any of:
| 
| nil     The current buffer, respecting the restriction if any
| tree    The subtree started with the entry at point
| region  The entries within the active region, if any
| region-start-level
|         The entries within the active region, but only those at
|         the same level than the first one.
| file    The current buffer, without restriction
| file-with-archives
|         The current buffer, and any archives associated with it
| agenda  All agenda files
| agenda-with-archives
|         All agenda files with any archive files associated with them
| (file1 file2 ...)
|         If this is a list, all files in the list will be scanned [...]
`----

or

,----[ C-h f org-element-map RET ]
| org-element-map is a compiled Lisp function in `org-element.el'.
| 
| (org-element-map DATA TYPES FUN &optional INFO FIRST-MATCH
| NO-RECURSION WITH-AFFILIATED)
| 
| Map a function on selected elements or objects.
| 
| DATA is a parse tree, an element, an object, a string, or a list
| of such constructs.  TYPES is a symbol or list of symbols of
| elements or objects types (see `org-element-all-elements' and
| `org-element-all-objects' for a complete list of types).  FUN is
| the function called on the matching element or object.  It has to
| accept one argument: the element or object itself.
| [...]
`----

One could either use something like this

#+begin_src emacs-lisp
  (defun tj/match-true-headlines-1 ()
    (interactive)
    (org-element-map
        (org-element-parse-buffer 'headline) 'headline
      (lambda (--entry)
        (let ((true-headline (org-element-property :title --entry)))
          (when (string-match "world" true-headline)
            true-headline)))))
#+end_src

#+results:
: tj/match-true-headlines-1

or like this

#+begin_src emacs-lisp
  (defun tj/match-true-headlines-2 ()
    (interactive)
    (org-map-entries
     (lambda ()
       (when (looking-at org-complex-heading-regexp)
         (let ((true-headline (match-string 4)))
           (when (string-match "world" true-headline)
             (org-no-properties true-headline)))))))
#+end_src

#+results:
: tj/match-true-headlines-2

Lets try some test headlines after evaluating the above src_blocks.

* Hello world
** What a wonderful world
** Nice work if you can get it
*** Don't get around much anymore
*** World music

#+begin_src emacs-lisp :results table
(tj/match-true-headlines-1)
#+end_src

#+results:
| Hello world | What a wonderful world | World music |


#+begin_src emacs-lisp :results table
  (delq nil (tj/match-true-headlines-2))
#+end_src

#+results:
| Hello world | What a wonderful world | World music |

So both versions match the correct headlines in this
*outorg-edit-buffer* (where I write my message-mode email in full
org-mode). 

I don't know if this can be done with existing Org Agenda
functionality (as always, its quite likely...)

If not, to be useful this should be integrated in the Org Agenda
framework. 

-- 
cheers,
Thorsten

  reply	other threads:[~2014-07-07 17:54 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2014-07-07 14:06 Directly search for Headlines? John Durden
2014-07-07 15:19 ` Nick Dokos
2014-07-07 15:59   ` Ken Mankoff
2014-07-07 17:54     ` Thorsten Jolitz [this message]
2014-07-07 19:11     ` Nick Dokos
2014-07-07 19:58       ` Ken Mankoff
2014-07-07 21:24         ` Nick Dokos
2014-07-08 21:01     ` Samuel Wales
2014-07-08 21:31       ` Ken Mankoff
2014-07-28 17:56         ` Fabrice Niessen

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=877g3pgiln.fsf@gmail.com \
    --to=tjolitz@gmail.com \
    --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).