gnu/dist/texinfo/info/session.h

   1 /*      $NetBSD$        */
   2
   3 /* session.h -- Functions found in session.c.
   4    Id: session.h,v 1.3 2004/04/11 17:56:46 karl Exp
   5
   6    Copyright (C) 1993, 1998, 1999, 2001, 2002, 2004 Free Software
   7    Foundation, Inc.
   8
   9    This program is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 2, or (at your option)
  12    any later version.
  13
  14    This program is distributed in the hope that it will be useful,
  15    but WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17    GNU General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public License
  20    along with this program; if not, write to the Free Software
  21    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  22
  23    Written by Brian Fox (bfox@ai.mit.edu). */
  24
  25 #ifndef SESSION_H
  26 #define SESSION_H
  27
  28 #include "info.h"
  29 #include "dribble.h"
  30
  31 /* All commands that can be invoked from within info_session () receive
  32    arguments in the same way.  This simple define declares the header
  33    of a function named NAME, with associated documentation DOC.  The
  34    documentation string is groveled out of the source files by the
  35    utility program `makedoc', which is also responsible for making
  36    the documentation/function-pointer maps. */
  37 #define DECLARE_INFO_COMMAND(name, doc) \
  38 void name (WINDOW *window, int count, unsigned char key)
  39
  40 /* Variables found in session.h. */
  41 extern VFunction *info_last_executed_command;
  42
  43 /* Variable controlling the garbage collection of files briefly visited
  44    during searches.  Such files are normally gc'ed, unless they were
  45    compressed to begin with.  If this variable is non-zero, it says
  46    to gc even those file buffer contents which had to be uncompressed. */
  47 extern int gc_compressed_files;
  48
  49 /* When non-zero, tiling takes place automatically when info_split_window
  50    is called. */
  51 extern int auto_tiling_p;
  52
  53 /* Variable controlling the behaviour of default scrolling when you are
  54    already at the bottom of a node. */
  55 extern int info_scroll_behaviour;
  56 extern char *info_scroll_choices[];
  57
  58 /* Values for info_scroll_behaviour. */
  59 #define IS_Continuous 0 /* Try to get first menu item, or failing that, the
  60                            "Next:" pointer, or failing that, the "Up:" and
  61                            "Next:" of the up. */
  62 #define IS_NextOnly   1 /* Try to get "Next:" menu item. */
  63 #define IS_PageOnly   2 /* Simply give up at the bottom of a node. */
  64
  65 /* Utility functions found in session.c */
  66 extern void info_dispatch_on_key (unsigned char key, Keymap map);
  67 extern unsigned char info_get_input_char (void);
  68 extern unsigned char info_get_another_input_char (void);
  69 extern unsigned char info_input_pending_p (void);
  70 extern void remember_window_and_node (WINDOW *window, NODE *node);
  71 extern void set_remembered_pagetop_and_point (WINDOW *window);
  72 extern void set_window_pagetop (WINDOW *window, int desired_top);
  73 extern void info_set_node_of_window (int remember, WINDOW *window,
  74     NODE *node);
  75 extern void initialize_keyseq (void);
  76 extern void add_char_to_keyseq (char character);
  77 extern void info_gather_typeahead (void);
  78 extern FILE_BUFFER *file_buffer_of_window (WINDOW *window);
  79 extern long info_search_in_node (char *string, NODE *node,
  80     long int start, WINDOW *window, int dir, int case_sensitive);
  81 extern long info_target_search_node (NODE *node, char *string,
  82     long int start);
  83 extern void info_select_reference (WINDOW *window, REFERENCE *entry);
  84 extern int info_any_buffered_input_p (void);
  85 extern void print_node (NODE *node);
  86 extern void dump_node_to_file (NODE *node, char *filename,
  87     int dump_subnodes);
  88 extern void dump_nodes_to_file (char *filename, char **nodenames,
  89     char *output_filename, int dump_subnodes);
  90 extern char *program_name_from_file_name (char *file_name);
  91
  92 /* Do the physical deletion of WINDOW, and forget this window and
  93    associated nodes. */
  94 extern void info_delete_window_internal (WINDOW *window);
  95
  96 /* Tell Info that input is coming from the file FILENAME. */
  97 extern void info_set_input_from_file (char *filename);
  98
  99 #define return_if_control_g(val) \
 100   do { \
 101     info_gather_typeahead (); \
 102     if (info_input_pending_p () == Control ('g')) \
 103       return (val); \
 104   } while (0)
 105
 106 /* The names of the functions that run an info session. */
 107
 108 /* Starting an info session. */
 109 extern void begin_multiple_window_info_session (char *filename,
 110     char **nodenames);
 111 extern void begin_info_session (NODE *initial_node);
 112 extern void begin_info_session_with_error (NODE *initial_node,
 113     char *format, void *arg1, void *arg2);
 114 extern void info_session (void);
 115 extern void initialize_info_session (NODE *node, int clear_screen);
 116 extern void info_read_and_dispatch (void);
 117 extern void info_intuit_options_node (WINDOW *window,
 118     NODE *initial_node, char *program);
 119
 120 /* Moving the point within a node. */
 121 extern void info_next_line (WINDOW *window, int count, unsigned char key);
 122 extern void info_prev_line (WINDOW *window, int count, unsigned char key);
 123 extern void info_end_of_line (WINDOW *window, int count, unsigned char key);
 124 extern void info_beginning_of_line (WINDOW *window, int count, unsigned char key);
 125 extern void info_forward_char (WINDOW *window, int count, unsigned char key);
 126 extern void info_backward_char (WINDOW *window, int count, unsigned char key);
 127 extern void info_forward_word (WINDOW *window, int count, unsigned char key);
 128 extern void info_backward_word (WINDOW *window, int count, unsigned char key);
 129 extern void info_beginning_of_node (WINDOW *window, int count, unsigned char key);
 130 extern void info_end_of_node (WINDOW *window, int count, unsigned char key);
 131 extern void info_move_to_prev_xref (WINDOW *window, int count, unsigned char key);
 132 extern void info_move_to_next_xref (WINDOW *window, int count, unsigned char key);
 133
 134 /* Scrolling text within a window. */
 135 extern void info_scroll_forward (WINDOW *window, int count, unsigned char key);
 136 extern void info_scroll_backward (WINDOW *window, int count, unsigned char key);
 137 extern void info_redraw_display (WINDOW *window, int count, unsigned char key);
 138 extern void info_toggle_wrap (WINDOW *window, int count, unsigned char key);
 139 extern void info_move_to_window_line (WINDOW *window, int count,
 140     unsigned char key);
 141 extern void info_up_line (WINDOW *window, int count, unsigned char key);
 142 extern void info_down_line (WINDOW *window, int count, unsigned char key);
 143 extern void info_scroll_half_screen_down (WINDOW *window, int count,
 144     unsigned char key);
 145 extern void info_scroll_half_screen_up (WINDOW *window, int count,
 146     unsigned char key);
 147 extern void info_scroll_forward_set_window (WINDOW *window, int count,
 148     unsigned char key);
 149 extern void info_scroll_forward_page_only (WINDOW *window, int count,
 150     unsigned char key);
 151 extern void info_scroll_forward_page_only_set_window (WINDOW *window, int count,
 152     unsigned char key);
 153 extern void info_scroll_backward_set_window (WINDOW *window, int count,
 154     unsigned char key);
 155 extern void info_scroll_backward_page_only (WINDOW *window, int count,
 156     unsigned char key);
 157 extern void info_scroll_backward_page_only_set_window (WINDOW *window, int count,
 158     unsigned char key);
 159 extern void info_scroll_other_window_backward (WINDOW *window, int count,
 160     unsigned char key);
 161
 162 /* Manipulating multiple windows. */
 163 extern void info_split_window (WINDOW *window, int count, unsigned char key);
 164 extern void info_delete_window (WINDOW *window, int count, unsigned char key);
 165 extern void info_keep_one_window (WINDOW *window, int count, unsigned char key);
 166 extern void info_grow_window (WINDOW *window, int count, unsigned char key);
 167 extern void info_scroll_other_window (WINDOW *window, int count,
 168     unsigned char key);
 169 extern void info_tile_windows (WINDOW *window, int count, unsigned char key);
 170 extern void info_next_window (WINDOW *window, int count, unsigned char key);
 171 extern void info_prev_window (WINDOW *window, int count, unsigned char key);
 172
 173 /* Selecting nodes. */
 174 extern void info_next_node (WINDOW *window, int count, unsigned char key);
 175 extern void info_prev_node (WINDOW *window, int count, unsigned char key);
 176 extern void info_up_node (WINDOW *window, int count, unsigned char key);
 177 extern void info_last_node (WINDOW *window, int count, unsigned char key);
 178 extern void info_first_node (WINDOW *window, int count, unsigned char key);
 179 extern void info_history_node (WINDOW *window, int count, unsigned char key);
 180 extern void info_goto_node (WINDOW *window, int count, unsigned char key);
 181 extern void info_goto_invocation_node (WINDOW *window, int count,
 182     unsigned char key);
 183 extern void info_top_node (WINDOW *window, int count, unsigned char key);
 184 extern void info_dir_node (WINDOW *window, int count, unsigned char key);
 185 extern void info_global_next_node (WINDOW *window, int count, unsigned char key);
 186 extern void info_global_prev_node (WINDOW *window, int count, unsigned char key);
 187 extern void info_kill_node (WINDOW *window, int count, unsigned char key);
 188 extern void info_view_file (WINDOW *window, int count, unsigned char key);
 189 extern void info_menu_sequence (WINDOW *window, int count, unsigned char key);
 190 extern NODE *info_follow_menus (NODE *initial_node, char **menus,
 191     const char **errstr, char **errarg1, char **errarg2);
 192 extern void info_man (WINDOW *window, int count, unsigned char key);
 193 extern void list_visited_nodes (WINDOW *window, int count, unsigned char key);
 194 extern void select_visited_node (WINDOW *window, int count, unsigned char key);
 195
 196 /* Selecting cross references. */
 197 extern void info_menu_digit (WINDOW *window, int count, unsigned char key);
 198 extern void info_menu_item (WINDOW *window, int count, unsigned char key);
 199 extern void info_xref_item (WINDOW *window, int count, unsigned char key);
 200 extern void info_find_menu (WINDOW *window, int count, unsigned char key);
 201 extern void info_select_reference_this_line (WINDOW *window, int count,
 202     unsigned char key);
 203 extern void info_last_menu_item (WINDOW *window, int count, unsigned char key);
 204 extern void info_visit_menu (WINDOW *window, int count, unsigned char key);
 205
 206 /* Hacking numeric arguments. */
 207 extern int info_explicit_arg, info_numeric_arg, info_numeric_arg_sign;
 208
 209 extern void info_add_digit_to_numeric_arg (WINDOW *window, int count,
 210     unsigned char key);
 211 extern void info_universal_argument (WINDOW *window, int count,
 212     unsigned char key);
 213 extern void info_initialize_numeric_arg (void);
 214 extern void info_numeric_arg_digit_loop (WINDOW *window, int count,
 215     unsigned char key);
 216
 217 /* Searching commands. */
 218 extern void info_search (WINDOW *window, int count, unsigned char key);
 219 extern void isearch_forward (WINDOW *window, int count, unsigned char key);
 220 extern void isearch_backward (WINDOW *window, int count, unsigned char key);
 221 extern void info_search_case_sensitively (WINDOW *window, int count,
 222     unsigned char key);
 223 extern void info_search_backward (WINDOW *window, int count, unsigned char key);
 224 extern void info_search_next (WINDOW *window, int count, unsigned char key);
 225 extern void info_search_previous (WINDOW *window, int count, unsigned char key);
 226
 227 /* Dumping and printing nodes. */
 228 extern void info_print_node (WINDOW *window, int count, unsigned char key);
 229
 230 /* Footnotes.  */
 231 extern void info_show_footnotes (WINDOW *window, int count, unsigned char key);
 232
 233 /* Miscellaneous commands. */
 234 extern void info_abort_key (WINDOW *window, int count, unsigned char key);
 235 extern void info_quit (WINDOW *window, int count, unsigned char key);
 236 extern void info_do_lowercase_version (WINDOW *window, int count,
 237     unsigned char key);
 238
 239 #endif /* not SESSION_H */