xref: /openbsd/gnu/lib/libreadline/readline.c (revision 9704b281)
1 /* readline.c -- a general facility for reading lines of input
2    with emacs style editing and completion. */
3 
4 /* Copyright (C) 1987-2002 Free Software Foundation, Inc.
5 
6    This file is part of the GNU Readline Library, a library for
7    reading lines of text with interactive input and history editing.
8 
9    The GNU Readline Library is free software; you can redistribute it
10    and/or modify it under the terms of the GNU General Public License
11    as published by the Free Software Foundation; either version 2, or
12    (at your option) any later version.
13 
14    The GNU Readline Library is distributed in the hope that it will be
15    useful, but WITHOUT ANY WARRANTY; without even the implied warranty
16    of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17    GNU General Public License for more details.
18 
19    The GNU General Public License is often shipped with GNU software, and
20    is generally kept in a file called COPYING or LICENSE.  If you do not
21    have a copy of the license, write to the Free Software Foundation,
22    59 Temple Place, Suite 330, Boston, MA 02111 USA. */
23 #define READLINE_LIBRARY
24 
25 #if defined (HAVE_CONFIG_H)
26 #  include <config.h>
27 #endif
28 
29 #include <sys/types.h>
30 #include "posixstat.h"
31 #include <fcntl.h>
32 #if defined (HAVE_SYS_FILE_H)
33 #  include <sys/file.h>
34 #endif /* HAVE_SYS_FILE_H */
35 
36 #if defined (HAVE_UNISTD_H)
37 #  include <unistd.h>
38 #endif /* HAVE_UNISTD_H */
39 
40 #if defined (HAVE_STDLIB_H)
41 #  include <stdlib.h>
42 #else
43 #  include "ansi_stdlib.h"
44 #endif /* HAVE_STDLIB_H */
45 
46 #if defined (HAVE_LOCALE_H)
47 #  include <locale.h>
48 #endif
49 
50 #include <stdio.h>
51 #include "posixjmp.h"
52 
53 /* System-specific feature definitions and include files. */
54 #include "rldefs.h"
55 #include "rlmbutil.h"
56 
57 #if defined (__EMX__)
58 #  define INCL_DOSPROCESS
59 #  include <os2.h>
60 #endif /* __EMX__ */
61 
62 /* Some standard library routines. */
63 #include "readline.h"
64 #include "history.h"
65 
66 #include "rlprivate.h"
67 #include "rlshell.h"
68 #include "xmalloc.h"
69 
70 #ifndef RL_LIBRARY_VERSION
71 #  define RL_LIBRARY_VERSION "4.3"
72 #endif
73 
74 #ifndef RL_READLINE_VERSION
75 #  define RL_READLINE_VERSION	0x0403
76 #endif
77 
78 extern void _rl_free_history_entry PARAMS((HIST_ENTRY *));
79 
80 /* Forward declarations used in this file. */
81 static char *readline_internal PARAMS((void));
82 static void readline_initialize_everything PARAMS((void));
83 
84 static void bind_arrow_keys_internal PARAMS((Keymap));
85 static void bind_arrow_keys PARAMS((void));
86 
87 static void readline_default_bindings PARAMS((void));
88 
89 /* **************************************************************** */
90 /*								    */
91 /*			Line editing input utility		    */
92 /*								    */
93 /* **************************************************************** */
94 
95 const char *rl_library_version = RL_LIBRARY_VERSION;
96 
97 int rl_readline_version = RL_READLINE_VERSION;
98 
99 /* True if this is `real' readline as opposed to some stub substitute. */
100 int rl_gnu_readline_p = 1;
101 
102 /* A pointer to the keymap that is currently in use.
103    By default, it is the standard emacs keymap. */
104 Keymap _rl_keymap = emacs_standard_keymap;
105 
106 /* The current style of editing. */
107 int rl_editing_mode = emacs_mode;
108 
109 /* The current insert mode:  input (the default) or overwrite */
110 int rl_insert_mode = RL_IM_DEFAULT;
111 
112 /* Non-zero if we called this function from _rl_dispatch().  It's present
113    so functions can find out whether they were called from a key binding
114    or directly from an application. */
115 int rl_dispatching;
116 
117 /* Non-zero if the previous command was a kill command. */
118 int _rl_last_command_was_kill = 0;
119 
120 /* The current value of the numeric argument specified by the user. */
121 int rl_numeric_arg = 1;
122 
123 /* Non-zero if an argument was typed. */
124 int rl_explicit_arg = 0;
125 
126 /* Temporary value used while generating the argument. */
127 int rl_arg_sign = 1;
128 
129 /* Non-zero means we have been called at least once before. */
130 static int rl_initialized;
131 
132 #if 0
133 /* If non-zero, this program is running in an EMACS buffer. */
134 static int running_in_emacs;
135 #endif
136 
137 /* Flags word encapsulating the current readline state. */
138 int rl_readline_state = RL_STATE_NONE;
139 
140 /* The current offset in the current input line. */
141 int rl_point;
142 
143 /* Mark in the current input line. */
144 int rl_mark;
145 
146 /* Length of the current input line. */
147 int rl_end;
148 
149 /* Make this non-zero to return the current input_line. */
150 int rl_done;
151 
152 /* The last function executed by readline. */
153 rl_command_func_t *rl_last_func = (rl_command_func_t *)NULL;
154 
155 /* Top level environment for readline_internal (). */
156 procenv_t readline_top_level;
157 
158 /* The streams we interact with. */
159 FILE *_rl_in_stream, *_rl_out_stream;
160 
161 /* The names of the streams that we do input and output to. */
162 FILE *rl_instream = (FILE *)NULL;
163 FILE *rl_outstream = (FILE *)NULL;
164 
165 /* Non-zero means echo characters as they are read.  Defaults to no echo;
166    set to 1 if there is a controlling terminal, we can get its attributes,
167    and the attributes include `echo'.  Look at rltty.c:prepare_terminal_settings
168    for the code that sets it. */
169 int readline_echoing_p = 0;
170 
171 /* Current prompt. */
172 char *rl_prompt = (char *)NULL;
173 int rl_visible_prompt_length = 0;
174 
175 /* Set to non-zero by calling application if it has already printed rl_prompt
176    and does not want readline to do it the first time. */
177 int rl_already_prompted = 0;
178 
179 /* The number of characters read in order to type this complete command. */
180 int rl_key_sequence_length = 0;
181 
182 /* If non-zero, then this is the address of a function to call just
183    before readline_internal_setup () prints the first prompt. */
184 rl_hook_func_t *rl_startup_hook = (rl_hook_func_t *)NULL;
185 
186 /* If non-zero, this is the address of a function to call just before
187    readline_internal_setup () returns and readline_internal starts
188    reading input characters. */
189 rl_hook_func_t *rl_pre_input_hook = (rl_hook_func_t *)NULL;
190 
191 /* What we use internally.  You should always refer to RL_LINE_BUFFER. */
192 static char *the_line;
193 
194 /* The character that can generate an EOF.  Really read from
195    the terminal driver... just defaulted here. */
196 int _rl_eof_char = CTRL ('D');
197 
198 /* Non-zero makes this the next keystroke to read. */
199 int rl_pending_input = 0;
200 
201 /* Pointer to a useful terminal name. */
202 const char *rl_terminal_name = (const char *)NULL;
203 
204 /* Non-zero means to always use horizontal scrolling in line display. */
205 int _rl_horizontal_scroll_mode = 0;
206 
207 /* Non-zero means to display an asterisk at the starts of history lines
208    which have been modified. */
209 int _rl_mark_modified_lines = 0;
210 
211 /* The style of `bell' notification preferred.  This can be set to NO_BELL,
212    AUDIBLE_BELL, or VISIBLE_BELL. */
213 int _rl_bell_preference = AUDIBLE_BELL;
214 
215 /* String inserted into the line by rl_insert_comment (). */
216 char *_rl_comment_begin;
217 
218 /* Keymap holding the function currently being executed. */
219 Keymap rl_executing_keymap;
220 
221 /* Non-zero means to erase entire line, including prompt, on empty input lines. */
222 int rl_erase_empty_line = 0;
223 
224 /* Non-zero means to read only this many characters rather than up to a
225    character bound to accept-line. */
226 int rl_num_chars_to_read;
227 
228 /* Line buffer and maintenence. */
229 char *rl_line_buffer = (char *)NULL;
230 int rl_line_buffer_len = 0;
231 
232 /* Forward declarations used by the display, termcap, and history code. */
233 
234 /* **************************************************************** */
235 /*								    */
236 /*			`Forward' declarations			    */
237 /*								    */
238 /* **************************************************************** */
239 
240 /* Non-zero means do not parse any lines other than comments and
241    parser directives. */
242 unsigned char _rl_parsing_conditionalized_out = 0;
243 
244 /* Non-zero means to convert characters with the meta bit set to
245    escape-prefixed characters so we can indirect through
246    emacs_meta_keymap or vi_escape_keymap. */
247 int _rl_convert_meta_chars_to_ascii = 1;
248 
249 /* Non-zero means to output characters with the meta bit set directly
250    rather than as a meta-prefixed escape sequence. */
251 int _rl_output_meta_chars = 0;
252 
253 /* **************************************************************** */
254 /*								    */
255 /*			Top Level Functions			    */
256 /*								    */
257 /* **************************************************************** */
258 
259 /* Non-zero means treat 0200 bit in terminal input as Meta bit. */
260 int _rl_meta_flag = 0;	/* Forward declaration */
261 
262 /* Set up the prompt and expand it.  Called from readline() and
263    rl_callback_handler_install (). */
264 int
rl_set_prompt(prompt)265 rl_set_prompt (prompt)
266      const char *prompt;
267 {
268   FREE (rl_prompt);
269   rl_prompt = prompt ? savestring (prompt) : (char *)NULL;
270 
271   rl_visible_prompt_length = rl_expand_prompt (rl_prompt);
272   return 0;
273 }
274 
275 /* Read a line of input.  Prompt with PROMPT.  An empty PROMPT means
276    none.  A return value of NULL means that EOF was encountered. */
277 char *
readline(prompt)278 readline (prompt)
279      const char *prompt;
280 {
281   char *value;
282 
283   /* If we are at EOF return a NULL string. */
284   if (rl_pending_input == EOF)
285     {
286       rl_clear_pending_input ();
287       return ((char *)NULL);
288     }
289 
290   rl_set_prompt (prompt);
291 
292   rl_initialize ();
293   (*rl_prep_term_function) (_rl_meta_flag);
294 
295 #if defined (HANDLE_SIGNALS)
296   rl_set_signals ();
297 #endif
298 
299   value = readline_internal ();
300   (*rl_deprep_term_function) ();
301 
302 #if defined (HANDLE_SIGNALS)
303   rl_clear_signals ();
304 #endif
305 
306   return (value);
307 }
308 
309 #if defined (READLINE_CALLBACKS)
310 #  define STATIC_CALLBACK
311 #else
312 #  define STATIC_CALLBACK static
313 #endif
314 
315 STATIC_CALLBACK void
readline_internal_setup()316 readline_internal_setup ()
317 {
318   char *nprompt;
319 
320   _rl_in_stream = rl_instream;
321   _rl_out_stream = rl_outstream;
322 
323   if (rl_startup_hook)
324     (*rl_startup_hook) ();
325 
326   /* If we're not echoing, we still want to at least print a prompt, because
327      rl_redisplay will not do it for us.  If the calling application has a
328      custom redisplay function, though, let that function handle it. */
329   if (readline_echoing_p == 0 && rl_redisplay_function == rl_redisplay)
330     {
331       if (rl_prompt && rl_already_prompted == 0)
332 	{
333 	  nprompt = _rl_strip_prompt (rl_prompt);
334 	  fprintf (_rl_out_stream, "%s", nprompt);
335 	  fflush (_rl_out_stream);
336 	  free (nprompt);
337 	}
338     }
339   else
340     {
341       if (rl_prompt && rl_already_prompted)
342 	rl_on_new_line_with_prompt ();
343       else
344 	rl_on_new_line ();
345       (*rl_redisplay_function) ();
346     }
347 
348 #if defined (VI_MODE)
349   if (rl_editing_mode == vi_mode)
350     rl_vi_insertion_mode (1, 0);
351 #endif /* VI_MODE */
352 
353   if (rl_pre_input_hook)
354     (*rl_pre_input_hook) ();
355 }
356 
357 STATIC_CALLBACK char *
readline_internal_teardown(eof)358 readline_internal_teardown (eof)
359      int eof;
360 {
361   char *temp;
362   HIST_ENTRY *entry;
363 
364   /* Restore the original of this history line, iff the line that we
365      are editing was originally in the history, AND the line has changed. */
366   entry = current_history ();
367 
368   if (entry && rl_undo_list)
369     {
370       temp = savestring (the_line);
371       rl_revert_line (1, 0);
372       entry = replace_history_entry (where_history (), the_line, (histdata_t)NULL);
373       _rl_free_history_entry (entry);
374 
375       strlcpy (the_line, temp, rl_line_buffer_len);
376       free (temp);
377     }
378 
379   /* At any rate, it is highly likely that this line has an undo list.  Get
380      rid of it now. */
381   if (rl_undo_list)
382     rl_free_undo_list ();
383 
384   /* Restore normal cursor, if available. */
385   _rl_set_insert_mode (RL_IM_INSERT, 0);
386 
387   return (eof ? (char *)NULL : savestring (the_line));
388 }
389 
390 STATIC_CALLBACK int
391 #if defined (READLINE_CALLBACKS)
readline_internal_char()392 readline_internal_char ()
393 #else
394 readline_internal_charloop ()
395 #endif
396 {
397   static int lastc, eof_found;
398   int c, code, lk;
399 
400   lastc = -1;
401   eof_found = 0;
402 
403 #if !defined (READLINE_CALLBACKS)
404   while (rl_done == 0)
405     {
406 #endif
407       lk = _rl_last_command_was_kill;
408 
409       code = setjmp (readline_top_level);
410 
411       if (code)
412 	(*rl_redisplay_function) ();
413 
414       if (rl_pending_input == 0)
415 	{
416 	  /* Then initialize the argument and number of keys read. */
417 	  _rl_init_argument ();
418 	  rl_key_sequence_length = 0;
419 	}
420 
421       RL_SETSTATE(RL_STATE_READCMD);
422       c = rl_read_key ();
423       RL_UNSETSTATE(RL_STATE_READCMD);
424 
425       /* EOF typed to a non-blank line is a <NL>. */
426       if (c == EOF && rl_end)
427 	c = NEWLINE;
428 
429       /* The character _rl_eof_char typed to blank line, and not as the
430 	 previous character is interpreted as EOF. */
431       if (((c == _rl_eof_char && lastc != c) || c == EOF) && !rl_end)
432 	{
433 #if defined (READLINE_CALLBACKS)
434 	  RL_SETSTATE(RL_STATE_DONE);
435 	  return (rl_done = 1);
436 #else
437 	  eof_found = 1;
438 	  break;
439 #endif
440 	}
441 
442       lastc = c;
443       _rl_dispatch ((unsigned char)c, _rl_keymap);
444 
445       /* If there was no change in _rl_last_command_was_kill, then no kill
446 	 has taken place.  Note that if input is pending we are reading
447 	 a prefix command, so nothing has changed yet. */
448       if (rl_pending_input == 0 && lk == _rl_last_command_was_kill)
449 	_rl_last_command_was_kill = 0;
450 
451 #if defined (VI_MODE)
452       /* In vi mode, when you exit insert mode, the cursor moves back
453 	 over the previous character.  We explicitly check for that here. */
454       if (rl_editing_mode == vi_mode && _rl_keymap == vi_movement_keymap)
455 	rl_vi_check ();
456 #endif /* VI_MODE */
457 
458       if (rl_num_chars_to_read && rl_end >= rl_num_chars_to_read)
459         {
460           (*rl_redisplay_function) ();
461           rl_newline (1, '\n');
462         }
463 
464       if (rl_done == 0)
465 	(*rl_redisplay_function) ();
466 
467       /* If the application writer has told us to erase the entire line if
468 	  the only character typed was something bound to rl_newline, do so. */
469       if (rl_erase_empty_line && rl_done && rl_last_func == rl_newline &&
470 	  rl_point == 0 && rl_end == 0)
471 	_rl_erase_entire_line ();
472 
473 #if defined (READLINE_CALLBACKS)
474       return 0;
475 #else
476     }
477 
478   return (eof_found);
479 #endif
480 }
481 
482 #if defined (READLINE_CALLBACKS)
483 static int
readline_internal_charloop()484 readline_internal_charloop ()
485 {
486   int eof = 1;
487 
488   while (rl_done == 0)
489     eof = readline_internal_char ();
490   return (eof);
491 }
492 #endif /* READLINE_CALLBACKS */
493 
494 /* Read a line of input from the global rl_instream, doing output on
495    the global rl_outstream.
496    If rl_prompt is non-null, then that is our prompt. */
497 static char *
readline_internal()498 readline_internal ()
499 {
500   int eof;
501 
502   readline_internal_setup ();
503   eof = readline_internal_charloop ();
504   return (readline_internal_teardown (eof));
505 }
506 
507 void
_rl_init_line_state()508 _rl_init_line_state ()
509 {
510   rl_point = rl_end = rl_mark = 0;
511   the_line = rl_line_buffer;
512   the_line[0] = 0;
513 }
514 
515 void
_rl_set_the_line()516 _rl_set_the_line ()
517 {
518   the_line = rl_line_buffer;
519 }
520 
521 /* Do the command associated with KEY in MAP.
522    If the associated command is really a keymap, then read
523    another key, and dispatch into that map. */
524 int
_rl_dispatch(key,map)525 _rl_dispatch (key, map)
526      register int key;
527      Keymap map;
528 {
529   return _rl_dispatch_subseq (key, map, 0);
530 }
531 
532 int
_rl_dispatch_subseq(key,map,got_subseq)533 _rl_dispatch_subseq (key, map, got_subseq)
534      register int key;
535      Keymap map;
536      int got_subseq;
537 {
538   int r, newkey;
539   char *macro;
540   rl_command_func_t *func;
541 
542   if (META_CHAR (key) && _rl_convert_meta_chars_to_ascii)
543     {
544       if (map[ESC].type == ISKMAP)
545 	{
546 	  if (RL_ISSTATE (RL_STATE_MACRODEF))
547 	    _rl_add_macro_char (ESC);
548 	  map = FUNCTION_TO_KEYMAP (map, ESC);
549 	  key = UNMETA (key);
550 	  rl_key_sequence_length += 2;
551 	  return (_rl_dispatch (key, map));
552 	}
553       else
554 	rl_ding ();
555       return 0;
556     }
557 
558   if (RL_ISSTATE (RL_STATE_MACRODEF))
559     _rl_add_macro_char (key);
560 
561   r = 0;
562   switch (map[key].type)
563     {
564     case ISFUNC:
565       func = map[key].function;
566       if (func)
567 	{
568 	  /* Special case rl_do_lowercase_version (). */
569 	  if (func == rl_do_lowercase_version)
570 	    return (_rl_dispatch (_rl_to_lower (key), map));
571 
572 	  rl_executing_keymap = map;
573 
574 #if 0
575 	  _rl_suppress_redisplay = (map[key].function == rl_insert) && _rl_input_available ();
576 #endif
577 
578 	  rl_dispatching = 1;
579 	  RL_SETSTATE(RL_STATE_DISPATCHING);
580 	  r = (*map[key].function)(rl_numeric_arg * rl_arg_sign, key);
581 	  RL_UNSETSTATE(RL_STATE_DISPATCHING);
582 	  rl_dispatching = 0;
583 
584 	  /* If we have input pending, then the last command was a prefix
585 	     command.  Don't change the state of rl_last_func.  Otherwise,
586 	     remember the last command executed in this variable. */
587 	  if (rl_pending_input == 0 && map[key].function != rl_digit_argument)
588 	    rl_last_func = map[key].function;
589 	}
590       else if (map[ANYOTHERKEY].function)
591 	{
592 	  /* OK, there's no function bound in this map, but there is a
593 	     shadow function that was overridden when the current keymap
594 	     was created.  Return -2 to note  that. */
595 	  _rl_unget_char  (key);
596 	  return -2;
597 	}
598       else if (got_subseq)
599 	{
600 	  /* Return -1 to note that we're in a subsequence, but  we don't
601 	     have a matching key, nor was one overridden.  This means
602 	     we need to back up the recursion chain and find the last
603 	     subsequence that is bound to a function. */
604 	  _rl_unget_char (key);
605 	  return -1;
606 	}
607       else
608 	{
609 	  _rl_abort_internal ();
610 	  return -1;
611 	}
612       break;
613 
614     case ISKMAP:
615       if (map[key].function != 0)
616 	{
617 #if defined (VI_MODE)
618 	  /* The only way this test will be true is if a subsequence has been
619 	     bound starting with ESC, generally the arrow keys.  What we do is
620 	     check whether there's input in the queue, which there generally
621 	     will be if an arrow key has been pressed, and, if there's not,
622 	     just dispatch to (what we assume is) rl_vi_movement_mode right
623 	     away.  This is essentially an input test with a zero timeout. */
624 	  if (rl_editing_mode == vi_mode && key == ESC && map == vi_insertion_keymap
625 	      && _rl_input_queued (0) == 0)
626 	    return (_rl_dispatch (ANYOTHERKEY, FUNCTION_TO_KEYMAP (map, key)));
627 #endif
628 
629 	  rl_key_sequence_length++;
630 
631 	  if (key == ESC)
632 	    RL_SETSTATE(RL_STATE_METANEXT);
633 	  RL_SETSTATE(RL_STATE_MOREINPUT);
634 	  newkey = rl_read_key ();
635 	  RL_UNSETSTATE(RL_STATE_MOREINPUT);
636 	  if (key == ESC)
637 	    RL_UNSETSTATE(RL_STATE_METANEXT);
638 
639 	  if (newkey < 0)
640 	    {
641 	      _rl_abort_internal ();
642 	      return -1;
643 	    }
644 
645 	  r = _rl_dispatch_subseq (newkey, FUNCTION_TO_KEYMAP (map, key), got_subseq || map[ANYOTHERKEY].function);
646 
647 	  if (r == -2)
648 	    /* We didn't match anything, and the keymap we're indexed into
649 	       shadowed a function previously bound to that prefix.  Call
650 	       the function.  The recursive call to _rl_dispatch_subseq has
651 	       already taken care of pushing any necessary input back onto
652 	       the input queue with _rl_unget_char. */
653 	    r = _rl_dispatch (ANYOTHERKEY, FUNCTION_TO_KEYMAP (map, key));
654 	  else if (r && map[ANYOTHERKEY].function)
655 	    {
656 	      /* We didn't match (r is probably -1), so return something to
657 		 tell the caller that it should try ANYOTHERKEY for an
658 		 overridden function. */
659 	      _rl_unget_char (key);
660 	      return -2;
661 	    }
662 	  else if (r && got_subseq)
663 	    {
664 	      /* OK, back up the chain. */
665 	      _rl_unget_char (key);
666 	      return -1;
667 	    }
668 	}
669       else
670 	{
671 	  _rl_abort_internal ();
672 	  return -1;
673 	}
674       break;
675 
676     case ISMACR:
677       if (map[key].function != 0)
678 	{
679 	  macro = savestring ((char *)map[key].function);
680 	  _rl_with_macro_input (macro);
681 	  return 0;
682 	}
683       break;
684     }
685 #if defined (VI_MODE)
686   if (rl_editing_mode == vi_mode && _rl_keymap == vi_movement_keymap &&
687       key != ANYOTHERKEY &&
688       _rl_vi_textmod_command (key))
689     _rl_vi_set_last (key, rl_numeric_arg, rl_arg_sign);
690 #endif
691   return (r);
692 }
693 
694 /* **************************************************************** */
695 /*								    */
696 /*			Initializations				    */
697 /*								    */
698 /* **************************************************************** */
699 
700 /* Initialize readline (and terminal if not already). */
701 int
rl_initialize()702 rl_initialize ()
703 {
704   /* If we have never been called before, initialize the
705      terminal and data structures. */
706   if (!rl_initialized)
707     {
708       RL_SETSTATE(RL_STATE_INITIALIZING);
709       readline_initialize_everything ();
710       RL_UNSETSTATE(RL_STATE_INITIALIZING);
711       rl_initialized++;
712       RL_SETSTATE(RL_STATE_INITIALIZED);
713     }
714 
715   /* Initalize the current line information. */
716   _rl_init_line_state ();
717 
718   /* We aren't done yet.  We haven't even gotten started yet! */
719   rl_done = 0;
720   RL_UNSETSTATE(RL_STATE_DONE);
721 
722   /* Tell the history routines what is going on. */
723   _rl_start_using_history ();
724 
725   /* Make the display buffer match the state of the line. */
726   rl_reset_line_state ();
727 
728   /* No such function typed yet. */
729   rl_last_func = (rl_command_func_t *)NULL;
730 
731   /* Parsing of key-bindings begins in an enabled state. */
732   _rl_parsing_conditionalized_out = 0;
733 
734 #if defined (VI_MODE)
735   if (rl_editing_mode == vi_mode)
736     _rl_vi_initialize_line ();
737 #endif
738 
739   /* Each line starts in insert mode (the default). */
740   _rl_set_insert_mode (RL_IM_DEFAULT, 1);
741 
742   return 0;
743 }
744 
745 #if 0
746 #if defined (__EMX__)
747 static void
748 _emx_build_environ ()
749 {
750   TIB *tibp;
751   PIB *pibp;
752   char *t, **tp;
753   int c;
754 
755   DosGetInfoBlocks (&tibp, &pibp);
756   t = pibp->pib_pchenv;
757   for (c = 1; *t; c++)
758     t += strlen (t) + 1;
759   tp = environ = (char **)xmalloc ((c + 1) * sizeof (char *));
760   t = pibp->pib_pchenv;
761   while (*t)
762     {
763       *tp++ = t;
764       t += strlen (t) + 1;
765     }
766   *tp = 0;
767 }
768 #endif /* __EMX__ */
769 #endif
770 
771 /* Initialize the entire state of the world. */
772 static void
readline_initialize_everything()773 readline_initialize_everything ()
774 {
775 #if 0
776 #if defined (__EMX__)
777   if (environ == 0)
778     _emx_build_environ ();
779 #endif
780 #endif
781 
782 #if 0
783   /* Find out if we are running in Emacs -- UNUSED. */
784   running_in_emacs = sh_get_env_value ("EMACS") != (char *)0;
785 #endif
786 
787   /* Set up input and output if they are not already set up. */
788   if (!rl_instream)
789     rl_instream = stdin;
790 
791   if (!rl_outstream)
792     rl_outstream = stdout;
793 
794   /* Bind _rl_in_stream and _rl_out_stream immediately.  These values
795      may change, but they may also be used before readline_internal ()
796      is called. */
797   _rl_in_stream = rl_instream;
798   _rl_out_stream = rl_outstream;
799 
800   /* Allocate data structures. */
801   if (rl_line_buffer == 0)
802     rl_line_buffer = (char *)xmalloc (rl_line_buffer_len = DEFAULT_BUFFER_SIZE);
803 
804   /* Initialize the terminal interface. */
805   if (rl_terminal_name == 0)
806     rl_terminal_name = sh_get_env_value ("TERM");
807   _rl_init_terminal_io (rl_terminal_name);
808 
809   /* Bind tty characters to readline functions. */
810   readline_default_bindings ();
811 
812   /* Initialize the function names. */
813   rl_initialize_funmap ();
814 
815   /* Decide whether we should automatically go into eight-bit mode. */
816   _rl_init_eightbit ();
817 
818   /* Read in the init file. */
819   rl_read_init_file ((char *)NULL);
820 
821   /* XXX */
822   if (_rl_horizontal_scroll_mode && _rl_term_autowrap)
823     {
824       _rl_screenwidth--;
825       _rl_screenchars -= _rl_screenheight;
826     }
827 
828   /* Override the effect of any `set keymap' assignments in the
829      inputrc file. */
830   rl_set_keymap_from_edit_mode ();
831 
832   /* Try to bind a common arrow key prefix, if not already bound. */
833   bind_arrow_keys ();
834 
835   /* Enable the meta key, if this terminal has one. */
836   if (_rl_enable_meta)
837     _rl_enable_meta_key ();
838 
839   /* If the completion parser's default word break characters haven't
840      been set yet, then do so now. */
841   if (rl_completer_word_break_characters == (char *)NULL)
842     rl_completer_word_break_characters = rl_basic_word_break_characters;
843 }
844 
845 /* If this system allows us to look at the values of the regular
846    input editing characters, then bind them to their readline
847    equivalents, iff the characters are not bound to keymaps. */
848 static void
readline_default_bindings()849 readline_default_bindings ()
850 {
851   rl_tty_set_default_bindings (_rl_keymap);
852 }
853 
854 /* Bind some common arrow key sequences in MAP. */
855 static void
bind_arrow_keys_internal(map)856 bind_arrow_keys_internal (map)
857      Keymap map;
858 {
859   Keymap xkeymap;
860 
861   xkeymap = _rl_keymap;
862   _rl_keymap = map;
863 
864 #if defined (__MSDOS__)
865    _rl_bind_if_unbound ("\033[0A", rl_get_previous_history);
866    _rl_bind_if_unbound ("\033[0B", rl_backward_char);
867    _rl_bind_if_unbound ("\033[0C", rl_forward_char);
868    _rl_bind_if_unbound ("\033[0D", rl_get_next_history);
869 #endif
870 
871   _rl_bind_if_unbound ("\033[A", rl_get_previous_history);
872   _rl_bind_if_unbound ("\033[B", rl_get_next_history);
873   _rl_bind_if_unbound ("\033[C", rl_forward_char);
874   _rl_bind_if_unbound ("\033[D", rl_backward_char);
875   _rl_bind_if_unbound ("\033[H", rl_beg_of_line);
876   _rl_bind_if_unbound ("\033[F", rl_end_of_line);
877 
878   _rl_bind_if_unbound ("\033OA", rl_get_previous_history);
879   _rl_bind_if_unbound ("\033OB", rl_get_next_history);
880   _rl_bind_if_unbound ("\033OC", rl_forward_char);
881   _rl_bind_if_unbound ("\033OD", rl_backward_char);
882   _rl_bind_if_unbound ("\033OH", rl_beg_of_line);
883   _rl_bind_if_unbound ("\033OF", rl_end_of_line);
884 
885   _rl_keymap = xkeymap;
886 }
887 
888 /* Try and bind the common arrow key prefixes after giving termcap and
889    the inputrc file a chance to bind them and create `real' keymaps
890    for the arrow key prefix. */
891 static void
bind_arrow_keys()892 bind_arrow_keys ()
893 {
894   bind_arrow_keys_internal (emacs_standard_keymap);
895 
896 #if defined (VI_MODE)
897   bind_arrow_keys_internal (vi_movement_keymap);
898   bind_arrow_keys_internal (vi_insertion_keymap);
899 #endif
900 }
901 
902 /* **************************************************************** */
903 /*								    */
904 /*		Saving and Restoring Readline's state		    */
905 /*								    */
906 /* **************************************************************** */
907 
908 int
rl_save_state(sp)909 rl_save_state (sp)
910      struct readline_state *sp;
911 {
912   if (sp == 0)
913     return -1;
914 
915   sp->point = rl_point;
916   sp->end = rl_end;
917   sp->mark = rl_mark;
918   sp->buffer = rl_line_buffer;
919   sp->buflen = rl_line_buffer_len;
920   sp->ul = rl_undo_list;
921   sp->prompt = rl_prompt;
922 
923   sp->rlstate = rl_readline_state;
924   sp->done = rl_done;
925   sp->kmap = _rl_keymap;
926 
927   sp->lastfunc = rl_last_func;
928   sp->insmode = rl_insert_mode;
929   sp->edmode = rl_editing_mode;
930   sp->kseqlen = rl_key_sequence_length;
931   sp->inf = rl_instream;
932   sp->outf = rl_outstream;
933   sp->pendingin = rl_pending_input;
934   sp->macro = rl_executing_macro;
935 
936   sp->catchsigs = rl_catch_signals;
937   sp->catchsigwinch = rl_catch_sigwinch;
938 
939   return (0);
940 }
941 
942 int
rl_restore_state(sp)943 rl_restore_state (sp)
944      struct readline_state *sp;
945 {
946   if (sp == 0)
947     return -1;
948 
949   rl_point = sp->point;
950   rl_end = sp->end;
951   rl_mark = sp->mark;
952   the_line = rl_line_buffer = sp->buffer;
953   rl_line_buffer_len = sp->buflen;
954   rl_undo_list = sp->ul;
955   rl_prompt = sp->prompt;
956 
957   rl_readline_state = sp->rlstate;
958   rl_done = sp->done;
959   _rl_keymap = sp->kmap;
960 
961   rl_last_func = sp->lastfunc;
962   rl_insert_mode = sp->insmode;
963   rl_editing_mode = sp->edmode;
964   rl_key_sequence_length = sp->kseqlen;
965   rl_instream = sp->inf;
966   rl_outstream = sp->outf;
967   rl_pending_input = sp->pendingin;
968   rl_executing_macro = sp->macro;
969 
970   rl_catch_signals = sp->catchsigs;
971   rl_catch_sigwinch = sp->catchsigwinch;
972 
973   return (0);
974 }
975