Annotation of embedaddon/readline/rlprivate.h, revision 1.1.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>