[elpa] externals/hyperbole 8a29158612 03/10: hywiki.el (hywiki-find-page): Prompt when creating first HyWiki page

[ELPA Syncer]

branch: externals/hyperbole
commit 8a291586124550bd84e7be8b005d604f528a4ccd
Author: bw <rsw@gnu.org>
Commit: bw <rsw@gnu.org>

    hywiki.el (hywiki-find-page): Prompt when creating first HyWiki page
    
    This prevents the  user from being surprised by this Action Key behavior.
    
    * man/hyperbole.texi (Manual Overview): Add links for HyWiki and HyNote.
---
 ChangeLog          |  5 +++++
 hywiki.el          | 15 ++++++++-------
 man/hyperbole.texi | 32 ++++++++++++++++++++++++--------
 3 files changed, 37 insertions(+), 15 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index fe9ff62df7..7aa55dfc98 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
 2024-09-21  Bob Weiner  <rsw@gnu.org>
 
+* hywiki.el (hywiki-find-page): Prompt when creating the first HyWiki page
+    so user is not surprised by this Action Key behavior.
+
+* man/hyperbole.texi (Manual Overview): Add links for HyWiki and HyNote.
+
 * hywiki.el (hywiki-maybe-highlight-balanced-pairs): Separate balanced
     pair delimited expression highlighting into this function to allow
     for more general handling.  Expand range from one line to two.
diff --git a/hywiki.el b/hywiki.el
index 6567b83380..3a62c5c535 100644
--- a/hywiki.el
+++ b/hywiki.el
@@ -3,7 +3,7 @@
 ;; Author:       Bob Weiner
 ;;
 ;; Orig-Date:    21-Apr-24 at 22:41:13
-;; Last-Mod:     21-Sep-24 at 16:39:32 by Bob Weiner
+;; Last-Mod:     21-Sep-24 at 18:36:13 by Bob Weiner
 ;;
 ;; SPDX-License-Identifier: GPL-3.0-or-later
 ;;
@@ -521,10 +521,11 @@ failed or if displaying a regular file (read in via a 
`find-file'
 call).
 
 By default, create any non-existent page.  With optional
-PROMPT-FLAG t, prompt to create if non-existent.  If PROMPT-FLAG
-is :existing or with a prefix argument when called interactively,
-return nil unless the page already exists.  After successfully
-finding a page and reading it into a buffer, run
+PROMPT-FLAG t or if this is the first HyWiki page in
+`hywiki-directory', prompt to create if non-existent.  If
+PROMPT-FLAG is :existing or with a prefix argument when called
+interactively, return nil unless the page already exists.  After
+successfully finding a page and reading it into a buffer, run
 `hywiki-find-page-hook'."
   (interactive (list (if current-prefix-arg
                         (hywiki-read-page-name "Find existing HyWiki page: ")
@@ -548,9 +549,9 @@ finding a page and reading it into a buffer, run
                                (substring page-name 0 (match-beginning 0))
                              page-name))
                 (page-file (or (hywiki-get-page page-name)
-                               (if prompt-flag
+                               (if (or prompt-flag (null 
(hywiki-get-page-list)))
                                    (unless (eq prompt-flag :existing)
-                                     (when (y-or-n-p (concat "Create new `" 
page-name "' page? "))
+                                     (when (y-or-n-p (concat "Create new 
HyWiki page `" page-name "'? "))
                                        (hywiki-add-page page-name)))
                                  (hywiki-add-page page-name)))))
            (when page-file
diff --git a/man/hyperbole.texi b/man/hyperbole.texi
index bd89d6c6d7..e6c3baba70 100644
--- a/man/hyperbole.texi
+++ b/man/hyperbole.texi
@@ -7,7 +7,7 @@
 @c Author:       Bob Weiner
 @c
 @c Orig-Date:     6-Nov-91 at 11:18:03
-@c Last-Mod:     10-Sep-24 at 20:49:39 by Bob Weiner
+@c Last-Mod:     21-Sep-24 at 18:10:46 by Bob Weiner
 
 @c %**start of header (This is for running Texinfo on a region.)
 @setfilename hyperbole.info
@@ -159,7 +159,7 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</P>
 
 <PRE>
 Edition 9.0.2pre
-Printed September 1, 2024.
+Printed September 21, 2024.
 
   Published by the Free Software Foundation, Inc.
   Author:    Bob Weiner
@@ -201,7 +201,7 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 
 @example
 Edition 9.0.2pre
-September 1, 2024
+September 21, 2024
 
   Published by the Free Software Foundation, Inc.
   Author:    Bob Weiner
@@ -589,7 +589,7 @@ Hyperbole allows hypertext buttons to be embedded within 
unstructured and
 structured files, mail messages and news articles.  It offers intuitive
 keyboard and mouse-based control of information display within multiple
 windows.  It also provides point-and-click access to Info manuals, ftp
-archives, and the World-Wide Web.
+archives, the World-Wide Web and much more.
 
 @cindex file, FAST-DEMO
 @cindex Hyperbole demo
@@ -632,17 +632,33 @@ provides a number of overlapping interaction methods that 
support differing
 work styles.  In such instances, you need learn only one technique that suits
 you.
 
-@xref{Buttons}, for an overview of Hyperbole buttons and how to use them.
+@xref{Buttons}, for an overview of Hyperbole buttons and how to use
+them.  Hyperbole's action-oriented button support is enabled via the
+global minor mode, @code{hyperbole-mode).
+
 
 @xref{Menus}, for summaries of Hyperbole menu commands and how to use
 the minibuffer-based menus that work on any display that Emacs supports.
 
+@xref{HyWiki}, for Hyperbole's markup-free, personal Wiki system for
+note-taking and automatic WikiWord highlighting and hyperlinking.  It
+extends Org mode.  HyWikiWord hyperlink buttons are automatically
+enabled for wiki pages below @code{hywiki-directory}.  To enable them
+in text buffers outside of this directory, enable the global minor
+mode, @code{hywiki-mode}.
+
+@xref{HyNote}, for a start on the very early stages of Hyperbole's
+multi-format note taking system.  HyNote supports Org, Markdown,
+Koutline and Emacs Outline file formats.  HyNote works in any buffer
+where HyWiki support is active.
+
 @xref{HyControl}, for how to quickly and interactively control what your
 Emacs windows and frames display and where they appear.
 
 @xref{Koutliner}, for concept and usage information on the
-autonumbered, hypertextual outliner.  @xref{Koutliner Keys}, for a full
-summary of the outliner commands that are bound to keys.
+autonumbered, hypertextual outliner.  It uses its own major mode.
+@xref{Koutliner Keys}, for a full summary of the outliner commands
+that are bound to keys.
 
 @xref{HyRolo}, for concept and usage information on the rapid lookup,
 hierarchical, full-text record management system included with Hyperbole.
@@ -4668,7 +4684,7 @@ implicit button type that HyNote defines, 
@code{hynote-file}.
 In the future, HyNote will also provide a universal way to easily link to
 information across many file formats.
 
-See also @ref{HyWiki}.
+For more, @ref{HyWiki}.
 
 
 @node HyControl, Koutliner, HyNote, Top