File: org-mouse.el.html

Org-mouse provides mouse support for org-mode.

https://orgmode.org

Org mouse implements the following features:
* following links with the left mouse button
* subtree expansion/collapse (org-cycle) with the left mouse button
* several context menus on the right mouse button:
   + general text
   + headlines
   + timestamps
   + priorities
   + links
   + tags
* promoting/demoting/moving subtrees with mouse-3
   + if the drag starts and ends in the same line then promote/demote
   + otherwise move the subtree

Use
---

To use this package, put the following line in your .emacs:

   (require 'org-mouse)


FIXME:
+ deal with folding / unfolding issues

TODO (This list is only theoretical, if you'd like to have some feature implemented or a bug fix please send me an email, even if something similar appears in the list below. This will help me get the priorities right.):

+ org-store-link, insert link
+ org tables
+ occur with the current word/tag (same menu item)
+ ctrl-c ctrl-c, for example, renumber the current list
+ internal links

Please email the maintainer with new feature suggestions / bugs

History:

Since version 5.10: Changes are listed in the general Org docs.

Version 5.09;; + Version number synchronization with Org mode.

Version 0.25
+ made compatible with Org 4.70 (thanks to Carsten for the patch)

Version 0.24
+ minor changes to the table menu

Version 0.23
+ preliminary support for tables and calculation marks
+ context menu support for org-agenda-undo & org-sort-entries

Version 0.22
+ handles undo support for the agenda buffer (requires Org >=4.58)

Version 0.21
+ selected text activates its context menu
+ shift-middleclick or right-drag inserts the text from the clipboard in the form of a link

Version 0.20
+ the new "TODO Status" submenu replaces the "Cycle TODO" menu item
+ the TODO menu can now list occurrences of a specific TODO keyword
+ #+STARTUP line is now recognized

Version 0.19
+ added support for dragging URLs to the org-buffer

Version 0.18
+ added support for agenda blocks

Version 0.17
+ toggle checkboxes with a single click

Version 0.16
+ added support for checkboxes

Version 0.15
+ Org now works with the Agenda buffer as well

Version 0.14
+ added a menu option that converts plain list items to outline items

Version 0.13
+ "Insert Heading" now inserts a sibling heading if the point is
  on "***" and a child heading otherwise

Version 0.12
+ compatible with Emacs 21
+ custom agenda commands added to the main menu
+ moving trees should now work between windows in the same frame

Version 0.11
+ fixed org-mouse-at-link (thanks to Carsten)
+ removed [follow-link] bindings

Version 0.10
+ added a menu option to remove highlights
+ compatible with Org 4.21 now

Version 0.08:
+ trees can be moved/promoted/demoted by dragging with the right
  mouse button (mouse-3)
+ small changes in the above function

Versions 0.01 -- 0.07: (I don't remember)

Defined variables (7)

org-mouse-context-menu-functionFunction to create the context menu.
org-mouse-directInternal variable indicating whether the current action is direct.
org-mouse-featuresThe features of org-mouse that should be activated.
org-mouse-main-bufferActive buffer for mouse operations.
org-mouse-plain-list-regexpRegular expression that matches a plain list.
org-mouse-priority-regexpRegular expression matching the priority indicator.
org-mouse-punctuationPunctuation used when inserting text by drag and drop.

Defined functions (42)

org--mouse-dnd-insert-text(ORIG-FUN WINDOW ACTION TEXT &rest ARGS)
org--mouse-dnd-open-file(ORIG-FUN URI &rest ARGS)
org--mouse-open-at-point(ORIG-FUN &rest ARGS)
org-mouse-agenda-context-menu(&optional EVENT)
org-mouse-agenda-type(TYPE)
org-mouse-bolp()
org-mouse-clip-text(TEXT MAXLENGTH)
org-mouse-context-menu(&optional EVENT)
org-mouse-delete-timestamp()
org-mouse-do-remotely(COMMAND)
org-mouse-down-mouse(EVENT)
org-mouse-empty-line()
org-mouse-end-headline()
org-mouse-for-each-item(FUNCT)
org-mouse-get-context(CONTEXTLIST CONTEXT)
org-mouse-get-gesture(EVENT)
org-mouse-get-priority(&optional DEFAULT)
org-mouse-in-region-p(POS)
org-mouse-insert-heading()
org-mouse-insert-item(TEXT)
org-mouse-keyword-menu(KEYWORDS FUNCTION &optional SELECTED ITEMFORMAT)
org-mouse-keyword-replace-menu(KEYWORDS &optional GROUP ITEMFORMAT NOSURROUND)
org-mouse-line-position()
org-mouse-list-options-menu(ALLOPTIONS &optional FUNCTION)
org-mouse-looking-at(REGEXP SKIPCHARS &optional MOVECHARS)
org-mouse-make-marker(POSITION)
org-mouse-match-closure(FUNCTION)
org-mouse-move-tree(EVENT)
org-mouse-move-tree-start(EVENT)
org-mouse-next-heading()
org-mouse-re-search-line(REGEXP)
org-mouse-remove-match-and-spaces()
org-mouse-replace-match-and-surround(NEWTEXT &optional FIXEDCASE LITERAL STRING SUBEXP)
org-mouse-set-priority(PRIORITY)
org-mouse-set-tags(TAGS)
org-mouse-show-context-menu(EVENT PREFIX)
org-mouse-show-headlines()
org-mouse-show-overview()
org-mouse-tag-menu()
org-mouse-timestamp-today(&optional SHIFT UNITS)
org-mouse-todo-menu(STATE)
org-mouse-yank-link(CLICK)

Defined faces (0)