Merge remote-tracking branch 'hyperbole/master' into externals/hyperbolescratch/hyperbole-lexbind

1 files changed, 267 insertions, 17 deletions

diff --git a/HY-NEWS b/HY-NEWS
index 2c9ef33..3971309 100644
--- a/HY-NEWS
+++ b/HY-NEWS
@@ -2,14 +2,267 @@
 				 by Bob Weiner
 
 ===========================================================================
+*                                   V7.0.3b
+===========================================================================
+
+  BUTTONS
+
+    - Labeled Implicit Buttons: Optional <[labels]> that precede
+      implicit buttons.  This enables implicit buttons to be activated
+      by name when in the current buffer or anywhere when added to the
+      global buttons file (personal button file).
+
+    - Link to Buttons: New implicit button types that link to button categories:
+        In Buffer Syntax                                 Implicit Button Type
+        ===========================================================================
+        <elink: explicit button label to link to>        link-to-ebut
+        <glink: global button label to link to>          link-to-gbut
+        <ilink: implicit button label to link to>        link-to-iut
+
+    - Other new implicit button types:
+        debugger-source: Jump to the source of errors from the Python pytype package
+        ipython-stack-frame: Jump to the source of ipython stack traces and exceptions
+
+
+  DOCUMENTATION
+
+    - Action Types: link-to-gbut, link-to-ibut - Added.
+
+    - hpath:native-image-suffixes: documented this setting for
+      controlling image types that Hyperbole displays within Emacs.
+
+    - Implicit Button Types: Split off type descriptions to this new
+      subsection and added these types: ripgrep-msg, ipython-stack-frame, link-to-ibut,
+      link-to-gbut, link-to-ebut.
+
+    - Implicit Buttons: Added description and example of implicit button labels.
+      DEMO (Implicit Buttons): Added description and example of implicit button labels.
+
+    - Glossary: Updated Implicit Button and Global Button entries with changes.
+
+
+  KOUTLINER
+
+    - When 'c' (clip to lines per cell) is omitted from a viewspec, clipping now changes to
+      whatever the default number of lines per cell is (typically, unlimited).  The same goes
+      for the 'l' spec (limit display to a certain level of cells).
+
+  MENUS
+
+    - Pulldown Menus:   Implicit-Button/Label: Added to add a label.
+                        Implicit-Button/Rename - Added to rename the label of an implicit button.
+
+    - Minibuffer Menus: hui-mini.el (hui:menus): Added Ibut/Label and Ibut/Rename.
+
+
+  ORG MOde
+
+    - Radio Targets and Links: Smart Keys now handle these.
+
+    - Links: Smart Keys handle both internal and external Org mode links.
+
+  PROGRAMMING
+
+    - ibut:at-type-p: Added to test if point is on a specific type of implicit button.
+
+    - hypb:region-with-text-property-value: Added and used in hysy-org.el.
+
+    - hsys-org-mode-function, hsys-org-mode-p: Added to determine when hsys-org actions
+      are activated.
+
+    - ebut:key-src-set-buffer, hbut:key-src-set-buffer, hbut:key-list,
+      hbut:ebut-key-list, hbut:ibut-key-list, hbut:label-list): Added
+      to allow selection of labeled Hyperbole buttons in currrent buffer by name.
+
+    - gbut:get, hbut:map, ibut:label-map, ibut:key-src, ibut:key-to-label, ibut:label-to-key,
+      hui:ebut-act, ibut:summarize, ibut:label-start, ibut:label-end, ibut:label-p, ibut:get,
+      hui:ibut-label-create, hui:ibut-rename, hui:ibut-message, ibut:alist, ibut:list, ibut:map,
+      ibut:next-occurrence, ibut:label-regexp, gbut:ibut-key-list, ebut:to, gbut:to, ibut:to,
+      ibut:label-separator, hbut:label-regexp, ibut:rename, hbut:get: Added to support labeled
+      implicit buttons and links to buttons.
+      hbut:label-p: Updated to handle implicit button labels.
+      ibut:label-separator-regexp, hbut:outside-comment-p: Added.
+
+    - link-to-gbut, glink:start, glink:end: Added for in-buffer links to global buttons.
+      link-to-ebut, elink:start, elink:end: Added for in-buffer links to explicit buttons.
+      link-to-ibut, ilink:start, ilink:end: Added for in-buffer links to implicit buttons.
+
+    - hsys-org-set-ibut-label: Added and used in org-mode ibtype.
+      org-mode, hsys-org-at-block-start-p: Added Action Key activation of Org blocks when
+      on 1st line of def.
+
+
+  SMART (ACTION AND ASSIST) KEYS
+
+    - hpath:find-program: Changed to prioritize hpath:native-image-suffixes over
+      hpath:internal-display-alist over hpath:external-display-alist-macos instead of the
+      reverse.  This prevents external viewers from being used when internal viewers are
+      also in effect.
+
+
+===========================================================================
+*                                   V7.0.3
+===========================================================================
+
+  ACE WINDOW PACKAGE INTEGRATION - fast window and buffer switching
+
+    - Selected Window Buffer Replace: Added the ability to 'replace' the
+      selected window's buffer with the buffer of another window.  Use
+      {M-o r <window-id>}.  To swap the buffers between the same two windows,
+      use {M-o m <window-id>.  See "(hyperbole)Keyboard Drags" for setup and
+      use instructions.
+
+    - New Frame Commands: Any of these M-o commands that involve two windows
+      can use a new frame as the target window by using a <window-id> of 'z'.
+      So, {M-o t z} throws the current buffer to a new frame with a single
+      window displaying that buffer.  The new frame will be the same size as
+      the prior frame to match the behavior of HyControl.
+
+    - Integrated Ace Window commands with Smart Key Drags and added commands
+      for use with the mouse that select Ace Window source and target windows
+      by clicking with the mouse: hmouse-click-to-drag,
+      hmouse-click-to-drag-stay, hmouse-click-to-drag-to,
+      hmouse-click-to-replace, hmouse-click-to-swap, hmouse-click-to-throw.
+
+    - {M-o i <window-id>} is now for use only when on a listing item such as
+      in Dired or Buffer Menu.  It no longer creates Hyperbole buttons in
+      non-item areas to avoid confusion.  Now it will just trigger an error
+      if not on a listing item.
+
+  SMART (ACTION AND ASSIST) KEYS
+
+    - MSWindows Paths: Hyperbole now recognizes typical MSWindows paths (both
+      local and remote shares) and can convert an in-buffer path between POSIX
+      and MSWindows formats multiple times, even paths involving mount points.
+      See "DEMO#POSIX and MSWindows Paths".
+
+      MSWindows paths may be used within links and implicit path
+      buttons just like POSIX paths, whether running Emacs under a POSIX
+      system or MSWindows.  If under POSIX, a remote MSWindows path must be
+      accessed through a mount point to the network share.  Hyperbole caches
+      such mount points when it is loaded.  Use {M-x
+      hpath:cache-mswindows-mount-points RET} to update them if more mounts
+      are made later.  See also the NEW COMMANDS section herein for how to
+      convert a path between POSIX and MSWindows formats.
+
+    - GitLab and Github Links: Added Gitlab implicit links with equivalent
+      functionality to those of Github.  Added "people" reference support to
+      list people who are part of a formal organization as well as a "staff"
+      alias.  Added "contributors" reference support to list project
+      contributors as well.  Improved Github implicit issue links: gh#gh-34
+      and gh#issue/34 now properly reference an issue in the current project.
+
+    - Ripgrep: Added new ripgrep-msg implicit button type which jumps
+      to the source referenced by ripgrep (rg) output.  By default,
+      ripgrep outputs pathnames only once before all matching lines
+      within that path.  Ripgrep may also be used with the Hyperbole
+      `hypb:rgrep' command by setting 'hypb:rgrep-command'.  See
+      "https://github.com/BurntSushi/ripgrep".
+
+    - Markdown Mode: Smart Keys now support Markdown internal file link
+      references and navigation.
+
+    - Org Mode: When in an *Org Help* buffer, the Smart Keys now defer to
+      org-mode to handle jumps to its own locations for compatibility.
+      Similarly, in org-mode buffers when not on an org link or heading,
+      and the {M-RET} Action Key is pressed, Hyperbole defers to Org's
+      org-meta-return command.
+
+    - Drag-based Kill, Copy and Yank: Added support for dragging across
+      frames.
+
+    - Python Identifiers: If a Jedi server is running and the Action Key is
+      pressed on a Python identifier, Hyperbole will use Jedi to find the
+      definition even within nested module references, e.g. a.b.c.  Also
+      improved basic identifier definition finding.
+
+    - Company Mode Completion: Support for the Emacs company-mode completion
+      package.  An Action Key press on a company-mode completion item will
+      display the definition of that item and an Assist Key press will
+      display its documentation, if any.
+
+    - Treemacs Mode: Now supports standard Hyperbole end-of-line proportional
+      scrolling.
+
+    - ChangeLog Mode: Smart Keys now work on Emacs Lisp references in
+      changelogs.
+
+    - Improved String Matching: For lines that begin with part of a string
+      that started on another line, Hyperbole now presumes that point is
+      within a string rather than between two strings, even though the
+      delimiters on the line make this ambiguous.  This provides more
+      accurate string recognition.
+
+    - Improved Path Matching: For quote delimited paths, other quote marks
+      are excluded from matches, so if checking for a doubly quoted path,
+      single quotes are not allowed in the string.
+
+  HYCONTROL
+
+    - Help Buffer Quitting: If HyControl is active, normally {q} quits
+      it, but now if point is in an Emacs help buffer, {q} will quit
+      from the help buffer instead.  Use {Q} to quit from HyControl
+      unconditionally.
+
+  NEW COMMANDS
+
+    - Buffer Sliding:  Four new commands are available that can be
+      bound to things like control arrow keys: hkey-buffer-move-left,
+      hkey-buffer-move-right, hkey-buffer-move-down and
+      hkey-buffer-move-up.  Each one slides the current buffer one
+      window in the direction specified and all other buffers slide
+      around to match.
+
+    - MSWindows and POSIX Path Toggling: In "hpath.el", added
+      (hpath:substitute-posix-or-mswindows-at-point) and
+      (hpath:substitute-posix-or-mswindows) commands to toggle the
+      format of a path at point or in a string between POSIX and
+      MSWindows styles.
+
+  PROGRAMMING
+
+    - Added hypb:map-plist, equivalent to mapcar but maps over
+      key-value pairs in property lists (where the key and value are
+      individual elements in the list).
+
+    - In "hui-select.el", added functions to return info. on the
+      context-sensitive region that this library selects.
+      (hui-select-get-region) returns the region that would be
+      selected at point and (hui-select-get-region-boundaries)
+      returns a cons of the start and end position of the same region.
+
+    - In "hpath.el (hpath:delimited-possible-path), added optional
+      include-positions parameter which if non-nil, adds start and end
+      positions to returned value.
+
+    - In "hversion.el", added (hyperb:wsl-os-p) flag to test whether
+      Emacs is running under Microsoft Windows Subsystem for Linux (WSL)
+      since the system-type variable does not reflect this.
+
+  DOCUMENTATION
+
+    - Popup Menus: Documented how to invoke the Koutliner and
+      HyRolo popup menus in Emacs.  See "(hyperbole)Menu Commands".
+
+    - DEMO: Added sections:
+        "DEMO#Gitlab (Remote) References"
+        "DEMO#POSIX and MSWindows Paths"
+
+    - Updated Hyperbole Manual with new features.
+
+
+===========================================================================
 *                                   V7.0.2
 ===========================================================================
 
-    - Ace Window: Added the ability to 'throw' an item to a window while
-      leaving the selected window the same.  Use {M-o t <window-id>}.  This
-      works in Dired, Buffer Menu, iBuffer Menu and Treemacs modes and lets
-      you throw multiple items to multiple windows quickly.  See
-      "(hyperbole)Keyboard Drags" for setup and use instructions.
+  ACE WINDOW PACKAGE INTEGRATION
+
+    - Item Throws: Added the ability to 'throw' an item or a buffer to
+      a window while leaving the selected window the same.  Use {M-o t
+      <window-id>}.  This works in Dired, Buffer Menu, iBuffer Menu and
+      Treemacs modes and lets you throw multiple items to multiple windows
+      quickly.  See "(hyperbole)Keyboard Drags" for setup and use
+      instructions.
 
 ===========================================================================
 *                                   V7.0.1
@@ -149,7 +402,7 @@
       explicit buttons are highlighted with a special colored face or not.  By
       default, they are.
 
-    - Python PDB Backtraces: Action Key presses jump to the associated source
+    - Python Backtraces: Action Key presses jump to the associated source
       line.
 
     - Python Symbols: Action Key presses now look these up in any buffer whose
@@ -164,7 +417,7 @@
       source of any such lines.
 
     - Dired Quit: An Action Key press at the end of the first line in a Dired
-      buffer nows quit and execute requested actions, just as presses at the
+      buffer now quits and executes requested actions, just as presses at the
       end of the buffer do.
 
     - Image Thumbnail Browsing: See the Info manual section,
@@ -356,9 +609,6 @@
       new settings with {M-x hmouse-update-smart-keys RET}.  No need to reload
       or restart Hyperbole.
 
-    - Find Web: Added Find Web key binding entry to Hyperbole menus.  This key
-      displays the Hyperbole Web search menu.
-
     - Jump Thing: Added Jump Thing key binding entry to Hyperbole menus.  This
       key jumps between the start and end of a matching delimiter or tag pair.
 
@@ -736,7 +986,7 @@ are new in 2016 and you should look through them all.
       Implicit-Button menu.
 
     - On the Hyperbole Customize/Change-Key-Bindings menubar menu, renamed
-      these entries and added Mark-Think-Key.  Similar updates done to the
+      these entries and added Mark-Thing-Key.  Similar updates done to the
       minibuffer menu.
 
   MOUSE AND SMART KEY SUPPORT
@@ -755,7 +1005,7 @@ are new in 2016 and you should look through them all.
       help mode so you can page through it with SPC and DEL keys and then quit
       from it with {q}.
 
-    - A click of the Action Mouse Key within an inactive minibuffer menu
+    - A click of the Action Mouse Key within an inactive minibuffer window
       displays the Hyperbole minibuffer menu, allowing you to invoke menu
       entries with the mouse.  A click of the Assist Key in the same place
       displays the buffer, window and frame jump menu just as does a click
@@ -857,13 +1107,13 @@ are new in 2016 and you should look through them all.
     - Added missing {C-c C-i}/{C-c TAB} binding mentioned in the EXAMPLE.kotl
       file; sets cell attributes.
 
-    - {C=t} Transpose characters - Added error checks at the beginning of cells
+    - {C-t} Transpose characters - Added error checks at the beginning of cells
       and end of lines for times when there are not 2 chars to transpose.
 
   ROLO
   
     - Improved {M-s} interactive string searching for rolo match buffer strings.
-      Made {C-u M-s} to a regexp search for rolo match buffer strings.
+      Made {C-u M-s} do a regexp search for rolo match buffer strings.
 
     - Documented the {l} hyrolo-locate command in the Hyperbole manual.
 
@@ -1060,8 +1310,8 @@ are new in 2016 and you should look through them all.
 
   INSTALLATION
 
-    - Installation is greatly simplified.  A single emacs initialization line
-      of the form:  
+    - Hyperbole initialization is greatly simplified.  A single "~/.emacs"
+      line of the form:
 
         (require 'hyperbole (expand-file-name "hyperbole" "<HYPERBOLE-DIR>/")
 
@@ -1115,7 +1365,7 @@ are new in 2016 and you should look through them all.
       now begin with 'K'.  Some used to start with 'O'.  To edit the example
       Koutline, use {C-h h k e}.
 
-    - {C-c C-a}  - Show-all, expand all cells nihe current view.
+    - {C-c C-a}  - Show-all, expand all cells in the current view.
       {C-c C-o}  - Overview, show only first line of outline cells.
       {C-c C-t}  - Top-level, hide all cells below level 1 and show
                    only the first line of each level 1 cell.