Annotation of embedaddon/readline/rlprivate.h, revision 1.1
1.1 ! misho 1: /* rlprivate.h -- functions and variables global to the readline library,
! 2: but not intended for use by applications. */
! 3:
! 4: /* Copyright (C) 1999-2012 Free Software Foundation, Inc.
! 5:
! 6: This file is part of the GNU Readline Library (Readline), a library
! 7: for reading lines of text with interactive input and history editing.
! 8:
! 9: Readline 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 3 of the License, or
! 12: (at your option) any later version.
! 13:
! 14: Readline 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 Readline. If not, see <http://www.gnu.org/licenses/>.
! 21: */
! 22:
! 23: #if !defined (_RL_PRIVATE_H_)
! 24: #define _RL_PRIVATE_H_
! 25:
! 26: #include "rlconf.h" /* for VISIBLE_STATS */
! 27: #include "rlstdc.h"
! 28: #include "posixjmp.h" /* defines procenv_t */
! 29:
! 30: /*************************************************************************
! 31: * *
! 32: * Convenience definitions *
! 33: * *
! 34: *************************************************************************/
! 35:
! 36: #define EMACS_MODE() (rl_editing_mode == emacs_mode)
! 37: #define VI_COMMAND_MODE() (rl_editing_mode == vi_mode && _rl_keymap == vi_movement_keymap)
! 38: #define VI_INSERT_MODE() (rl_editing_mode == vi_mode && _rl_keymap == vi_insertion_keymap)
! 39:
! 40: #define RL_CHECK_SIGNALS() \
! 41: do { \
! 42: if (_rl_caught_signal) _rl_signal_handler (_rl_caught_signal); \
! 43: } while (0)
! 44:
! 45: #define RL_SIG_RECEIVED() (_rl_caught_signal != 0)
! 46: #define RL_SIGINT_RECEIVED() (_rl_caught_signal == SIGINT)
! 47:
! 48: #define CUSTOM_REDISPLAY_FUNC() (rl_redisplay_function != rl_redisplay)
! 49: #define CUSTOM_INPUT_FUNC() (rl_getc_function != rl_getc)
! 50:
! 51: /*************************************************************************
! 52: * *
! 53: * Global structs undocumented in texinfo manual and not in readline.h *
! 54: * *
! 55: *************************************************************************/
! 56: /* search types */
! 57: #define RL_SEARCH_ISEARCH 0x01 /* incremental search */
! 58: #define RL_SEARCH_NSEARCH 0x02 /* non-incremental search */
! 59: #define RL_SEARCH_CSEARCH 0x04 /* intra-line char search */
! 60:
! 61: /* search flags */
! 62: #define SF_REVERSE 0x01
! 63: #define SF_FOUND 0x02
! 64: #define SF_FAILED 0x04
! 65: #define SF_CHGKMAP 0x08
! 66:
! 67: typedef struct __rl_search_context
! 68: {
! 69: int type;
! 70: int sflags;
! 71:
! 72: char *search_string;
! 73: int search_string_index;
! 74: int search_string_size;
! 75:
! 76: char **lines;
! 77: char *allocated_line;
! 78: int hlen;
! 79: int hindex;
! 80:
! 81: int save_point;
! 82: int save_mark;
! 83: int save_line;
! 84: int last_found_line;
! 85: char *prev_line_found;
! 86:
! 87: UNDO_LIST *save_undo_list;
! 88:
! 89: Keymap keymap; /* used when dispatching commands in search string */
! 90: Keymap okeymap; /* original keymap */
! 91:
! 92: int history_pos;
! 93: int direction;
! 94:
! 95: int prevc;
! 96: int lastc;
! 97: #if defined (HANDLE_MULTIBYTE)
! 98: char mb[MB_LEN_MAX];
! 99: char pmb[MB_LEN_MAX];
! 100: #endif
! 101:
! 102: char *sline;
! 103: int sline_len;
! 104: int sline_index;
! 105:
! 106: char *search_terminators;
! 107: } _rl_search_cxt;
! 108:
! 109: /* Callback data for reading numeric arguments */
! 110: #define NUM_SAWMINUS 0x01
! 111: #define NUM_SAWDIGITS 0x02
! 112: #define NUM_READONE 0x04
! 113:
! 114: typedef int _rl_arg_cxt;
! 115:
! 116: /* A context for reading key sequences longer than a single character when
! 117: using the callback interface. */
! 118: #define KSEQ_DISPATCHED 0x01
! 119: #define KSEQ_SUBSEQ 0x02
! 120: #define KSEQ_RECURSIVE 0x04
! 121:
! 122: typedef struct __rl_keyseq_context
! 123: {
! 124: int flags;
! 125: int subseq_arg;
! 126: int subseq_retval; /* XXX */
! 127: Keymap dmap;
! 128:
! 129: Keymap oldmap;
! 130: int okey;
! 131: struct __rl_keyseq_context *ocxt;
! 132: int childval;
! 133: } _rl_keyseq_cxt;
! 134:
! 135: /* vi-mode commands that use result of motion command to define boundaries */
! 136: #define VIM_DELETE 0x01
! 137: #define VIM_CHANGE 0x02
! 138: #define VIM_YANK 0x04
! 139:
! 140: /* various states for vi-mode commands that use motion commands. reflects
! 141: RL_READLINE_STATE */
! 142: #define VMSTATE_READ 0x01
! 143: #define VMSTATE_NUMARG 0x02
! 144:
! 145: typedef struct __rl_vimotion_context
! 146: {
! 147: int op;
! 148: int state;
! 149: int flags; /* reserved */
! 150: _rl_arg_cxt ncxt;
! 151: int numeric_arg;
! 152: int start, end; /* rl_point, rl_end */
! 153: int key, motion; /* initial key, motion command */
! 154: } _rl_vimotion_cxt;
! 155:
! 156: /* fill in more as needed */
! 157: /* `Generic' callback data and functions */
! 158: typedef struct __rl_callback_generic_arg
! 159: {
! 160: int count;
! 161: int i1, i2;
! 162: /* add here as needed */
! 163: } _rl_callback_generic_arg;
! 164:
! 165: typedef int _rl_callback_func_t PARAMS((_rl_callback_generic_arg *));
! 166:
! 167: typedef void _rl_sigcleanup_func_t PARAMS((int, void *));
! 168:
! 169: /*************************************************************************
! 170: * *
! 171: * Global functions undocumented in texinfo manual and not in readline.h *
! 172: * *
! 173: *************************************************************************/
! 174:
! 175: /*************************************************************************
! 176: * *
! 177: * Global variables undocumented in texinfo manual and not in readline.h *
! 178: * *
! 179: *************************************************************************/
! 180:
! 181: /* complete.c */
! 182: extern int rl_complete_with_tilde_expansion;
! 183: #if defined (VISIBLE_STATS)
! 184: extern int rl_visible_stats;
! 185: #endif /* VISIBLE_STATS */
! 186: #if defined (COLOR_SUPPORT)
! 187: extern int _rl_colored_stats;
! 188: #endif
! 189:
! 190: /* readline.c */
! 191: extern int rl_line_buffer_len;
! 192: extern int rl_arg_sign;
! 193: extern int rl_visible_prompt_length;
! 194: extern int rl_byte_oriented;
! 195:
! 196: /* display.c */
! 197: extern int rl_display_fixed;
! 198:
! 199: /* parens.c */
! 200: extern int rl_blink_matching_paren;
! 201:
! 202: /*************************************************************************
! 203: * *
! 204: * Global functions and variables unused and undocumented *
! 205: * *
! 206: *************************************************************************/
! 207:
! 208: /* kill.c */
! 209: extern int rl_set_retained_kills PARAMS((int));
! 210:
! 211: /* terminal.c */
! 212: extern void _rl_set_screen_size PARAMS((int, int));
! 213:
! 214: /* undo.c */
! 215: extern int _rl_fix_last_undo_of_type PARAMS((int, int, int));
! 216:
! 217: /* util.c */
! 218: extern char *_rl_savestring PARAMS((const char *));
! 219:
! 220: /*************************************************************************
! 221: * *
! 222: * Functions and variables private to the readline library *
! 223: * *
! 224: *************************************************************************/
! 225:
! 226: /* NOTE: Functions and variables prefixed with `_rl_' are
! 227: pseudo-global: they are global so they can be shared
! 228: between files in the readline library, but are not intended
! 229: to be visible to readline callers. */
! 230:
! 231: /*************************************************************************
! 232: * Undocumented private functions *
! 233: *************************************************************************/
! 234:
! 235: #if defined(READLINE_CALLBACKS)
! 236:
! 237: /* readline.c */
! 238: extern void readline_internal_setup PARAMS((void));
! 239: extern char *readline_internal_teardown PARAMS((int));
! 240: extern int readline_internal_char PARAMS((void));
! 241:
! 242: extern _rl_keyseq_cxt *_rl_keyseq_cxt_alloc PARAMS((void));
! 243: extern void _rl_keyseq_cxt_dispose PARAMS((_rl_keyseq_cxt *));
! 244: extern void _rl_keyseq_chain_dispose PARAMS((void));
! 245:
! 246: extern int _rl_dispatch_callback PARAMS((_rl_keyseq_cxt *));
! 247:
! 248: /* callback.c */
! 249: extern _rl_callback_generic_arg *_rl_callback_data_alloc PARAMS((int));
! 250: extern void _rl_callback_data_dispose PARAMS((_rl_callback_generic_arg *));
! 251:
! 252: #endif /* READLINE_CALLBACKS */
! 253:
! 254: /* bind.c */
! 255: extern char *_rl_untranslate_macro_value PARAMS((char *, int));
! 256:
! 257: /* complete.c */
! 258: extern void _rl_reset_completion_state PARAMS((void));
! 259: extern char _rl_find_completion_word PARAMS((int *, int *));
! 260: extern void _rl_free_match_list PARAMS((char **));
! 261:
! 262: /* display.c */
! 263: extern char *_rl_strip_prompt PARAMS((char *));
! 264: extern void _rl_reset_prompt PARAMS((void));
! 265: extern void _rl_move_cursor_relative PARAMS((int, const char *));
! 266: extern void _rl_move_vert PARAMS((int));
! 267: extern void _rl_save_prompt PARAMS((void));
! 268: extern void _rl_restore_prompt PARAMS((void));
! 269: extern char *_rl_make_prompt_for_search PARAMS((int));
! 270: extern void _rl_erase_at_end_of_line PARAMS((int));
! 271: extern void _rl_clear_to_eol PARAMS((int));
! 272: extern void _rl_clear_screen PARAMS((void));
! 273: extern void _rl_update_final PARAMS((void));
! 274: extern void _rl_redisplay_after_sigwinch PARAMS((void));
! 275: extern void _rl_clean_up_for_exit PARAMS((void));
! 276: extern void _rl_erase_entire_line PARAMS((void));
! 277: extern int _rl_current_display_line PARAMS((void));
! 278:
! 279: /* input.c */
! 280: extern int _rl_any_typein PARAMS((void));
! 281: extern int _rl_input_available PARAMS((void));
! 282: extern int _rl_input_queued PARAMS((int));
! 283: extern void _rl_insert_typein PARAMS((int));
! 284: extern int _rl_unget_char PARAMS((int));
! 285: extern int _rl_pushed_input_available PARAMS((void));
! 286:
! 287: /* isearch.c */
! 288: extern _rl_search_cxt *_rl_scxt_alloc PARAMS((int, int));
! 289: extern void _rl_scxt_dispose PARAMS((_rl_search_cxt *, int));
! 290:
! 291: extern int _rl_isearch_dispatch PARAMS((_rl_search_cxt *, int));
! 292: extern int _rl_isearch_callback PARAMS((_rl_search_cxt *));
! 293:
! 294: extern int _rl_search_getchar PARAMS((_rl_search_cxt *));
! 295:
! 296: /* macro.c */
! 297: extern void _rl_with_macro_input PARAMS((char *));
! 298: extern int _rl_next_macro_key PARAMS((void));
! 299: extern int _rl_prev_macro_key PARAMS((void));
! 300: extern void _rl_push_executing_macro PARAMS((void));
! 301: extern void _rl_pop_executing_macro PARAMS((void));
! 302: extern void _rl_add_macro_char PARAMS((int));
! 303: extern void _rl_kill_kbd_macro PARAMS((void));
! 304:
! 305: /* misc.c */
! 306: extern int _rl_arg_overflow PARAMS((void));
! 307: extern void _rl_arg_init PARAMS((void));
! 308: extern int _rl_arg_getchar PARAMS((void));
! 309: extern int _rl_arg_callback PARAMS((_rl_arg_cxt));
! 310: extern void _rl_reset_argument PARAMS((void));
! 311:
! 312: extern void _rl_start_using_history PARAMS((void));
! 313: extern int _rl_free_saved_history_line PARAMS((void));
! 314: extern void _rl_set_insert_mode PARAMS((int, int));
! 315:
! 316: extern void _rl_revert_all_lines PARAMS((void));
! 317:
! 318: /* nls.c */
! 319: extern int _rl_init_eightbit PARAMS((void));
! 320:
! 321: /* parens.c */
! 322: extern void _rl_enable_paren_matching PARAMS((int));
! 323:
! 324: /* readline.c */
! 325: extern void _rl_init_line_state PARAMS((void));
! 326: extern void _rl_set_the_line PARAMS((void));
! 327: extern int _rl_dispatch PARAMS((int, Keymap));
! 328: extern int _rl_dispatch_subseq PARAMS((int, Keymap, int));
! 329: extern void _rl_internal_char_cleanup PARAMS((void));
! 330:
! 331: /* rltty.c */
! 332: extern int _rl_disable_tty_signals PARAMS((void));
! 333: extern int _rl_restore_tty_signals PARAMS((void));
! 334:
! 335: /* search.c */
! 336: extern int _rl_nsearch_callback PARAMS((_rl_search_cxt *));
! 337:
! 338: /* signals.c */
! 339: extern void _rl_signal_handler PARAMS((int));
! 340:
! 341: extern void _rl_block_sigint PARAMS((void));
! 342: extern void _rl_release_sigint PARAMS((void));
! 343: extern void _rl_block_sigwinch PARAMS((void));
! 344: extern void _rl_release_sigwinch PARAMS((void));
! 345:
! 346: /* terminal.c */
! 347: extern void _rl_get_screen_size PARAMS((int, int));
! 348: extern void _rl_sigwinch_resize_terminal PARAMS((void));
! 349: extern int _rl_init_terminal_io PARAMS((const char *));
! 350: #ifdef _MINIX
! 351: extern void _rl_output_character_function PARAMS((int));
! 352: #else
! 353: extern int _rl_output_character_function PARAMS((int));
! 354: #endif
! 355: extern void _rl_output_some_chars PARAMS((const char *, int));
! 356: extern int _rl_backspace PARAMS((int));
! 357: extern void _rl_enable_meta_key PARAMS((void));
! 358: extern void _rl_disable_meta_key PARAMS((void));
! 359: extern void _rl_control_keypad PARAMS((int));
! 360: extern void _rl_set_cursor PARAMS((int, int));
! 361:
! 362: /* text.c */
! 363: extern void _rl_fix_point PARAMS((int));
! 364: extern int _rl_replace_text PARAMS((const char *, int, int));
! 365: extern int _rl_forward_char_internal PARAMS((int));
! 366: extern int _rl_insert_char PARAMS((int, int));
! 367: extern int _rl_overwrite_char PARAMS((int, int));
! 368: extern int _rl_overwrite_rubout PARAMS((int, int));
! 369: extern int _rl_rubout_char PARAMS((int, int));
! 370: #if defined (HANDLE_MULTIBYTE)
! 371: extern int _rl_char_search_internal PARAMS((int, int, char *, int));
! 372: #else
! 373: extern int _rl_char_search_internal PARAMS((int, int, int));
! 374: #endif
! 375: extern int _rl_set_mark_at_pos PARAMS((int));
! 376:
! 377: /* undo.c */
! 378: extern UNDO_LIST *_rl_copy_undo_entry PARAMS((UNDO_LIST *));
! 379: extern UNDO_LIST *_rl_copy_undo_list PARAMS((UNDO_LIST *));
! 380: extern void _rl_free_undo_list PARAMS((UNDO_LIST *));
! 381:
! 382: /* util.c */
! 383: #if defined (USE_VARARGS) && defined (PREFER_STDARG)
! 384: extern void _rl_ttymsg (const char *, ...) __attribute__((__format__ (printf, 1, 2)));
! 385: extern void _rl_errmsg (const char *, ...) __attribute__((__format__ (printf, 1, 2)));
! 386: extern void _rl_trace (const char *, ...) __attribute__((__format__ (printf, 1, 2)));
! 387: #else
! 388: extern void _rl_ttymsg ();
! 389: extern void _rl_errmsg ();
! 390: extern void _rl_trace ();
! 391: #endif
! 392: extern void _rl_audit_tty PARAMS((char *));
! 393:
! 394: extern int _rl_tropen PARAMS((void));
! 395:
! 396: extern int _rl_abort_internal PARAMS((void));
! 397: extern int _rl_null_function PARAMS((int, int));
! 398: extern char *_rl_strindex PARAMS((const char *, const char *));
! 399: extern int _rl_qsort_string_compare PARAMS((char **, char **));
! 400: extern int (_rl_uppercase_p) PARAMS((int));
! 401: extern int (_rl_lowercase_p) PARAMS((int));
! 402: extern int (_rl_pure_alphabetic) PARAMS((int));
! 403: extern int (_rl_digit_p) PARAMS((int));
! 404: extern int (_rl_to_lower) PARAMS((int));
! 405: extern int (_rl_to_upper) PARAMS((int));
! 406: extern int (_rl_digit_value) PARAMS((int));
! 407:
! 408: /* vi_mode.c */
! 409: extern void _rl_vi_initialize_line PARAMS((void));
! 410: extern void _rl_vi_reset_last PARAMS((void));
! 411: extern void _rl_vi_set_last PARAMS((int, int, int));
! 412: extern int _rl_vi_textmod_command PARAMS((int));
! 413: extern void _rl_vi_done_inserting PARAMS((void));
! 414: extern int _rl_vi_domove_callback PARAMS((_rl_vimotion_cxt *));
! 415:
! 416: /*************************************************************************
! 417: * Undocumented private variables *
! 418: *************************************************************************/
! 419:
! 420: /* bind.c */
! 421: extern const char * const _rl_possible_control_prefixes[];
! 422: extern const char * const _rl_possible_meta_prefixes[];
! 423:
! 424: /* callback.c */
! 425: extern _rl_callback_func_t *_rl_callback_func;
! 426: extern _rl_callback_generic_arg *_rl_callback_data;
! 427:
! 428: /* complete.c */
! 429: extern int _rl_complete_show_all;
! 430: extern int _rl_complete_show_unmodified;
! 431: extern int _rl_complete_mark_directories;
! 432: extern int _rl_complete_mark_symlink_dirs;
! 433: extern int _rl_completion_prefix_display_length;
! 434: extern int _rl_completion_columns;
! 435: extern int _rl_print_completions_horizontally;
! 436: extern int _rl_completion_case_fold;
! 437: extern int _rl_completion_case_map;
! 438: extern int _rl_match_hidden_files;
! 439: extern int _rl_page_completions;
! 440: extern int _rl_skip_completed_text;
! 441: extern int _rl_menu_complete_prefix_first;
! 442:
! 443: /* display.c */
! 444: extern int _rl_vis_botlin;
! 445: extern int _rl_last_c_pos;
! 446: extern int _rl_suppress_redisplay;
! 447: extern int _rl_want_redisplay;
! 448:
! 449: /* isearch.c */
! 450: extern char *_rl_isearch_terminators;
! 451:
! 452: extern _rl_search_cxt *_rl_iscxt;
! 453:
! 454: /* macro.c */
! 455: extern char *_rl_executing_macro;
! 456:
! 457: /* misc.c */
! 458: extern int _rl_history_preserve_point;
! 459: extern int _rl_history_saved_point;
! 460:
! 461: extern _rl_arg_cxt _rl_argcxt;
! 462:
! 463: /* nls.c */
! 464: extern int _rl_utf8locale;
! 465:
! 466: /* readline.c */
! 467: extern int _rl_echoing_p;
! 468: extern int _rl_horizontal_scroll_mode;
! 469: extern int _rl_mark_modified_lines;
! 470: extern int _rl_bell_preference;
! 471: extern int _rl_meta_flag;
! 472: extern int _rl_convert_meta_chars_to_ascii;
! 473: extern int _rl_output_meta_chars;
! 474: extern int _rl_bind_stty_chars;
! 475: extern int _rl_revert_all_at_newline;
! 476: extern int _rl_echo_control_chars;
! 477: extern int _rl_show_mode_in_prompt;
! 478: extern char *_rl_comment_begin;
! 479: extern unsigned char _rl_parsing_conditionalized_out;
! 480: extern Keymap _rl_keymap;
! 481: extern FILE *_rl_in_stream;
! 482: extern FILE *_rl_out_stream;
! 483: extern int _rl_last_command_was_kill;
! 484: extern int _rl_eof_char;
! 485: extern procenv_t _rl_top_level;
! 486: extern _rl_keyseq_cxt *_rl_kscxt;
! 487: extern int _rl_keyseq_timeout;
! 488:
! 489: extern int _rl_executing_keyseq_size;
! 490:
! 491: /* search.c */
! 492: extern _rl_search_cxt *_rl_nscxt;
! 493:
! 494: /* signals.c */
! 495: extern int _rl_interrupt_immediately;
! 496: extern int volatile _rl_caught_signal;
! 497:
! 498: extern _rl_sigcleanup_func_t *_rl_sigcleanup;
! 499: extern void *_rl_sigcleanarg;
! 500:
! 501: extern int _rl_echoctl;
! 502:
! 503: extern int _rl_intr_char;
! 504: extern int _rl_quit_char;
! 505: extern int _rl_susp_char;
! 506:
! 507: /* terminal.c */
! 508: extern int _rl_enable_keypad;
! 509: extern int _rl_enable_meta;
! 510: extern char *_rl_term_clreol;
! 511: extern char *_rl_term_clrpag;
! 512: extern char *_rl_term_im;
! 513: extern char *_rl_term_ic;
! 514: extern char *_rl_term_ei;
! 515: extern char *_rl_term_DC;
! 516: extern char *_rl_term_up;
! 517: extern char *_rl_term_dc;
! 518: extern char *_rl_term_cr;
! 519: extern char *_rl_term_IC;
! 520: extern char *_rl_term_forward_char;
! 521: extern int _rl_screenheight;
! 522: extern int _rl_screenwidth;
! 523: extern int _rl_screenchars;
! 524: extern int _rl_terminal_can_insert;
! 525: extern int _rl_term_autowrap;
! 526:
! 527: /* undo.c */
! 528: extern int _rl_doing_an_undo;
! 529: extern int _rl_undo_group_level;
! 530:
! 531: /* vi_mode.c */
! 532: extern int _rl_vi_last_command;
! 533: extern _rl_vimotion_cxt *_rl_vimvcxt;
! 534:
! 535: #endif /* _RL_PRIVATE_H_ */
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>