enhanced-hooks-docs.patch

   1 ---
   2
   3  doc/help.etx |   53 +++++++++++++++++++++++++++++++++++------------------
   4  1 files changed, 35 insertions(+), 18 deletions(-)
   5
   6 diff --quilt old/doc/help.etx new/doc/help.etx
   7 --- old/doc/help.etx
   8 +++ new/doc/help.etx
   9 @@ -2751,15 +2751,15 @@ Macro Subroutines
  10
  11  **replace_in_string( string, search_for, replace_with [, type, "copy"] )**
  12    Replaces all occurrences of a search string in a string with a replacement
  13    string. Arguments are 1: string to search in, 2: string to search for, 3:
  14    replacement string.  There are two optional arguments.  One is a search type,
  15 -  either "literal", "case", "word", "caseWord", "regex", or "regexNoCase".
  16 -  The default search type is "literal".  If the optional "copy" argument is
  17 -  specified, a copy of the input string is returned when no replacements were
  18 -  performed.  By default an empty string ("") will be returned in this case.
  19 -  Returns a new string with all of the replacements done.
  20 +  either "literal", "case", "word", "caseWord", "regex", "regexNoCase", or
  21 +  "regexSmartCase". The default search type is "literal".  If the optional
  22 +  "copy" argument is specified, a copy of the input string is returned when no
  23 +  replacements were performed.  By default an empty string ("") will be returned
  24 +  in this case. Returns a new string with all of the replacements done.
  25
  26  **replace_range( start, end, string )**
  27    Replaces all the text between two positions in the current window. If the
  28    cursor position is between start and end it will be set to start.
  29
  30 @@ -2777,23 +2777,24 @@ Macro Subroutines
  31    Searches silently in a window without dialogs, beeps, or changes to the
  32    selection. Arguments are: 1: string to search for, 2: starting position.
  33    Optional arguments may include the strings: "wrap" to make the search wrap
  34    around the beginning or end of the string, "backward" or "forward" to change
  35    the search direction ("forward" is the default), "literal", "case", "word",
  36 -  "caseWord", "regex", or "regexNoCase" to change the search  type  (default is
  37 -  "literal"). Returns the starting position of the  match, or -1 if nothing
  38 -  matched. Also returns the ending position  of the match in $search_end.
  39 +  "caseWord", "regex", "regexNoCase", or "regexSmartCase" to change the search
  40 +  type  (default is "literal"). Returns the starting position of the  match, or
  41 +  -1 if nothing matched. Also returns the ending position  of the match in
  42 +  $search_end.
  43
  44  **search_string( string, search_for, start [, search_type, direction] )**
  45    Built-in macro subroutine for searching a string. Arguments are 1: string to
  46    search in, 2: string to search for, 3: starting position. Optional arguments
  47    may include the strings: "wrap" to make the search wrap around the beginning
  48    or end of the string, "backward" or "forward" to change the search direction
  49    ("forward" is the default), "literal", "case", "word", "caseWord", "regex",
  50 -  or "regexNoCase" to change the search type (default is "literal"). Returns
  51 -  the starting position of the match, or -1 if nothing matched. Also returns
  52 -  the ending position of the match in $search_end.
  53 +  "regexNoCase", or "regexSmartCase" to change the search type (default is
  54 +  "literal"). Returns the starting position of the match, or -1 if nothing
  55 +  matched. Also returns the ending position of the match in $search_end.
  56
  57  **select( start, end )**
  58    Selects (with the primary selection) text in the current buffer between a
  59    starting and ending position.
  60
  61 @@ -3342,11 +3343,12 @@ Action Routines
  62
  63      ~search-direction~
  64                     Either "forward" or "backward".
  65
  66      ~search-type~    Either "literal", "case", "word",
  67 -                   "caseWord", "regex", or "regexNoCase".
  68 +                   "caseWord", "regex", "regexNoCase",
  69 +                   or "regexSmartCase".
  70
  71      ~search-wrap~    Either "wrap" or "nowrap".
  72
  73      ~shell-menu-item-name~
  74                     Name of the command exactly as specified in
  75 @@ -3775,16 +3777,31 @@ Hooks
  76    simply skipped.
  77
  78  **file_open_hook()**
  79    Called when an existing file is opened.
  80
  81 -..**file_name_hook(filename)**
  82 -..  Called before NEdit opens a file using a certain name. The parameter is
  83 -..  the filename NEdit intends to open.
  84 -..
  85 -..  Return a string to use instead of the original filename. Return 0 to tell
  86 -..  NEdit to use the original filename.
  87 +**file_name_hook(~filename~)**
  88 +  Called before NEdit opens a file using a certain name. The parameter is
  89 +  the filename NEdit intends to open.
  90 +
  91 +  Return a string to use instead of the original filename. Return 0 to tell
  92 +  NEdit to use the original filename.
  93 +
  94 +**post_save_hook()**
  95 +  Called after an file was saved.
  96 +
  97 +**cursor_moved_hook()**
  98 +  Called when the was cursor moved.
  99 +
 100 +**modified_hook()**
 101 +  Called when the text buffer changed.
 102 +
 103 +**focus_hook()**
 104 +  Called when a document gets the input focus.
 105 +
 106 +**losing_focus_hook()**
 107 +  Called before a document lost the input focus.
 108
 109     ----------------------------------------------------------------------
 110
 111  Customizing
 112  ===========