OpenCoverageBash

Bash patch #26 - Test report of the modifications

Overview

Test Execution StatusStatistics
Passed
  0.000% (0/1)
Failed
  0.000% (0/1)
Requires Manual Checking
  0.000% (0/1)
Unknown
100.000% (1/1)
All
100.000% (1/1)
CategoryRemoved LinesInserted LinesTotal
Modified lines executed:
  0.068% (3/4416)
  0.000% (0/4452)
  0.034% (3/8868)
Modified lines not executed:
  0.000% (0/4416)
  0.000% (0/4452)
  0.000% (0/8868)
Source code lines not covered:
 99.932% (4413/4416)
100.000% (4452/4452)
 99.966% (8865/8868)

List of tests executing the changes

Execution NameState
Self testUnknown

Patch File

Showing: 

Modified File: doc/bash.0

LineTestsDifference Output
diff --git a/doc/bash.0 b/doc/bash.0
index 3542cb61..8a3d8177 100644
--- a/doc/bash.0
+++ b/doc/bash.0
@@ -2595,43 +2595,44 @@ CCOOMMMMAANNDD EEXXEECCUUTTIIOONN
2595 performed only if the command is not found in the hash table. If the
2596 search is unsuccessful, the shell searches for a defined shell function
2597 named ccoommmmaanndd__nnoott__ffoouunndd__hhaannddllee. If that function exists, it is invoked
2598
-
No equivalent source code line in the reference code can be identified.
- with the original command and the original command's arguments as its
2599
-
No equivalent source code line in the reference code can be identified.
- arguments, and the function's exit status becomes the exit status of
2600
-
No equivalent source code line in the reference code can be identified.
- the shell. If that function is not defined, the shell prints an error
2601
-
No equivalent source code line in the reference code can be identified.
- message and returns an exit status of 127.
2598
-
+ in a separate execution environment with the original command and the
2599
-
+ original command's arguments as its arguments, and the function's exit
2600
-
+ status becomes the exit status of that subshell. If that function is
2601
-
+ not defined, the shell prints an error message and returns an exit sta-
2602
-
+ tus of 127.
2602 ➡ 2603
2603
-
No equivalent source code line in the reference code can be identified.
- If the search is successful, or if the command name contains one or
2604
-
+ If the search is successful, or if the command name contains one or
2604 ➡ 2605 more slashes, the shell executes the named program in a separate execu-
2605 ➡ 2606 tion environment. Argument 0 is set to the name given, and the remain-
2606 ➡ 2607 ing arguments to the command are set to the arguments given, if any.
2607 ➡ 2608
2608
-
No equivalent source code line in the reference code can be identified.
- If this execution fails because the file is not in executable format,
2609
-
No equivalent source code line in the reference code can be identified.
- and the file is not a directory, it is assumed to be a _s_h_e_l_l _s_c_r_i_p_t, a
2610
-
No equivalent source code line in the reference code can be identified.
- file containing shell commands. A subshell is spawned to execute it.
2611
-
No equivalent source code line in the reference code can be identified.
- This subshell reinitializes itself, so that the effect is as if a new
2612
-
No equivalent source code line in the reference code can be identified.
- shell had been invoked to handle the script, with the exception that
2613
-
No equivalent source code line in the reference code can be identified.
- the locations of commands remembered by the parent (see hhaasshh below
2609
-
+ If this execution fails because the file is not in executable format,
2610
-
+ and the file is not a directory, it is assumed to be a _s_h_e_l_l _s_c_r_i_p_t, a
2611
-
+ file containing shell commands. A subshell is spawned to execute it.
2612
-
+ This subshell reinitializes itself, so that the effect is as if a new
2613
-
+ shell had been invoked to handle the script, with the exception that
2614
-
+ the locations of commands remembered by the parent (see hhaasshh below
2614 ➡ 2615 under SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS) are retained by the child.
2615 ➡ 2616
2616
-
No equivalent source code line in the reference code can be identified.
- If the program is a file beginning with ##!!, the remainder of the first
2617
-
No equivalent source code line in the reference code can be identified.
- line specifies an interpreter for the program. The shell executes the
2617
-
+ If the program is a file beginning with ##!!, the remainder of the first
2618
-
+ line specifies an interpreter for the program. The shell executes the
2618 ➡ 2619 specified interpreter on operating systems that do not handle this exe-
2619 ➡ 2620 cutable format themselves. The arguments to the interpreter consist of
2620
-
No equivalent source code line in the reference code can be identified.
- a single optional argument following the interpreter name on the first
2621
-
No equivalent source code line in the reference code can be identified.
- line of the program, followed by the name of the program, followed by
2621
-
+ a single optional argument following the interpreter name on the first
2622
-
+ line of the program, followed by the name of the program, followed by
2622 ➡ 2623 the command arguments, if any.
2623 ➡ 2624
2624 ➡ 2625 CCOOMMMMAANNDD EEXXEECCUUTTIIOONN EENNVVIIRROONNMMEENNTT
2625
-
No equivalent source code line in the reference code can be identified.
- The shell has an _e_x_e_c_u_t_i_o_n _e_n_v_i_r_o_n_m_e_n_t, which consists of the follow-
2626
-
+ The shell has an _e_x_e_c_u_t_i_o_n _e_n_v_i_r_o_n_m_e_n_t, which consists of the follow-
2626 ➡ 2627 ing:
2627 ➡ 2628
2628
-
No equivalent source code line in the reference code can be identified.
- +o open files inherited by the shell at invocation, as modified by
2629
-
+ +o open files inherited by the shell at invocation, as modified by
2629 ➡ 2630 redirections supplied to the eexxeecc builtin
2630 ➡ 2631
2631
-
No equivalent source code line in the reference code can be identified.
- +o the current working directory as set by ccdd, ppuusshhdd, or ppooppdd, or
2632
-
+ +o the current working directory as set by ccdd, ppuusshhdd, or ppooppdd, or
2632 ➡ 2633 inherited by the shell at invocation
2633 ➡ 2634
2634
-
No equivalent source code line in the reference code can be identified.
- +o the file creation mode mask as set by uummaasskk or inherited from
2635
-
+ +o the file creation mode mask as set by uummaasskk or inherited from
2635 ➡ 2636 the shell's parent
2636 ➡ 2637
2637 ➡ 2638 +o current traps set by ttrraapp
@@ -2639,251 +2640,251 @@ CCOOMMMMAANNDD EEXXEECCUUTTIIOONN EENNVVIIRROONNMMEENN
2639 ➡ 2640 +o shell parameters that are set by variable assignment or with sseett
2640 ➡ 2641 or inherited from the shell's parent in the environment
2641 ➡ 2642
2642
-
No equivalent source code line in the reference code can be identified.
- +o shell functions defined during execution or inherited from the
2643
-
+ +o shell functions defined during execution or inherited from the
2643 ➡ 2644 shell's parent in the environment
2644 ➡ 2645
2645
-
No equivalent source code line in the reference code can be identified.
- +o options enabled at invocation (either by default or with com-
2646
-
+ +o options enabled at invocation (either by default or with com-
2646 ➡ 2647 mand-line arguments) or by sseett
2647 ➡ 2648
2648 ➡ 2649 +o options enabled by sshhoopptt
2649 ➡ 2650
2650 ➡ 2651 +o shell aliases defined with aalliiaass
2651 ➡ 2652
2652
-
No equivalent source code line in the reference code can be identified.
- +o various process IDs, including those of background jobs, the
2653
-
+ +o various process IDs, including those of background jobs, the
2653 ➡ 2654 value of $$$$, and the value of PPPPIIDD
2654 ➡ 2655
2655
-
No equivalent source code line in the reference code can be identified.
- When a simple command other than a builtin or shell function is to be
2656
-
No equivalent source code line in the reference code can be identified.
- executed, it is invoked in a separate execution environment that con-
2657
-
No equivalent source code line in the reference code can be identified.
- sists of the following. Unless otherwise noted, the values are inher-
2656
-
+ When a simple command other than a builtin or shell function is to be
2657
-
+ executed, it is invoked in a separate execution environment that con-
2658
-
+ sists of the following. Unless otherwise noted, the values are inher-
2658 ➡ 2659 ited from the shell.
2659 ➡ 2660
2660 ➡ 2661
2661
-
No equivalent source code line in the reference code can be identified.
- +o the shell's open files, plus any modifications and additions
2662
-
+ +o the shell's open files, plus any modifications and additions
2662 ➡ 2663 specified by redirections to the command
2663 ➡ 2664
2664 ➡ 2665 +o the current working directory
2665 ➡ 2666
2666 ➡ 2667 +o the file creation mode mask
2667 ➡ 2668
2668
-
No equivalent source code line in the reference code can be identified.
- +o shell variables and functions marked for export, along with
2669
-
+ +o shell variables and functions marked for export, along with
2669 ➡ 2670 variables exported for the command, passed in the environment
2670 ➡ 2671
2671 ➡ 2672 +o traps caught by the shell are reset to the values inherited from
2672 ➡ 2673 the shell's parent, and traps ignored by the shell are ignored
2673 ➡ 2674
2674
-
No equivalent source code line in the reference code can be identified.
- A command invoked in this separate environment cannot affect the
2675
-
+ A command invoked in this separate environment cannot affect the
2675 ➡ 2676 shell's execution environment.
2676 ➡ 2677
2677
-
No equivalent source code line in the reference code can be identified.
- Command substitution, commands grouped with parentheses, and asynchro-
2678
-
+ Command substitution, commands grouped with parentheses, and asynchro-
2678 ➡ 2679 nous commands are invoked in a subshell environment that is a duplicate
2679
-
No equivalent source code line in the reference code can be identified.
- of the shell environment, except that traps caught by the shell are
2680
-
+ of the shell environment, except that traps caught by the shell are
2680 ➡ 2681 reset to the values that the shell inherited from its parent at invoca-
2681 ➡ 2682 tion. Builtin commands that are invoked as part of a pipeline are also
2682 ➡ 2683 executed in a subshell environment. Changes made to the subshell envi-
2683 ➡ 2684 ronment cannot affect the shell's execution environment.
2684 ➡ 2685
2685 ➡ 2686 Subshells spawned to execute command substitutions inherit the value of
2686
-
No equivalent source code line in the reference code can be identified.
- the --ee option from the parent shell. When not in _p_o_s_i_x mode, bbaasshh
2687
-
+ the --ee option from the parent shell. When not in _p_o_s_i_x mode, bbaasshh
2687 ➡ 2688 clears the --ee option in such subshells.
2688 ➡ 2689
2689
-
No equivalent source code line in the reference code can be identified.
- If a command is followed by a && and job control is not active, the
2690
-
No equivalent source code line in the reference code can be identified.
- default standard input for the command is the empty file _/_d_e_v_/_n_u_l_l.
2691
-
No equivalent source code line in the reference code can be identified.
- Otherwise, the invoked command inherits the file descriptors of the
2690
-
+ If a command is followed by a && and job control is not active, the
2691
-
+ default standard input for the command is the empty file _/_d_e_v_/_n_u_l_l.
2692
-
+ Otherwise, the invoked command inherits the file descriptors of the
2692 ➡ 2693 calling shell as modified by redirections.
2693 ➡ 2694
2694 ➡ 2695 EENNVVIIRROONNMMEENNTT
2695
-
No equivalent source code line in the reference code can be identified.
- When a program is invoked it is given an array of strings called the
2696
-
+ When a program is invoked it is given an array of strings called the
2696 ➡ 2697 _e_n_v_i_r_o_n_m_e_n_t. This is a list of _n_a_m_e-_v_a_l_u_e pairs, of the form
2697 ➡ 2698 _n_a_m_e=_v_a_l_u_e.
2698 ➡ 2699
2699
-
No equivalent source code line in the reference code can be identified.
- The shell provides several ways to manipulate the environment. On
2700
-
+ The shell provides several ways to manipulate the environment. On
2700 ➡ 2701 invocation, the shell scans its own environment and creates a parameter
2701
-
No equivalent source code line in the reference code can be identified.
- for each name found, automatically marking it for _e_x_p_o_r_t to child pro-
2702
-
No equivalent source code line in the reference code can be identified.
- cesses. Executed commands inherit the environment. The eexxppoorrtt and
2703
-
No equivalent source code line in the reference code can be identified.
- ddeeccllaarree --xx commands allow parameters and functions to be added to and
2702
-
+ for each name found, automatically marking it for _e_x_p_o_r_t to child pro-
2703
-
+ cesses. Executed commands inherit the environment. The eexxppoorrtt and
2704
-
+ ddeeccllaarree --xx commands allow parameters and functions to be added to and
2704 ➡ 2705 deleted from the environment. If the value of a parameter in the envi-
2705
-
No equivalent source code line in the reference code can be identified.
- ronment is modified, the new value becomes part of the environment,
2706
-
No equivalent source code line in the reference code can be identified.
- replacing the old. The environment inherited by any executed command
2707
-
No equivalent source code line in the reference code can be identified.
- consists of the shell's initial environment, whose values may be modi-
2708
-
No equivalent source code line in the reference code can be identified.
- fied in the shell, less any pairs removed by the uunnsseett command, plus
2706
-
+ ronment is modified, the new value becomes part of the environment,
2707
-
+ replacing the old. The environment inherited by any executed command
2708
-
+ consists of the shell's initial environment, whose values may be modi-
2709
-
+ fied in the shell, less any pairs removed by the uunnsseett command, plus
2709 ➡ 2710 any additions via the eexxppoorrtt and ddeeccllaarree --xx commands.
2710 ➡ 2711
2711
-
No equivalent source code line in the reference code can be identified.
- The environment for any _s_i_m_p_l_e _c_o_m_m_a_n_d or function may be augmented
2712
-
No equivalent source code line in the reference code can be identified.
- temporarily by prefixing it with parameter assignments, as described
2712
-
+ The environment for any _s_i_m_p_l_e _c_o_m_m_a_n_d or function may be augmented
2713
-
+ temporarily by prefixing it with parameter assignments, as described
2713 ➡ 2714 above in PPAARRAAMMEETTEERRSS. These assignment statements affect only the envi-
2714 ➡ 2715 ronment seen by that command.
2715 ➡ 2716
2716
-
No equivalent source code line in the reference code can be identified.
- If the --kk option is set (see the sseett builtin command below), then _a_l_l
2717
-
No equivalent source code line in the reference code can be identified.
- parameter assignments are placed in the environment for a command, not
2717
-
+ If the --kk option is set (see the sseett builtin command below), then _a_l_l
2718
-
+ parameter assignments are placed in the environment for a command, not
2718 ➡ 2719 just those that precede the command name.
2719 ➡ 2720
2720
-
No equivalent source code line in the reference code can be identified.
- When bbaasshh invokes an external command, the variable __ is set to the
2721
-
+ When bbaasshh invokes an external command, the variable __ is set to the
2721 ➡ 2722 full filename of the command and passed to that command in its environ-
2722 ➡ 2723 ment.
2723 ➡ 2724
2724 ➡ 2725 EEXXIITT SSTTAATTUUSS
2725
-
No equivalent source code line in the reference code can be identified.
- The exit status of an executed command is the value returned by the
2726
-
+ The exit status of an executed command is the value returned by the
2726 ➡ 2727 _w_a_i_t_p_i_d system call or equivalent function. Exit statuses fall between
2727
-
No equivalent source code line in the reference code can be identified.
- 0 and 255, though, as explained below, the shell may use values above
2728
-
+ 0 and 255, though, as explained below, the shell may use values above
2728 ➡ 2729 125 specially. Exit statuses from shell builtins and compound commands
2729 ➡ 2730 are also limited to this range. Under certain circumstances, the shell
2730 ➡ 2731 will use special values to indicate specific failure modes.
2731 ➡ 2732
2732 ➡ 2733 For the shell's purposes, a command which exits with a zero exit status
2733
-
No equivalent source code line in the reference code can be identified.
- has succeeded. An exit status of zero indicates success. A non-zero
2734
-
No equivalent source code line in the reference code can be identified.
- exit status indicates failure. When a command terminates on a fatal
2734
-
+ has succeeded. An exit status of zero indicates success. A non-zero
2735
-
+ exit status indicates failure. When a command terminates on a fatal
2735 ➡ 2736 signal _N, bbaasshh uses the value of 128+_N as the exit status.
2736 ➡ 2737
2737
-
No equivalent source code line in the reference code can be identified.
- If a command is not found, the child process created to execute it
2738
-
No equivalent source code line in the reference code can be identified.
- returns a status of 127. If a command is found but is not executable,
2738
-
+ If a command is not found, the child process created to execute it
2739
-
+ returns a status of 127. If a command is found but is not executable,
2739 ➡ 2740 the return status is 126.
2740 ➡ 2741
2741 ➡ 2742 If a command fails because of an error during expansion or redirection,
2742 ➡ 2743 the exit status is greater than zero.
2743 ➡ 2744
2744
-
No equivalent source code line in the reference code can be identified.
- Shell builtin commands return a status of 0 (_t_r_u_e) if successful, and
2745
-
No equivalent source code line in the reference code can be identified.
- non-zero (_f_a_l_s_e) if an error occurs while they execute. All builtins
2746
-
No equivalent source code line in the reference code can be identified.
- return an exit status of 2 to indicate incorrect usage, generally
2745
-
+ Shell builtin commands return a status of 0 (_t_r_u_e) if successful, and
2746
-
+ non-zero (_f_a_l_s_e) if an error occurs while they execute. All builtins
2747
-
+ return an exit status of 2 to indicate incorrect usage, generally
2747 ➡ 2748 invalid options or missing arguments.
2748 ➡ 2749
2749
-
No equivalent source code line in the reference code can be identified.
- BBaasshh itself returns the exit status of the last command executed,
2750
-
No equivalent source code line in the reference code can be identified.
- unless a syntax error occurs, in which case it exits with a non-zero
2750
-
+ BBaasshh itself returns the exit status of the last command executed,
2751
-
+ unless a syntax error occurs, in which case it exits with a non-zero
2751 ➡ 2752 value. See also the eexxiitt builtin command below.
2752 ➡ 2753
2753 ➡ 2754 SSIIGGNNAALLSS
2754
-
No equivalent source code line in the reference code can be identified.
- When bbaasshh is interactive, in the absence of any traps, it ignores
2755
-
+ When bbaasshh is interactive, in the absence of any traps, it ignores
2755 ➡ 2756 SSIIGGTTEERRMM (so that kkiillll 00 does not kill an interactive shell), and SSIIGGIINNTT
2756
-
No equivalent source code line in the reference code can be identified.
- is caught and handled (so that the wwaaiitt builtin is interruptible). In
2757
-
No equivalent source code line in the reference code can be identified.
- all cases, bbaasshh ignores SSIIGGQQUUIITT. If job control is in effect, bbaasshh
2757
-
+ is caught and handled (so that the wwaaiitt builtin is interruptible). In
2758
-
+ all cases, bbaasshh ignores SSIIGGQQUUIITT. If job control is in effect, bbaasshh
2758 ➡ 2759 ignores SSIIGGTTTTIINN, SSIIGGTTTTOOUU, and SSIIGGTTSSTTPP.
2759 ➡ 2760
2760 ➡ 2761 Non-builtin commands run by bbaasshh have signal handlers set to the values
2761
-
No equivalent source code line in the reference code can be identified.
- inherited by the shell from its parent. When job control is not in
2762
-
No equivalent source code line in the reference code can be identified.
- effect, asynchronous commands ignore SSIIGGIINNTT and SSIIGGQQUUIITT in addition to
2763
-
No equivalent source code line in the reference code can be identified.
- these inherited handlers. Commands run as a result of command substi-
2762
-
+ inherited by the shell from its parent. When job control is not in
2763
-
+ effect, asynchronous commands ignore SSIIGGIINNTT and SSIIGGQQUUIITT in addition to
2764
-
+ these inherited handlers. Commands run as a result of command substi-
2764 ➡ 2765 tution ignore the keyboard-generated job control signals SSIIGGTTTTIINN, SSIIGGTT--
2765 ➡ 2766 TTOOUU, and SSIIGGTTSSTTPP.
2766 ➡ 2767
2767
-
No equivalent source code line in the reference code can be identified.
- The shell exits by default upon receipt of a SSIIGGHHUUPP. Before exiting,
2768
-
No equivalent source code line in the reference code can be identified.
- an interactive shell resends the SSIIGGHHUUPP to all jobs, running or
2768
-
+ The shell exits by default upon receipt of a SSIIGGHHUUPP. Before exiting,
2769
-
+ an interactive shell resends the SSIIGGHHUUPP to all jobs, running or
2769 ➡ 2770 stopped. Stopped jobs are sent SSIIGGCCOONNTT to ensure that they receive the
2770
-
No equivalent source code line in the reference code can be identified.
- SSIIGGHHUUPP. To prevent the shell from sending the signal to a particular
2771
-
No equivalent source code line in the reference code can be identified.
- job, it should be removed from the jobs table with the ddiissoowwnn builtin
2772
-
No equivalent source code line in the reference code can be identified.
- (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below) or marked to not receive SSIIGGHHUUPP
2771
-
+ SSIIGGHHUUPP. To prevent the shell from sending the signal to a particular
2772
-
+ job, it should be removed from the jobs table with the ddiissoowwnn builtin
2773
-
+ (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below) or marked to not receive SSIIGGHHUUPP
2773 ➡ 2774 using ddiissoowwnn --hh.
2774 ➡ 2775
2775
-
No equivalent source code line in the reference code can be identified.
- If the hhuuppoonneexxiitt shell option has been set with sshhoopptt, bbaasshh sends a
2776
-
+ If the hhuuppoonneexxiitt shell option has been set with sshhoopptt, bbaasshh sends a
2776 ➡ 2777 SSIIGGHHUUPP to all jobs when an interactive login shell exits.
2777 ➡ 2778
2778
-
No equivalent source code line in the reference code can be identified.
- If bbaasshh is waiting for a command to complete and receives a signal for
2779
-
+ If bbaasshh is waiting for a command to complete and receives a signal for
2779 ➡ 2780 which a trap has been set, the trap will not be executed until the com-
2780
-
No equivalent source code line in the reference code can be identified.
- mand completes. When bbaasshh is waiting for an asynchronous command via
2781
-
No equivalent source code line in the reference code can be identified.
- the wwaaiitt builtin, the reception of a signal for which a trap has been
2781
-
+ mand completes. When bbaasshh is waiting for an asynchronous command via
2782
-
+ the wwaaiitt builtin, the reception of a signal for which a trap has been
2782 ➡ 2783 set will cause the wwaaiitt builtin to return immediately with an exit sta-
2783 ➡ 2784 tus greater than 128, immediately after which the trap is executed.
2784 ➡ 2785
2785 ➡ 2786 JJOOBB CCOONNTTRROOLL
2786
-
No equivalent source code line in the reference code can be identified.
- _J_o_b _c_o_n_t_r_o_l refers to the ability to selectively stop (_s_u_s_p_e_n_d) the
2787
-
+ _J_o_b _c_o_n_t_r_o_l refers to the ability to selectively stop (_s_u_s_p_e_n_d) the
2787 ➡ 2788 execution of processes and continue (_r_e_s_u_m_e) their execution at a later
2788
-
No equivalent source code line in the reference code can be identified.
- point. A user typically employs this facility via an interactive
2789
-
No equivalent source code line in the reference code can be identified.
- interface supplied jointly by the operating system kernel's terminal
2789
-
+ point. A user typically employs this facility via an interactive
2790
-
+ interface supplied jointly by the operating system kernel's terminal
2790 ➡ 2791 driver and bbaasshh.
2791 ➡ 2792
2792
-
No equivalent source code line in the reference code can be identified.
- The shell associates a _j_o_b with each pipeline. It keeps a table of
2793
-
No equivalent source code line in the reference code can be identified.
- currently executing jobs, which may be listed with the jjoobbss command.
2794
-
No equivalent source code line in the reference code can be identified.
- When bbaasshh starts a job asynchronously (in the _b_a_c_k_g_r_o_u_n_d), it prints a
2793
-
+ The shell associates a _j_o_b with each pipeline. It keeps a table of
2794
-
+ currently executing jobs, which may be listed with the jjoobbss command.
2795
-
+ When bbaasshh starts a job asynchronously (in the _b_a_c_k_g_r_o_u_n_d), it prints a
2795 ➡ 2796 line that looks like:
2796 ➡ 2797
2797 ➡ 2798 [1] 25647
2798 ➡ 2799
2799 ➡ 2800 indicating that this job is job number 1 and that the process ID of the
2800 ➡ 2801 last process in the pipeline associated with this job is 25647. All of
2801
-
No equivalent source code line in the reference code can be identified.
- the processes in a single pipeline are members of the same job. BBaasshh
2802
-
+ the processes in a single pipeline are members of the same job. BBaasshh
2802 ➡ 2803 uses the _j_o_b abstraction as the basis for job control.
2803 ➡ 2804
2804
-
No equivalent source code line in the reference code can be identified.
- To facilitate the implementation of the user interface to job control,
2805
-
+ To facilitate the implementation of the user interface to job control,
2805 ➡ 2806 the operating system maintains the notion of a _c_u_r_r_e_n_t _t_e_r_m_i_n_a_l _p_r_o_c_e_s_s
2806 ➡ 2807 _g_r_o_u_p _I_D. Members of this process group (processes whose process group
2807 ➡ 2808 ID is equal to the current terminal process group ID) receive keyboard-
2808
-
No equivalent source code line in the reference code can be identified.
- generated signals such as SSIIGGIINNTT. These processes are said to be in
2809
-
No equivalent source code line in the reference code can be identified.
- the _f_o_r_e_g_r_o_u_n_d. _B_a_c_k_g_r_o_u_n_d processes are those whose process group ID
2809
-
+ generated signals such as SSIIGGIINNTT. These processes are said to be in
2810
-
+ the _f_o_r_e_g_r_o_u_n_d. _B_a_c_k_g_r_o_u_n_d processes are those whose process group ID
2810 ➡ 2811 differs from the terminal's; such processes are immune to keyboard-gen-
2811 ➡ 2812 erated signals. Only foreground processes are allowed to read from or,
2812
-
No equivalent source code line in the reference code can be identified.
- if the user so specifies with stty tostop, write to the terminal.
2813
-
No equivalent source code line in the reference code can be identified.
- Background processes which attempt to read from (write to when stty
2814
-
No equivalent source code line in the reference code can be identified.
- tostop is in effect) the terminal are sent a SSIIGGTTTTIINN ((SSIIGGTTTTOOUU)) signal
2815
-
No equivalent source code line in the reference code can be identified.
- by the kernel's terminal driver, which, unless caught, suspends the
2813
-
+ if the user so specifies with stty tostop, write to the terminal.
2814
-
+ Background processes which attempt to read from (write to when stty
2815
-
+ tostop is in effect) the terminal are sent a SSIIGGTTTTIINN ((SSIIGGTTTTOOUU)) signal
2816
-
+ by the kernel's terminal driver, which, unless caught, suspends the
2816 ➡ 2817 process.
2817 ➡ 2818
2818
-
No equivalent source code line in the reference code can be identified.
- If the operating system on which bbaasshh is running supports job control,
2819
-
+ If the operating system on which bbaasshh is running supports job control,
2819 ➡ 2820 bbaasshh contains facilities to use it. Typing the _s_u_s_p_e_n_d character (typ-
2820 ➡ 2821 ically ^^ZZ, Control-Z) while a process is running causes that process to
2821
-
No equivalent source code line in the reference code can be identified.
- be stopped and returns control to bbaasshh. Typing the _d_e_l_a_y_e_d _s_u_s_p_e_n_d
2822
-
No equivalent source code line in the reference code can be identified.
- character (typically ^^YY, Control-Y) causes the process to be stopped
2823
-
No equivalent source code line in the reference code can be identified.
- when it attempts to read input from the terminal, and control to be
2824
-
No equivalent source code line in the reference code can be identified.
- returned to bbaasshh. The user may then manipulate the state of this job,
2825
-
No equivalent source code line in the reference code can be identified.
- using the bbgg command to continue it in the background, the ffgg command
2822
-
+ be stopped and returns control to bbaasshh. Typing the _d_e_l_a_y_e_d _s_u_s_p_e_n_d
2823
-
+ character (typically ^^YY, Control-Y) causes the process to be stopped
2824
-
+ when it attempts to read input from the terminal, and control to be
2825
-
+ returned to bbaasshh. The user may then manipulate the state of this job,
2826
-
+ using the bbgg command to continue it in the background, the ffgg command
2826 ➡ 2827 to continue it in the foreground, or the kkiillll command to kill it. A ^^ZZ
2827 ➡ 2828 takes effect immediately, and has the additional side effect of causing
2828 ➡ 2829 pending output and typeahead to be discarded.
2829 ➡ 2830
2830 ➡ 2831 There are a number of ways to refer to a job in the shell. The charac-
2831
-
No equivalent source code line in the reference code can be identified.
- ter %% introduces a job specification (_j_o_b_s_p_e_c). Job number _n may be
2832
-
+ ter %% introduces a job specification (_j_o_b_s_p_e_c). Job number _n may be
2832 ➡ 2833 referred to as %%nn. A job may also be referred to using a prefix of the
2833 ➡ 2834 name used to start it, or using a substring that appears in its command
2834
-
No equivalent source code line in the reference code can be identified.
- line. For example, %%ccee refers to a stopped ccee job. If a prefix
2835
-
No equivalent source code line in the reference code can be identified.
- matches more than one job, bbaasshh reports an error. Using %%??ccee, on the
2836
-
No equivalent source code line in the reference code can be identified.
- other hand, refers to any job containing the string ccee in its command
2837
-
No equivalent source code line in the reference code can be identified.
- line. If the substring matches more than one job, bbaasshh reports an
2838
-
No equivalent source code line in the reference code can be identified.
- error. The symbols %%%% and %%++ refer to the shell's notion of the _c_u_r_-
2839
-
No equivalent source code line in the reference code can be identified.
- _r_e_n_t _j_o_b, which is the last job stopped while it was in the foreground
2835
-
+ line. For example, %%ccee refers to a stopped ccee job. If a prefix
2836
-
+ matches more than one job, bbaasshh reports an error. Using %%??ccee, on the
2837
-
+ other hand, refers to any job containing the string ccee in its command
2838
-
+ line. If the substring matches more than one job, bbaasshh reports an
2839
-
+ error. The symbols %%%% and %%++ refer to the shell's notion of the _c_u_r_-
2840
-
+ _r_e_n_t _j_o_b, which is the last job stopped while it was in the foreground
2840 ➡ 2841 or started in the background. The _p_r_e_v_i_o_u_s _j_o_b may be referenced using
2841 ➡ 2842 %%--. If there is only a single job, %%++ and %%-- can both be used to refer
2842
-
No equivalent source code line in the reference code can be identified.
- to that job. In output pertaining to jobs (e.g., the output of the
2843
-
+ to that job. In output pertaining to jobs (e.g., the output of the
2843 ➡ 2844 jjoobbss command), the current job is always flagged with a ++, and the pre-
2844
-
No equivalent source code line in the reference code can be identified.
- vious job with a --. A single % (with no accompanying job specifica-
2845
-
+ vious job with a --. A single % (with no accompanying job specifica-
2845 ➡ 2846 tion) also refers to the current job.
2846 ➡ 2847
2847
-
No equivalent source code line in the reference code can be identified.
- Simply naming a job can be used to bring it into the foreground: %%11 is
2848
-
No equivalent source code line in the reference code can be identified.
- a synonym for ````ffgg %%11'''', bringing job 1 from the background into the
2849
-
No equivalent source code line in the reference code can be identified.
- foreground. Similarly, ````%%11 &&'''' resumes job 1 in the background,
2848
-
+ Simply naming a job can be used to bring it into the foreground: %%11 is
2849
-
+ a synonym for ````ffgg %%11'''', bringing job 1 from the background into the
2850
-
+ foreground. Similarly, ````%%11 &&'''' resumes job 1 in the background,
2850 ➡ 2851 equivalent to ````bbgg %%11''''.
2851 ➡ 2852
2852
-
No equivalent source code line in the reference code can be identified.
- The shell learns immediately whenever a job changes state. Normally,
2853
-
+ The shell learns immediately whenever a job changes state. Normally,
2853 ➡ 2854 bbaasshh waits until it is about to print a prompt before reporting changes
2854
-
No equivalent source code line in the reference code can be identified.
- in a job's status so as to not interrupt any other output. If the --bb
2855
-
+ in a job's status so as to not interrupt any other output. If the --bb
2855 ➡ 2856 option to the sseett builtin command is enabled, bbaasshh reports such changes
2856
-
No equivalent source code line in the reference code can be identified.
- immediately. Any trap on SSIIGGCCHHLLDD is executed for each child that
2857
-
+ immediately. Any trap on SSIIGGCCHHLLDD is executed for each child that
2857 ➡ 2858 exits.
2858 ➡ 2859
2859
-
No equivalent source code line in the reference code can be identified.
- If an attempt to exit bbaasshh is made while jobs are stopped (or, if the
2860
-
No equivalent source code line in the reference code can be identified.
- cchheecckkjjoobbss shell option has been enabled using the sshhoopptt builtin, run-
2860
-
+ If an attempt to exit bbaasshh is made while jobs are stopped (or, if the
2861
-
+ cchheecckkjjoobbss shell option has been enabled using the sshhoopptt builtin, run-
2861 ➡ 2862 ning), the shell prints a warning message, and, if the cchheecckkjjoobbss option
2862
-
No equivalent source code line in the reference code can be identified.
- is enabled, lists the jobs and their statuses. The jjoobbss command may
2863
-
No equivalent source code line in the reference code can be identified.
- then be used to inspect their status. If a second attempt to exit is
2864
-
No equivalent source code line in the reference code can be identified.
- made without an intervening command, the shell does not print another
2863
-
+ is enabled, lists the jobs and their statuses. The jjoobbss command may
2864
-
+ then be used to inspect their status. If a second attempt to exit is
2865
-
+ made without an intervening command, the shell does not print another
2865 ➡ 2866 warning, and any stopped jobs are terminated.
2866 ➡ 2867
2867
-
No equivalent source code line in the reference code can be identified.
- When the shell is waiting for a job or process using the wwaaiitt builtin,
2868
-
No equivalent source code line in the reference code can be identified.
- and job control is enabled, wwaaiitt will return when the job changes
2869
-
No equivalent source code line in the reference code can be identified.
- state. The --ff option will force wwaaiitt to wait until the job or process
2868
-
+ When the shell is waiting for a job or process using the wwaaiitt builtin,
2869
-
+ and job control is enabled, wwaaiitt will return when the job changes
2870
-
+ state. The --ff option will force wwaaiitt to wait until the job or process
2870 ➡ 2871 terminates before returning.
2871 ➡ 2872
2872 ➡ 2873 PPRROOMMPPTTIINNGG
2873 ➡ 2874 When executing interactively, bbaasshh displays the primary prompt PPSS11 when
2874
-
No equivalent source code line in the reference code can be identified.
- it is ready to read a command, and the secondary prompt PPSS22 when it
2875
-
No equivalent source code line in the reference code can be identified.
- needs more input to complete a command. BBaasshh displays PPSS00 after it
2876
-
No equivalent source code line in the reference code can be identified.
- reads a command but before executing it. BBaasshh displays PPSS44 as
2877
-
No equivalent source code line in the reference code can be identified.
- described above before tracing each command when the --xx option is
2878
-
No equivalent source code line in the reference code can be identified.
- enabled. BBaasshh allows these prompt strings to be customized by insert-
2879
-
No equivalent source code line in the reference code can be identified.
- ing a number of backslash-escaped special characters that are decoded
2875
-
+ it is ready to read a command, and the secondary prompt PPSS22 when it
2876
-
+ needs more input to complete a command. BBaasshh displays PPSS00 after it
2877
-
+ reads a command but before executing it. BBaasshh displays PPSS44 as
2878
-
+ described above before tracing each command when the --xx option is
2879
-
+ enabled. BBaasshh allows these prompt strings to be customized by insert-
2880
-
+ ing a number of backslash-escaped special characters that are decoded
2880 ➡ 2881 as follows:
2881 ➡ 2882 \\aa an ASCII bell character (07)
2882
-
No equivalent source code line in the reference code can be identified.
- \\dd the date in "Weekday Month Date" format (e.g., "Tue May
2883
-
+ \\dd the date in "Weekday Month Date" format (e.g., "Tue May
2883 ➡ 2884 26")
2884 ➡ 2885 \\DD{{_f_o_r_m_a_t}}
2885
-
No equivalent source code line in the reference code can be identified.
- the _f_o_r_m_a_t is passed to _s_t_r_f_t_i_m_e(3) and the result is
2886
-
No equivalent source code line in the reference code can be identified.
- inserted into the prompt string; an empty _f_o_r_m_a_t results
2886
-
+ the _f_o_r_m_a_t is passed to _s_t_r_f_t_i_m_e(3) and the result is
2887
-
+ inserted into the prompt string; an empty _f_o_r_m_a_t results
2887 ➡ 2888 in a locale-specific time representation. The braces are
2888 ➡ 2889 required
2889 ➡ 2890 \\ee an ASCII escape character (033)
@@ -2893,7 +2894,7 @@ PPRROOMMPPTTIINNGG
2893 ➡ 2894 \\ll the basename of the shell's terminal device name
2894 ➡ 2895 \\nn newline
2895 ➡ 2896 \\rr carriage return
2896
-
No equivalent source code line in the reference code can be identified.
- \\ss the name of the shell, the basename of $$00 (the portion
2897
-
+ \\ss the name of the shell, the basename of $$00 (the portion
2897 ➡ 2898 following the final slash)
2898 ➡ 2899 \\tt the current time in 24-hour HH:MM:SS format
2899 ➡ 2900 \\TT the current time in 12-hour HH:MM:SS format
@@ -2902,8 +2903,8 @@ PPRROOMMPPTTIINNGG
2902 ➡ 2903 \\uu the username of the current user
2903 ➡ 2904 \\vv the version of bbaasshh (e.g., 2.00)
2904 ➡ 2905 \\VV the release of bbaasshh, version + patch level (e.g., 2.00.0)
2905
-
No equivalent source code line in the reference code can be identified.
- \\ww the current working directory, with $$HHOOMMEE abbreviated
2906
-
No equivalent source code line in the reference code can be identified.
- with a tilde (uses the value of the PPRROOMMPPTT__DDIIRRTTRRIIMM vari-
2906
-
+ \\ww the current working directory, with $$HHOOMMEE abbreviated
2907
-
+ with a tilde (uses the value of the PPRROOMMPPTT__DDIIRRTTRRIIMM vari-
2907 ➡ 2908 able)
2908 ➡ 2909 \\WW the basename of the current working directory, with $$HHOOMMEE
2909 ➡ 2910 abbreviated with a tilde
@@ -2912,66 +2913,66 @@ PPRROOMMPPTTIINNGG
2912 ➡ 2913 \\$$ if the effective UID is 0, a ##, otherwise a $$
2913 ➡ 2914 \\_n_n_n the character corresponding to the octal number _n_n_n
2914 ➡ 2915 \\\\ a backslash
2915
-
No equivalent source code line in the reference code can be identified.
- \\[[ begin a sequence of non-printing characters, which could
2916
-
No equivalent source code line in the reference code can be identified.
- be used to embed a terminal control sequence into the
2916
-
+ \\[[ begin a sequence of non-printing characters, which could
2917
-
+ be used to embed a terminal control sequence into the
2917 ➡ 2918 prompt
2918 ➡ 2919 \\]] end a sequence of non-printing characters
2919 ➡ 2920
2920
-
No equivalent source code line in the reference code can be identified.
- The command number and the history number are usually different: the
2921
-
No equivalent source code line in the reference code can be identified.
- history number of a command is its position in the history list, which
2922
-
No equivalent source code line in the reference code can be identified.
- may include commands restored from the history file (see HHIISSTTOORRYY
2923
-
No equivalent source code line in the reference code can be identified.
- below), while the command number is the position in the sequence of
2924
-
No equivalent source code line in the reference code can be identified.
- commands executed during the current shell session. After the string
2925
-
No equivalent source code line in the reference code can be identified.
- is decoded, it is expanded via parameter expansion, command substitu-
2926
-
No equivalent source code line in the reference code can be identified.
- tion, arithmetic expansion, and quote removal, subject to the value of
2927
-
No equivalent source code line in the reference code can be identified.
- the pprroommppttvvaarrss shell option (see the description of the sshhoopptt command
2921
-
+ The command number and the history number are usually different: the
2922
-
+ history number of a command is its position in the history list, which
2923
-
+ may include commands restored from the history file (see HHIISSTTOORRYY
2924
-
+ below), while the command number is the position in the sequence of
2925
-
+ commands executed during the current shell session. After the string
2926
-
+ is decoded, it is expanded via parameter expansion, command substitu-
2927
-
+ tion, arithmetic expansion, and quote removal, subject to the value of
2928
-
+ the pprroommppttvvaarrss shell option (see the description of the sshhoopptt command
2928 ➡ 2929 under SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below).
2929 ➡ 2930
2930 ➡ 2931 RREEAADDLLIINNEE
2931
-
No equivalent source code line in the reference code can be identified.
- This is the library that handles reading input when using an interac-
2932
-
+ This is the library that handles reading input when using an interac-
2932 ➡ 2933 tive shell, unless the ----nnooeeddiittiinngg option is given at shell invocation.
2933 ➡ 2934 Line editing is also used when using the --ee option to the rreeaadd builtin.
2934 ➡ 2935 By default, the line editing commands are similar to those of Emacs. A
2935 ➡ 2936 vi-style line editing interface is also available. Line editing can be
2936
-
No equivalent source code line in the reference code can be identified.
- enabled at any time using the --oo eemmaaccss or --oo vvii options to the sseett
2937
-
No equivalent source code line in the reference code can be identified.
- builtin (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below). To turn off line editing
2938
-
No equivalent source code line in the reference code can be identified.
- after the shell is running, use the ++oo eemmaaccss or ++oo vvii options to the
2937
-
+ enabled at any time using the --oo eemmaaccss or --oo vvii options to the sseett
2938
-
+ builtin (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below). To turn off line editing
2939
-
+ after the shell is running, use the ++oo eemmaaccss or ++oo vvii options to the
2939 ➡ 2940 sseett builtin.
2940 ➡ 2941
2941 ➡ 2942 RReeaaddlliinnee NNoottaattiioonn
2942 ➡ 2943 In this section, the Emacs-style notation is used to denote keystrokes.
2943
-
No equivalent source code line in the reference code can be identified.
- Control keys are denoted by C-_k_e_y, e.g., C-n means Control-N. Simi-
2944
-
No equivalent source code line in the reference code can be identified.
- larly, _m_e_t_a keys are denoted by M-_k_e_y, so M-x means Meta-X. (On key-
2945
-
No equivalent source code line in the reference code can be identified.
- boards without a _m_e_t_a key, M-_x means ESC _x, i.e., press the Escape key
2944
-
+ Control keys are denoted by C-_k_e_y, e.g., C-n means Control-N. Simi-
2945
-
+ larly, _m_e_t_a keys are denoted by M-_k_e_y, so M-x means Meta-X. (On key-
2946
-
+ boards without a _m_e_t_a key, M-_x means ESC _x, i.e., press the Escape key
2946 ➡ 2947 then the _x key. This makes ESC the _m_e_t_a _p_r_e_f_i_x. The combination M-C-_x
2947
-
No equivalent source code line in the reference code can be identified.
- means ESC-Control-_x, or press the Escape key then hold the Control key
2948
-
+ means ESC-Control-_x, or press the Escape key then hold the Control key
2948 ➡ 2949 while pressing the _x key.)
2949 ➡ 2950
2950 ➡ 2951 Readline commands may be given numeric _a_r_g_u_m_e_n_t_s, which normally act as
2951
-
No equivalent source code line in the reference code can be identified.
- a repeat count. Sometimes, however, it is the sign of the argument
2952
-
No equivalent source code line in the reference code can be identified.
- that is significant. Passing a negative argument to a command that
2953
-
No equivalent source code line in the reference code can be identified.
- acts in the forward direction (e.g., kkiillll--lliinnee) causes that command to
2954
-
No equivalent source code line in the reference code can be identified.
- act in a backward direction. Commands whose behavior with arguments
2952
-
+ a repeat count. Sometimes, however, it is the sign of the argument
2953
-
+ that is significant. Passing a negative argument to a command that
2954
-
+ acts in the forward direction (e.g., kkiillll--lliinnee) causes that command to
2955
-
+ act in a backward direction. Commands whose behavior with arguments
2955 ➡ 2956 deviates from this are noted below.
2956 ➡ 2957
2957
-
No equivalent source code line in the reference code can be identified.
- When a command is described as _k_i_l_l_i_n_g text, the text deleted is saved
2958
-
+ When a command is described as _k_i_l_l_i_n_g text, the text deleted is saved
2958 ➡ 2959 for possible future retrieval (_y_a_n_k_i_n_g). The killed text is saved in a
2959 ➡ 2960 _k_i_l_l _r_i_n_g. Consecutive kills cause the text to be accumulated into one
2960 ➡ 2961 unit, which can be yanked all at once. Commands which do not kill text
2961 ➡ 2962 separate the chunks of text on the kill ring.
2962 ➡ 2963
2963 ➡ 2964 RReeaaddlliinnee IInniittiiaalliizzaattiioonn
2964
-
No equivalent source code line in the reference code can be identified.
- Readline is customized by putting commands in an initialization file
2965
-
No equivalent source code line in the reference code can be identified.
- (the _i_n_p_u_t_r_c file). The name of this file is taken from the value of
2966
-
No equivalent source code line in the reference code can be identified.
- the IINNPPUUTTRRCC variable. If that variable is unset, the default is
2967
-
No equivalent source code line in the reference code can be identified.
- _~_/_._i_n_p_u_t_r_c. When a program which uses the readline library starts up,
2965
-
+ Readline is customized by putting commands in an initialization file
2966
-
+ (the _i_n_p_u_t_r_c file). The name of this file is taken from the value of
2967
-
+ the IINNPPUUTTRRCC variable. If that variable is unset, the default is
2968
-
+ _~_/_._i_n_p_u_t_r_c. When a program which uses the readline library starts up,
2968 ➡ 2969 the initialization file is read, and the key bindings and variables are
2969
-
No equivalent source code line in the reference code can be identified.
- set. There are only a few basic constructs allowed in the readline
2970
-
No equivalent source code line in the reference code can be identified.
- initialization file. Blank lines are ignored. Lines beginning with a
2971
-
No equivalent source code line in the reference code can be identified.
- ## are comments. Lines beginning with a $$ indicate conditional con-
2970
-
+ set. There are only a few basic constructs allowed in the readline
2971
-
+ initialization file. Blank lines are ignored. Lines beginning with a
2972
-
+ ## are comments. Lines beginning with a $$ indicate conditional con-
2972 ➡ 2973 structs. Other lines denote key bindings and variable settings.
2973 ➡ 2974
2974
-
No equivalent source code line in the reference code can be identified.
- The default key-bindings may be changed with an _i_n_p_u_t_r_c file. Other
2975
-
+ The default key-bindings may be changed with an _i_n_p_u_t_r_c file. Other
2975 ➡ 2976 programs that use this library may add their own commands and bindings.
2976 ➡ 2977
2977 ➡ 2978 For example, placing
@@ -2979,18 +2980,18 @@ RREEAADDLLIINNEE
2979 ➡ 2980 M-Control-u: universal-argument
2980 ➡ 2981 or
2981 ➡ 2982 C-Meta-u: universal-argument
2982
-
No equivalent source code line in the reference code can be identified.
- into the _i_n_p_u_t_r_c would make M-C-u execute the readline command _u_n_i_v_e_r_-
2983
-
+ into the _i_n_p_u_t_r_c would make M-C-u execute the readline command _u_n_i_v_e_r_-
2983 ➡ 2984 _s_a_l_-_a_r_g_u_m_e_n_t.
2984 ➡ 2985
2985
-
No equivalent source code line in the reference code can be identified.
- The following symbolic character names are recognized: _R_U_B_O_U_T, _D_E_L,
2986
-
+ The following symbolic character names are recognized: _R_U_B_O_U_T, _D_E_L,
2986 ➡ 2987 _E_S_C, _L_F_D, _N_E_W_L_I_N_E, _R_E_T, _R_E_T_U_R_N, _S_P_C, _S_P_A_C_E, and _T_A_B.
2987 ➡ 2988
2988
-
No equivalent source code line in the reference code can be identified.
- In addition to command names, readline allows keys to be bound to a
2989
-
+ In addition to command names, readline allows keys to be bound to a
2989 ➡ 2990 string that is inserted when the key is pressed (a _m_a_c_r_o).
2990 ➡ 2991
2991 ➡ 2992 RReeaaddlliinnee KKeeyy BBiinnddiinnggss
2992
-
No equivalent source code line in the reference code can be identified.
- The syntax for controlling key bindings in the _i_n_p_u_t_r_c file is simple.
2993
-
No equivalent source code line in the reference code can be identified.
- All that is required is the name of the command or the text of a macro
2993
-
+ The syntax for controlling key bindings in the _i_n_p_u_t_r_c file is simple.
2994
-
+ All that is required is the name of the command or the text of a macro
2994 ➡ 2995 and a key sequence to which it should be bound. The name may be speci-
2995 ➡ 2996 fied in one of two ways: as a symbolic key name, possibly with _M_e_t_a_- or
2996 ➡ 2997 _C_o_n_t_r_o_l_- prefixes, or as a key sequence.
@@ -3002,15 +3003,15 @@ RREEAADDLLIINNEE
3002 ➡ 3003 Meta-Rubout: backward-kill-word
3003 ➡ 3004 Control-o: "> output"
3004 ➡ 3005
3005
-
No equivalent source code line in the reference code can be identified.
- In the above example, _C_-_u is bound to the function uunniivveerrssaall--aarrgguummeenntt,
3006
-
No equivalent source code line in the reference code can be identified.
- _M_-_D_E_L is bound to the function bbaacckkwwaarrdd--kkiillll--wwoorrdd, and _C_-_o is bound to
3007
-
No equivalent source code line in the reference code can be identified.
- run the macro expressed on the right hand side (that is, to insert the
3006
-
+ In the above example, _C_-_u is bound to the function uunniivveerrssaall--aarrgguummeenntt,
3007
-
+ _M_-_D_E_L is bound to the function bbaacckkwwaarrdd--kkiillll--wwoorrdd, and _C_-_o is bound to
3008
-
+ run the macro expressed on the right hand side (that is, to insert the
3008 ➡ 3009 text ``> output'' into the line).
3009 ➡ 3010
3010
-
No equivalent source code line in the reference code can be identified.
- In the second form, ""kkeeyysseeqq"":_f_u_n_c_t_i_o_n_-_n_a_m_e or _m_a_c_r_o, kkeeyysseeqq differs
3011
-
No equivalent source code line in the reference code can be identified.
- from kkeeyynnaammee above in that strings denoting an entire key sequence may
3012
-
No equivalent source code line in the reference code can be identified.
- be specified by placing the sequence within double quotes. Some GNU
3013
-
No equivalent source code line in the reference code can be identified.
- Emacs style key escapes can be used, as in the following example, but
3011
-
+ In the second form, ""kkeeyysseeqq"":_f_u_n_c_t_i_o_n_-_n_a_m_e or _m_a_c_r_o, kkeeyysseeqq differs
3012
-
+ from kkeeyynnaammee above in that strings denoting an entire key sequence may
3013
-
+ be specified by placing the sequence within double quotes. Some GNU
3014
-
+ Emacs style key escapes can be used, as in the following example, but
3014 ➡ 3015 the symbolic character names are not recognized.
3015 ➡ 3016
3016 ➡ 3017 "\C-u": universal-argument
@@ -3018,7 +3019,7 @@ RREEAADDLLIINNEE
3018 ➡ 3019 "\e[11~": "Function Key 1"
3019 ➡ 3020
3020 ➡ 3021 In this example, _C_-_u is again bound to the function uunniivveerrssaall--aarrgguummeenntt.
3021
-
No equivalent source code line in the reference code can be identified.
- _C_-_x _C_-_r is bound to the function rree--rreeaadd--iinniitt--ffiillee, and _E_S_C _[ _1 _1 _~ is
3022
-
+ _C_-_x _C_-_r is bound to the function rree--rreeaadd--iinniitt--ffiillee, and _E_S_C _[ _1 _1 _~ is
3022 ➡ 3023 bound to insert the text ``Function Key 1''.
3023 ➡ 3024
3024 ➡ 3025 The full set of GNU Emacs style escape sequences is
@@ -3029,7 +3030,7 @@ RREEAADDLLIINNEE
3029 ➡ 3030 \\"" literal "
3030 ➡ 3031 \\'' literal '
3031 ➡ 3032
3032
-
No equivalent source code line in the reference code can be identified.
- In addition to the GNU Emacs style escape sequences, a second set of
3033
-
+ In addition to the GNU Emacs style escape sequences, a second set of
3033 ➡ 3034 backslash escapes is available:
3034 ➡ 3035 \\aa alert (bell)
3035 ➡ 3036 \\bb backspace
@@ -3039,20 +3040,20 @@ RREEAADDLLIINNEE
3039 ➡ 3040 \\rr carriage return
3040 ➡ 3041 \\tt horizontal tab
3041 ➡ 3042 \\vv vertical tab
3042
-
No equivalent source code line in the reference code can be identified.
- \\_n_n_n the eight-bit character whose value is the octal value
3043
-
+ \\_n_n_n the eight-bit character whose value is the octal value
3043 ➡ 3044 _n_n_n (one to three digits)
3044
-
No equivalent source code line in the reference code can be identified.
- \\xx_H_H the eight-bit character whose value is the hexadecimal
3045
-
+ \\xx_H_H the eight-bit character whose value is the hexadecimal
3045 ➡ 3046 value _H_H (one or two hex digits)
3046 ➡ 3047
3047 ➡ 3048 When entering the text of a macro, single or double quotes must be used
3048 ➡ 3049 to indicate a macro definition. Unquoted text is assumed to be a func-
3049
-
No equivalent source code line in the reference code can be identified.
- tion name. In the macro body, the backslash escapes described above
3050
-
No equivalent source code line in the reference code can be identified.
- are expanded. Backslash will quote any other character in the macro
3050
-
+ tion name. In the macro body, the backslash escapes described above
3051
-
+ are expanded. Backslash will quote any other character in the macro
3051 ➡ 3052 text, including " and '.
3052 ➡ 3053
3053
-
No equivalent source code line in the reference code can be identified.
- BBaasshh allows the current readline key bindings to be displayed or modi-
3054
-
No equivalent source code line in the reference code can be identified.
- fied with the bbiinndd builtin command. The editing mode may be switched
3055
-
No equivalent source code line in the reference code can be identified.
- during interactive use by using the --oo option to the sseett builtin com-
3054
-
+ BBaasshh allows the current readline key bindings to be displayed or modi-
3055
-
+ fied with the bbiinndd builtin command. The editing mode may be switched
3056
-
+ during interactive use by using the --oo option to the sseett builtin com-
3056 ➡ 3057 mand (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below).
3057 ➡ 3058
3058 ➡ 3059 RReeaaddlliinnee VVaarriiaabblleess
@@ -3062,77 +3063,77 @@ RREEAADDLLIINNEE
3062 ➡ 3063
3063 ➡ 3064 sseett _v_a_r_i_a_b_l_e_-_n_a_m_e _v_a_l_u_e
3064 ➡ 3065
3065
-
No equivalent source code line in the reference code can be identified.
- Except where noted, readline variables can take the values OOnn or OOffff
3066
-
No equivalent source code line in the reference code can be identified.
- (without regard to case). Unrecognized variable names are ignored.
3067
-
No equivalent source code line in the reference code can be identified.
- When a variable value is read, empty or null values, "on" (case-insen-
3066
-
+ Except where noted, readline variables can take the values OOnn or OOffff
3067
-
+ (without regard to case). Unrecognized variable names are ignored.
3068
-
+ When a variable value is read, empty or null values, "on" (case-insen-
3068 ➡ 3069 sitive), and "1" are equivalent to OOnn. All other values are equivalent
3069 ➡ 3070 to OOffff. The variables and their default values are:
3070 ➡ 3071
3071 ➡ 3072 bbeellll--ssttyyllee ((aauuddiibbllee))
3072
-
No equivalent source code line in the reference code can be identified.
- Controls what happens when readline wants to ring the terminal
3073
-
+ Controls what happens when readline wants to ring the terminal
3073 ➡ 3074 bell. If set to nnoonnee, readline never rings the bell. If set to
3074
-
No equivalent source code line in the reference code can be identified.
- vviissiibbllee, readline uses a visible bell if one is available. If
3075
-
+ vviissiibbllee, readline uses a visible bell if one is available. If
3075 ➡ 3076 set to aauuddiibbllee, readline attempts to ring the terminal's bell.
3076 ➡ 3077 bbiinndd--ttttyy--ssppeecciiaall--cchhaarrss ((OOnn))
3077
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, readline attempts to bind the control characters
3078
-
+ If set to OOnn, readline attempts to bind the control characters
3078 ➡ 3079 treated specially by the kernel's terminal driver to their read-
3079 ➡ 3080 line equivalents.
3080 ➡ 3081 bblliinnkk--mmaattcchhiinngg--ppaarreenn ((OOffff))
3081 ➡ 3082 If set to OOnn, readline attempts to briefly move the cursor to an
3082 ➡ 3083 opening parenthesis when a closing parenthesis is inserted.
3083 ➡ 3084 ccoolloorreedd--ccoommpplleettiioonn--pprreeffiixx ((OOffff))
3084
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, when listing completions, readline displays the
3085
-
+ If set to OOnn, when listing completions, readline displays the
3085 ➡ 3086 common prefix of the set of possible completions using a differ-
3086
-
No equivalent source code line in the reference code can be identified.
- ent color. The color definitions are taken from the value of
3087
-
+ ent color. The color definitions are taken from the value of
3087 ➡ 3088 the LLSS__CCOOLLOORRSS environment variable.
3088 ➡ 3089 ccoolloorreedd--ssttaattss ((OOffff))
3089
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, readline displays possible completions using dif-
3090
-
No equivalent source code line in the reference code can be identified.
- ferent colors to indicate their file type. The color defini-
3091
-
No equivalent source code line in the reference code can be identified.
- tions are taken from the value of the LLSS__CCOOLLOORRSS environment
3090
-
+ If set to OOnn, readline displays possible completions using dif-
3091
-
+ ferent colors to indicate their file type. The color defini-
3092
-
+ tions are taken from the value of the LLSS__CCOOLLOORRSS environment
3092 ➡ 3093 variable.
3093 ➡ 3094 ccoommmmeenntt--bbeeggiinn ((````##''''))
3094
-
No equivalent source code line in the reference code can be identified.
- The string that is inserted when the readline iinnsseerrtt--ccoommmmeenntt
3095
-
+ The string that is inserted when the readline iinnsseerrtt--ccoommmmeenntt
3095 ➡ 3096 command is executed. This command is bound to MM--## in emacs mode
3096 ➡ 3097 and to ## in vi command mode.
3097 ➡ 3098 ccoommpplleettiioonn--ddiissppllaayy--wwiiddtthh ((--11))
3098
-
No equivalent source code line in the reference code can be identified.
- The number of screen columns used to display possible matches
3099
-
No equivalent source code line in the reference code can be identified.
- when performing completion. The value is ignored if it is less
3100
-
No equivalent source code line in the reference code can be identified.
- than 0 or greater than the terminal screen width. A value of 0
3101
-
No equivalent source code line in the reference code can be identified.
- will cause matches to be displayed one per line. The default
3099
-
+ The number of screen columns used to display possible matches
3100
-
+ when performing completion. The value is ignored if it is less
3101
-
+ than 0 or greater than the terminal screen width. A value of 0
3102
-
+ will cause matches to be displayed one per line. The default
3102 ➡ 3103 value is -1.
3103 ➡ 3104 ccoommpplleettiioonn--iiggnnoorree--ccaassee ((OOffff))
3104 ➡ 3105 If set to OOnn, readline performs filename matching and completion
3105 ➡ 3106 in a case-insensitive fashion.
3106 ➡ 3107 ccoommpplleettiioonn--mmaapp--ccaassee ((OOffff))
3107
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, and ccoommpplleettiioonn--iiggnnoorree--ccaassee is enabled, readline
3108
-
No equivalent source code line in the reference code can be identified.
- treats hyphens (_-) and underscores (__) as equivalent when per-
3108
-
+ If set to OOnn, and ccoommpplleettiioonn--iiggnnoorree--ccaassee is enabled, readline
3109
-
+ treats hyphens (_-) and underscores (__) as equivalent when per-
3109 ➡ 3110 forming case-insensitive filename matching and completion.
3110 ➡ 3111 ccoommpplleettiioonn--pprreeffiixx--ddiissppllaayy--lleennggtthh ((00))
3111
-
No equivalent source code line in the reference code can be identified.
- The length in characters of the common prefix of a list of pos-
3112
-
No equivalent source code line in the reference code can be identified.
- sible completions that is displayed without modification. When
3113
-
No equivalent source code line in the reference code can be identified.
- set to a value greater than zero, common prefixes longer than
3114
-
No equivalent source code line in the reference code can be identified.
- this value are replaced with an ellipsis when displaying possi-
3112
-
+ The length in characters of the common prefix of a list of pos-
3113
-
+ sible completions that is displayed without modification. When
3114
-
+ set to a value greater than zero, common prefixes longer than
3115
-
+ this value are replaced with an ellipsis when displaying possi-
3115 ➡ 3116 ble completions.
3116 ➡ 3117 ccoommpplleettiioonn--qquueerryy--iitteemmss ((110000))
3117
-
No equivalent source code line in the reference code can be identified.
- This determines when the user is queried about viewing the num-
3118
-
No equivalent source code line in the reference code can be identified.
- ber of possible completions generated by the ppoossssiibbllee--ccoommppllee--
3119
-
No equivalent source code line in the reference code can be identified.
- ttiioonnss command. It may be set to any integer value greater than
3120
-
No equivalent source code line in the reference code can be identified.
- or equal to zero. If the number of possible completions is
3118
-
+ This determines when the user is queried about viewing the num-
3119
-
+ ber of possible completions generated by the ppoossssiibbllee--ccoommppllee--
3120
-
+ ttiioonnss command. It may be set to any integer value greater than
3121
-
+ or equal to zero. If the number of possible completions is
3121 ➡ 3122 greater than or equal to the value of this variable, the user is
3122
-
No equivalent source code line in the reference code can be identified.
- asked whether or not he wishes to view them; otherwise they are
3123
-
+ asked whether or not he wishes to view them; otherwise they are
3123 ➡ 3124 simply listed on the terminal.
3124 ➡ 3125 ccoonnvveerrtt--mmeettaa ((OOnn))
3125
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, readline will convert characters with the eighth
3126
-
+ If set to OOnn, readline will convert characters with the eighth
3126 ➡ 3127 bit set to an ASCII key sequence by stripping the eighth bit and
3127
-
No equivalent source code line in the reference code can be identified.
- prefixing an escape character (in effect, using escape as the
3128
-
No equivalent source code line in the reference code can be identified.
- _m_e_t_a _p_r_e_f_i_x). The default is _O_n, but readline will set it to
3128
-
+ prefixing an escape character (in effect, using escape as the
3129
-
+ _m_e_t_a _p_r_e_f_i_x). The default is _O_n, but readline will set it to
3129 ➡ 3130 _O_f_f if the locale contains eight-bit characters.
3130 ➡ 3131 ddiissaabbllee--ccoommpplleettiioonn ((OOffff))
3131 ➡ 3132 If set to OOnn, readline will inhibit word completion. Completion
3132
-
No equivalent source code line in the reference code can be identified.
- characters will be inserted into the line as if they had been
3133
-
+ characters will be inserted into the line as if they had been
3133 ➡ 3134 mapped to sseellff--iinnsseerrtt.
3134 ➡ 3135 eecchhoo--ccoonnttrrooll--cchhaarraacctteerrss ((OOnn))
3135
-
No equivalent source code line in the reference code can be identified.
- When set to OOnn, on operating systems that indicate they support
3136
-
+ When set to OOnn, on operating systems that indicate they support
3136 ➡ 3137 it, readline echoes a character corresponding to a signal gener-
3137 ➡ 3138 ated from the keyboard.
3138 ➡ 3139 eeddiittiinngg--mmooddee ((eemmaaccss))
@@ -3141,191 +3142,191 @@ RREEAADDLLIINNEE
3141 ➡ 3142 vvii.
3142 ➡ 3143 eemmaaccss--mmooddee--ssttrriinngg ((@@))
3143 ➡ 3144 This string is displayed immediately before the last line of the
3144
-
No equivalent source code line in the reference code can be identified.
- primary prompt when emacs editing mode is active. The value is
3145
-
No equivalent source code line in the reference code can be identified.
- expanded like a key binding, so the standard set of meta- and
3146
-
No equivalent source code line in the reference code can be identified.
- control prefixes and backslash escape sequences is available.
3147
-
No equivalent source code line in the reference code can be identified.
- Use the \1 and \2 escapes to begin and end sequences of non-
3148
-
No equivalent source code line in the reference code can be identified.
- printing characters, which can be used to embed a terminal con-
3145
-
+ primary prompt when emacs editing mode is active. The value is
3146
-
+ expanded like a key binding, so the standard set of meta- and
3147
-
+ control prefixes and backslash escape sequences is available.
3148
-
+ Use the \1 and \2 escapes to begin and end sequences of non-
3149
-
+ printing characters, which can be used to embed a terminal con-
3149 ➡ 3150 trol sequence into the mode string.
3150 ➡ 3151 eennaabbllee--bbrraacckkeetteedd--ppaassttee ((OOffff))
3151
-
No equivalent source code line in the reference code can be identified.
- When set to OOnn, readline will configure the terminal in a way
3152
-
+ When set to OOnn, readline will configure the terminal in a way
3152 ➡ 3153 that will enable it to insert each paste into the editing buffer
3153 ➡ 3154 as a single string of characters, instead of treating each char-
3154
-
No equivalent source code line in the reference code can be identified.
- acter as if it had been read from the keyboard. This can pre-
3155
-
No equivalent source code line in the reference code can be identified.
- vent pasted characters from being interpreted as editing com-
3155
-
+ acter as if it had been read from the keyboard. This can pre-
3156
-
+ vent pasted characters from being interpreted as editing com-
3156 ➡ 3157 mands.
3157 ➡ 3158 eennaabbllee--kkeeyyppaadd ((OOffff))
3158 ➡ 3159 When set to OOnn, readline will try to enable the application key-
3159
-
No equivalent source code line in the reference code can be identified.
- pad when it is called. Some systems need this to enable the
3160
-
+ pad when it is called. Some systems need this to enable the
3160 ➡ 3161 arrow keys.
3161 ➡ 3162 eennaabbllee--mmeettaa--kkeeyy ((OOnn))
3162
-
No equivalent source code line in the reference code can be identified.
- When set to OOnn, readline will try to enable any meta modifier
3163
-
No equivalent source code line in the reference code can be identified.
- key the terminal claims to support when it is called. On many
3163
-
+ When set to OOnn, readline will try to enable any meta modifier
3164
-
+ key the terminal claims to support when it is called. On many
3164 ➡ 3165 terminals, the meta key is used to send eight-bit characters.
3165 ➡ 3166 eexxppaanndd--ttiillddee ((OOffff))
3166
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, tilde expansion is performed when readline
3167
-
+ If set to OOnn, tilde expansion is performed when readline
3167 ➡ 3168 attempts word completion.
3168 ➡ 3169 hhiissttoorryy--pprreesseerrvvee--ppooiinntt ((OOffff))
3169
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, the history code attempts to place point at the
3170
-
No equivalent source code line in the reference code can be identified.
- same location on each history line retrieved with pprreevviioouuss--hhiiss--
3170
-
+ If set to OOnn, the history code attempts to place point at the
3171
-
+ same location on each history line retrieved with pprreevviioouuss--hhiiss--
3171 ➡ 3172 ttoorryy or nneexxtt--hhiissttoorryy.
3172 ➡ 3173 hhiissttoorryy--ssiizzee ((uunnsseett))
3173
-
No equivalent source code line in the reference code can be identified.
- Set the maximum number of history entries saved in the history
3174
-
No equivalent source code line in the reference code can be identified.
- list. If set to zero, any existing history entries are deleted
3174
-
+ Set the maximum number of history entries saved in the history
3175
-
+ list. If set to zero, any existing history entries are deleted
3175 ➡ 3176 and no new entries are saved. If set to a value less than zero,
3176
-
No equivalent source code line in the reference code can be identified.
- the number of history entries is not limited. By default, the
3177
-
No equivalent source code line in the reference code can be identified.
- number of history entries is set to the value of the HHIISSTTSSIIZZEE
3178
-
No equivalent source code line in the reference code can be identified.
- shell variable. If an attempt is made to set _h_i_s_t_o_r_y_-_s_i_z_e to a
3177
-
+ the number of history entries is not limited. By default, the
3178
-
+ number of history entries is set to the value of the HHIISSTTSSIIZZEE
3179
-
+ shell variable. If an attempt is made to set _h_i_s_t_o_r_y_-_s_i_z_e to a
3179 ➡ 3180 non-numeric value, the maximum number of history entries will be
3180 ➡ 3181 set to 500.
3181 ➡ 3182 hhoorriizzoonnttaall--ssccrroollll--mmooddee ((OOffff))
3182
-
No equivalent source code line in the reference code can be identified.
- When set to OOnn, makes readline use a single line for display,
3183
-
+ When set to OOnn, makes readline use a single line for display,
3183 ➡ 3184 scrolling the input horizontally on a single screen line when it
3184
-
No equivalent source code line in the reference code can be identified.
- becomes longer than the screen width rather than wrapping to a
3185
-
+ becomes longer than the screen width rather than wrapping to a
3185 ➡ 3186 new line.
3186 ➡ 3187 iinnppuutt--mmeettaa ((OOffff))
3187
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, readline will enable eight-bit input (that is, it
3188
-
No equivalent source code line in the reference code can be identified.
- will not strip the eighth bit from the characters it reads),
3188
-
+ If set to OOnn, readline will enable eight-bit input (that is, it
3189
-
+ will not strip the eighth bit from the characters it reads),
3189 ➡ 3190 regardless of what the terminal claims it can support. The name
3190
-
No equivalent source code line in the reference code can be identified.
- mmeettaa--ffllaagg is a synonym for this variable. The default is _O_f_f,
3191
-
No equivalent source code line in the reference code can be identified.
- but readline will set it to _O_n if the locale contains eight-bit
3191
-
+ mmeettaa--ffllaagg is a synonym for this variable. The default is _O_f_f,
3192
-
+ but readline will set it to _O_n if the locale contains eight-bit
3192 ➡ 3193 characters.
3193 ➡ 3194 iisseeaarrcchh--tteerrmmiinnaattoorrss ((````CC--[[CC--JJ''''))
3194
-
No equivalent source code line in the reference code can be identified.
- The string of characters that should terminate an incremental
3195
-
No equivalent source code line in the reference code can be identified.
- search without subsequently executing the character as a com-
3196
-
No equivalent source code line in the reference code can be identified.
- mand. If this variable has not been given a value, the charac-
3195
-
+ The string of characters that should terminate an incremental
3196
-
+ search without subsequently executing the character as a com-
3197
-
+ mand. If this variable has not been given a value, the charac-
3197 ➡ 3198 ters _E_S_C and _C_-_J will terminate an incremental search.
3198 ➡ 3199 kkeeyymmaapp ((eemmaaccss))
3199
-
No equivalent source code line in the reference code can be identified.
- Set the current readline keymap. The set of valid keymap names
3200
-
No equivalent source code line in the reference code can be identified.
- is _e_m_a_c_s_, _e_m_a_c_s_-_s_t_a_n_d_a_r_d_, _e_m_a_c_s_-_m_e_t_a_, _e_m_a_c_s_-_c_t_l_x_, _v_i_, _v_i_-_c_o_m_-
3201
-
No equivalent source code line in the reference code can be identified.
- _m_a_n_d, and _v_i_-_i_n_s_e_r_t. _v_i is equivalent to _v_i_-_c_o_m_m_a_n_d; _e_m_a_c_s is
3202
-
No equivalent source code line in the reference code can be identified.
- equivalent to _e_m_a_c_s_-_s_t_a_n_d_a_r_d. The default value is _e_m_a_c_s; the
3200
-
+ Set the current readline keymap. The set of valid keymap names
3201
-
+ is _e_m_a_c_s_, _e_m_a_c_s_-_s_t_a_n_d_a_r_d_, _e_m_a_c_s_-_m_e_t_a_, _e_m_a_c_s_-_c_t_l_x_, _v_i_, _v_i_-_c_o_m_-
3202
-
+ _m_a_n_d, and _v_i_-_i_n_s_e_r_t. _v_i is equivalent to _v_i_-_c_o_m_m_a_n_d; _e_m_a_c_s is
3203
-
+ equivalent to _e_m_a_c_s_-_s_t_a_n_d_a_r_d. The default value is _e_m_a_c_s; the
3203 ➡ 3204 value of eeddiittiinngg--mmooddee also affects the default keymap.
3204 ➡ 3205 kkeeyysseeqq--ttiimmeeoouutt ((550000))
3205
-
No equivalent source code line in the reference code can be identified.
- Specifies the duration _r_e_a_d_l_i_n_e will wait for a character when
3206
-
No equivalent source code line in the reference code can be identified.
- reading an ambiguous key sequence (one that can form a complete
3206
-
+ Specifies the duration _r_e_a_d_l_i_n_e will wait for a character when
3207
-
+ reading an ambiguous key sequence (one that can form a complete
3207 ➡ 3208 key sequence using the input read so far, or can take additional
3208
-
No equivalent source code line in the reference code can be identified.
- input to complete a longer key sequence). If no input is
3209
-
No equivalent source code line in the reference code can be identified.
- received within the timeout, _r_e_a_d_l_i_n_e will use the shorter but
3210
-
No equivalent source code line in the reference code can be identified.
- complete key sequence. The value is specified in milliseconds,
3211
-
No equivalent source code line in the reference code can be identified.
- so a value of 1000 means that _r_e_a_d_l_i_n_e will wait one second for
3212
-
No equivalent source code line in the reference code can be identified.
- additional input. If this variable is set to a value less than
3213
-
No equivalent source code line in the reference code can be identified.
- or equal to zero, or to a non-numeric value, _r_e_a_d_l_i_n_e will wait
3214
-
No equivalent source code line in the reference code can be identified.
- until another key is pressed to decide which key sequence to
3209
-
+ input to complete a longer key sequence). If no input is
3210
-
+ received within the timeout, _r_e_a_d_l_i_n_e will use the shorter but
3211
-
+ complete key sequence. The value is specified in milliseconds,
3212
-
+ so a value of 1000 means that _r_e_a_d_l_i_n_e will wait one second for
3213
-
+ additional input. If this variable is set to a value less than
3214
-
+ or equal to zero, or to a non-numeric value, _r_e_a_d_l_i_n_e will wait
3215
-
+ until another key is pressed to decide which key sequence to
3215 ➡ 3216 complete.
3216 ➡ 3217 mmaarrkk--ddiirreeccttoorriieess ((OOnn))
3217 ➡ 3218 If set to OOnn, completed directory names have a slash appended.
3218 ➡ 3219 mmaarrkk--mmooddiiffiieedd--lliinneess ((OOffff))
3219
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, history lines that have been modified are dis-
3220
-
+ If set to OOnn, history lines that have been modified are dis-
3220 ➡ 3221 played with a preceding asterisk (**).
3221 ➡ 3222 mmaarrkk--ssyymmlliinnkkeedd--ddiirreeccttoorriieess ((OOffff))
3222 ➡ 3223 If set to OOnn, completed names which are symbolic links to direc-
3223
-
No equivalent source code line in the reference code can be identified.
- tories have a slash appended (subject to the value of
3224
-
+ tories have a slash appended (subject to the value of
3224 ➡ 3225 mmaarrkk--ddiirreeccttoorriieess).
3225 ➡ 3226 mmaattcchh--hhiiddddeenn--ffiilleess ((OOnn))
3226
-
No equivalent source code line in the reference code can be identified.
- This variable, when set to OOnn, causes readline to match files
3227
-
No equivalent source code line in the reference code can be identified.
- whose names begin with a `.' (hidden files) when performing
3228
-
No equivalent source code line in the reference code can be identified.
- filename completion. If set to OOffff, the leading `.' must be
3227
-
+ This variable, when set to OOnn, causes readline to match files
3228
-
+ whose names begin with a `.' (hidden files) when performing
3229
-
+ filename completion. If set to OOffff, the leading `.' must be
3229 ➡ 3230 supplied by the user in the filename to be completed.
3230 ➡ 3231 mmeennuu--ccoommpplleettee--ddiissppllaayy--pprreeffiixx ((OOffff))
3231
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, menu completion displays the common prefix of the
3232
-
+ If set to OOnn, menu completion displays the common prefix of the
3232 ➡ 3233 list of possible completions (which may be empty) before cycling
3233 ➡ 3234 through the list.
3234 ➡ 3235 oouuttppuutt--mmeettaa ((OOffff))
3235
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, readline will display characters with the eighth
3236
-
+ If set to OOnn, readline will display characters with the eighth
3236 ➡ 3237 bit set directly rather than as a meta-prefixed escape sequence.
3237 ➡ 3238 The default is _O_f_f, but readline will set it to _O_n if the locale
3238 ➡ 3239 contains eight-bit characters.
3239 ➡ 3240 ppaaggee--ccoommpplleettiioonnss ((OOnn))
3240
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, readline uses an internal _m_o_r_e-like pager to dis-
3241
-
+ If set to OOnn, readline uses an internal _m_o_r_e-like pager to dis-
3241 ➡ 3242 play a screenful of possible completions at a time.
3242 ➡ 3243 pprriinntt--ccoommpplleettiioonnss--hhoorriizzoonnttaallllyy ((OOffff))
3243
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, readline will display completions with matches
3244
-
No equivalent source code line in the reference code can be identified.
- sorted horizontally in alphabetical order, rather than down the
3244
-
+ If set to OOnn, readline will display completions with matches
3245
-
+ sorted horizontally in alphabetical order, rather than down the
3245 ➡ 3246 screen.
3246 ➡ 3247 rreevveerrtt--aallll--aatt--nneewwlliinnee ((OOffff))
3247
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, readline will undo all changes to history lines
3248
-
+ If set to OOnn, readline will undo all changes to history lines
3248 ➡ 3249 before returning when aacccceepptt--lliinnee is executed. By default, his-
3249
-
No equivalent source code line in the reference code can be identified.
- tory lines may be modified and retain individual undo lists
3250
-
+ tory lines may be modified and retain individual undo lists
3250 ➡ 3251 across calls to rreeaaddlliinnee.
3251 ➡ 3252 sshhooww--aallll--iiff--aammbbiigguuoouuss ((OOffff))
3252
-
No equivalent source code line in the reference code can be identified.
- This alters the default behavior of the completion functions.
3253
-
+ This alters the default behavior of the completion functions.
3253 ➡ 3254 If set to OOnn, words which have more than one possible completion
3254
-
No equivalent source code line in the reference code can be identified.
- cause the matches to be listed immediately instead of ringing
3255
-
+ cause the matches to be listed immediately instead of ringing
3255 ➡ 3256 the bell.
3256 ➡ 3257 sshhooww--aallll--iiff--uunnmmooddiiffiieedd ((OOffff))
3257
-
No equivalent source code line in the reference code can be identified.
- This alters the default behavior of the completion functions in
3258
-
+ This alters the default behavior of the completion functions in
3258 ➡ 3259 a fashion similar to sshhooww--aallll--iiff--aammbbiigguuoouuss. If set to OOnn, words
3259
-
No equivalent source code line in the reference code can be identified.
- which have more than one possible completion without any possi-
3260
-
No equivalent source code line in the reference code can be identified.
- ble partial completion (the possible completions don't share a
3261
-
No equivalent source code line in the reference code can be identified.
- common prefix) cause the matches to be listed immediately
3260
-
+ which have more than one possible completion without any possi-
3261
-
+ ble partial completion (the possible completions don't share a
3262
-
+ common prefix) cause the matches to be listed immediately
3262 ➡ 3263 instead of ringing the bell.
3263 ➡ 3264 sshhooww--mmooddee--iinn--pprroommpptt ((OOffff))
3264
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, add a character to the beginning of the prompt
3265
-
No equivalent source code line in the reference code can be identified.
- indicating the editing mode: emacs (@), vi command (:) or vi
3265
-
+ If set to OOnn, add a character to the beginning of the prompt
3266
-
+ indicating the editing mode: emacs (@), vi command (:) or vi
3266 ➡ 3267 insertion (+).
3267 ➡ 3268 sskkiipp--ccoommpplleetteedd--tteexxtt ((OOffff))
3268
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, this alters the default completion behavior when
3269
-
No equivalent source code line in the reference code can be identified.
- inserting a single match into the line. It's only active when
3270
-
No equivalent source code line in the reference code can be identified.
- performing completion in the middle of a word. If enabled,
3271
-
No equivalent source code line in the reference code can be identified.
- readline does not insert characters from the completion that
3272
-
No equivalent source code line in the reference code can be identified.
- match characters after point in the word being completed, so
3269
-
+ If set to OOnn, this alters the default completion behavior when
3270
-
+ inserting a single match into the line. It's only active when
3271
-
+ performing completion in the middle of a word. If enabled,
3272
-
+ readline does not insert characters from the completion that
3273
-
+ match characters after point in the word being completed, so
3273 ➡ 3274 portions of the word following the cursor are not duplicated.
3274 ➡ 3275 vvii--ccmmdd--mmooddee--ssttrriinngg ((((ccmmdd))))
3275 ➡ 3276 This string is displayed immediately before the last line of the
3276
-
No equivalent source code line in the reference code can be identified.
- primary prompt when vi editing mode is active and in command
3277
-
+ primary prompt when vi editing mode is active and in command
3277 ➡ 3278 mode. The value is expanded like a key binding, so the standard
3278 ➡ 3279 set of meta- and control prefixes and backslash escape sequences
3279
-
No equivalent source code line in the reference code can be identified.
- is available. Use the \1 and \2 escapes to begin and end
3280
-
+ is available. Use the \1 and \2 escapes to begin and end
3280 ➡ 3281 sequences of non-printing characters, which can be used to embed
3281 ➡ 3282 a terminal control sequence into the mode string.
3282 ➡ 3283 vvii--iinnss--mmooddee--ssttrriinngg ((((iinnss))))
3283 ➡ 3284 This string is displayed immediately before the last line of the
3284
-
No equivalent source code line in the reference code can be identified.
- primary prompt when vi editing mode is active and in insertion
3285
-
+ primary prompt when vi editing mode is active and in insertion
3285 ➡ 3286 mode. The value is expanded like a key binding, so the standard
3286 ➡ 3287 set of meta- and control prefixes and backslash escape sequences
3287
-
No equivalent source code line in the reference code can be identified.
- is available. Use the \1 and \2 escapes to begin and end
3288
-
+ is available. Use the \1 and \2 escapes to begin and end
3288 ➡ 3289 sequences of non-printing characters, which can be used to embed
3289 ➡ 3290 a terminal control sequence into the mode string.
3290 ➡ 3291 vviissiibbllee--ssttaattss ((OOffff))
3291
-
No equivalent source code line in the reference code can be identified.
- If set to OOnn, a character denoting a file's type as reported by
3292
-
No equivalent source code line in the reference code can be identified.
- _s_t_a_t(2) is appended to the filename when listing possible com-
3292
-
+ If set to OOnn, a character denoting a file's type as reported by
3293
-
+ _s_t_a_t(2) is appended to the filename when listing possible com-
3293 ➡ 3294 pletions.
3294 ➡ 3295
3295 ➡ 3296 RReeaaddlliinnee CCoonnddiittiioonnaall CCoonnssttrruuccttss
3296
-
No equivalent source code line in the reference code can be identified.
- Readline implements a facility similar in spirit to the conditional
3297
-
No equivalent source code line in the reference code can be identified.
- compilation features of the C preprocessor which allows key bindings
3298
-
No equivalent source code line in the reference code can be identified.
- and variable settings to be performed as the result of tests. There
3297
-
+ Readline implements a facility similar in spirit to the conditional
3298
-
+ compilation features of the C preprocessor which allows key bindings
3299
-
+ and variable settings to be performed as the result of tests. There
3299 ➡ 3300 are four parser directives used.
3300 ➡ 3301
3301
-
No equivalent source code line in the reference code can be identified.
- $$iiff The $$iiff construct allows bindings to be made based on the edit-
3302
-
No equivalent source code line in the reference code can be identified.
- ing mode, the terminal being used, or the application using
3303
-
No equivalent source code line in the reference code can be identified.
- readline. The text of the test extends to the end of the line;
3302
-
+ $$iiff The $$iiff construct allows bindings to be made based on the edit-
3303
-
+ ing mode, the terminal being used, or the application using
3304
-
+ readline. The text of the test extends to the end of the line;
3304 ➡ 3305 no characters are required to isolate it.
3305 ➡ 3306
3306
-
No equivalent source code line in the reference code can be identified.
- mmooddee The mmooddee== form of the $$iiff directive is used to test
3307
-
No equivalent source code line in the reference code can be identified.
- whether readline is in emacs or vi mode. This may be
3308
-
No equivalent source code line in the reference code can be identified.
- used in conjunction with the sseett kkeeyymmaapp command, for
3309
-
No equivalent source code line in the reference code can be identified.
- instance, to set bindings in the _e_m_a_c_s_-_s_t_a_n_d_a_r_d and
3310
-
No equivalent source code line in the reference code can be identified.
- _e_m_a_c_s_-_c_t_l_x keymaps only if readline is starting out in
3307
-
+ mmooddee The mmooddee== form of the $$iiff directive is used to test
3308
-
+ whether readline is in emacs or vi mode. This may be
3309
-
+ used in conjunction with the sseett kkeeyymmaapp command, for
3310
-
+ instance, to set bindings in the _e_m_a_c_s_-_s_t_a_n_d_a_r_d and
3311
-
+ _e_m_a_c_s_-_c_t_l_x keymaps only if readline is starting out in
3311 ➡ 3312 emacs mode.
3312 ➡ 3313
3313
-
No equivalent source code line in the reference code can be identified.
- tteerrmm The tteerrmm== form may be used to include terminal-specific
3314
-
+ tteerrmm The tteerrmm== form may be used to include terminal-specific
3314 ➡ 3315 key bindings, perhaps to bind the key sequences output by
3315 ➡ 3316 the terminal's function keys. The word on the right side
3316 ➡ 3317 of the == is tested against both the full name of the ter-
3317
-
No equivalent source code line in the reference code can be identified.
- minal and the portion of the terminal name before the
3318
-
No equivalent source code line in the reference code can be identified.
- first --. This allows _s_u_n to match both _s_u_n and _s_u_n_-_c_m_d,
3318
-
+ minal and the portion of the terminal name before the
3319
-
+ first --. This allows _s_u_n to match both _s_u_n and _s_u_n_-_c_m_d,
3319 ➡ 3320 for instance.
3320 ➡ 3321
3321 ➡ 3322 aapppplliiccaattiioonn
3322 ➡ 3323 The aapppplliiccaattiioonn construct is used to include application-
3323 ➡ 3324 specific settings. Each program using the readline
3324
-
No equivalent source code line in the reference code can be identified.
- library sets the _a_p_p_l_i_c_a_t_i_o_n _n_a_m_e, and an initialization
3325
-
+ library sets the _a_p_p_l_i_c_a_t_i_o_n _n_a_m_e, and an initialization
3325 ➡ 3326 file can test for a particular value. This could be used
3326
-
No equivalent source code line in the reference code can be identified.
- to bind key sequences to functions useful for a specific
3327
-
No equivalent source code line in the reference code can be identified.
- program. For instance, the following command adds a key
3328
-
No equivalent source code line in the reference code can be identified.
- sequence that quotes the current or previous word in
3327
-
+ to bind key sequences to functions useful for a specific
3328
-
+ program. For instance, the following command adds a key
3329
-
+ sequence that quotes the current or previous word in
3329 ➡ 3330 bbaasshh:
3330 ➡ 3331
3331 ➡ 3332 $$iiff Bash
@@ -3340,51 +3341,51 @@ RREEAADDLLIINNEE
3340 ➡ 3341 test fails.
3341 ➡ 3342
3342 ➡ 3343 $$iinncclluuddee
3343
-
No equivalent source code line in the reference code can be identified.
- This directive takes a single filename as an argument and reads
3344
-
No equivalent source code line in the reference code can be identified.
- commands and bindings from that file. For example, the follow-
3344
-
+ This directive takes a single filename as an argument and reads
3345
-
+ commands and bindings from that file. For example, the follow-
3345 ➡ 3346 ing directive would read _/_e_t_c_/_i_n_p_u_t_r_c:
3346 ➡ 3347
3347 ➡ 3348 $$iinncclluuddee _/_e_t_c_/_i_n_p_u_t_r_c
3348 ➡ 3349
3349 ➡ 3350 SSeeaarrcchhiinngg
3350
-
No equivalent source code line in the reference code can be identified.
- Readline provides commands for searching through the command history
3351
-
+ Readline provides commands for searching through the command history
3351 ➡ 3352 (see HHIISSTTOORRYY below) for lines containing a specified string. There are
3352 ➡ 3353 two search modes: _i_n_c_r_e_m_e_n_t_a_l and _n_o_n_-_i_n_c_r_e_m_e_n_t_a_l.
3353 ➡ 3354
3354
-
No equivalent source code line in the reference code can be identified.
- Incremental searches begin before the user has finished typing the
3355
-
No equivalent source code line in the reference code can be identified.
- search string. As each character of the search string is typed, read-
3355
-
+ Incremental searches begin before the user has finished typing the
3356
-
+ search string. As each character of the search string is typed, read-
3356 ➡ 3357 line displays the next entry from the history matching the string typed
3357
-
No equivalent source code line in the reference code can be identified.
- so far. An incremental search requires only as many characters as
3358
-
No equivalent source code line in the reference code can be identified.
- needed to find the desired history entry. The characters present in
3359
-
No equivalent source code line in the reference code can be identified.
- the value of the iisseeaarrcchh--tteerrmmiinnaattoorrss variable are used to terminate an
3358
-
+ so far. An incremental search requires only as many characters as
3359
-
+ needed to find the desired history entry. The characters present in
3360
-
+ the value of the iisseeaarrcchh--tteerrmmiinnaattoorrss variable are used to terminate an
3360 ➡ 3361 incremental search. If that variable has not been assigned a value the
3361
-
No equivalent source code line in the reference code can be identified.
- Escape and Control-J characters will terminate an incremental search.
3362
-
No equivalent source code line in the reference code can be identified.
- Control-G will abort an incremental search and restore the original
3363
-
No equivalent source code line in the reference code can be identified.
- line. When the search is terminated, the history entry containing the
3362
-
+ Escape and Control-J characters will terminate an incremental search.
3363
-
+ Control-G will abort an incremental search and restore the original
3364
-
+ line. When the search is terminated, the history entry containing the
3364 ➡ 3365 search string becomes the current line.
3365 ➡ 3366
3366
-
No equivalent source code line in the reference code can be identified.
- To find other matching entries in the history list, type Control-S or
3367
-
No equivalent source code line in the reference code can be identified.
- Control-R as appropriate. This will search backward or forward in the
3368
-
No equivalent source code line in the reference code can be identified.
- history for the next entry matching the search string typed so far.
3369
-
No equivalent source code line in the reference code can be identified.
- Any other key sequence bound to a readline command will terminate the
3370
-
No equivalent source code line in the reference code can be identified.
- search and execute that command. For instance, a _n_e_w_l_i_n_e will termi-
3367
-
+ To find other matching entries in the history list, type Control-S or
3368
-
+ Control-R as appropriate. This will search backward or forward in the
3369
-
+ history for the next entry matching the search string typed so far.
3370
-
+ Any other key sequence bound to a readline command will terminate the
3371
-
+ search and execute that command. For instance, a _n_e_w_l_i_n_e will termi-
3371 ➡ 3372 nate the search and accept the line, thereby executing the command from
3372 ➡ 3373 the history list.
3373 ➡ 3374
3374 ➡ 3375 Readline remembers the last incremental search string. If two Control-
3375
-
No equivalent source code line in the reference code can be identified.
- Rs are typed without any intervening characters defining a new search
3376
-
+ Rs are typed without any intervening characters defining a new search
3376 ➡ 3377 string, any remembered search string is used.
3377 ➡ 3378
3378
-
No equivalent source code line in the reference code can be identified.
- Non-incremental searches read the entire search string before starting
3379
-
No equivalent source code line in the reference code can be identified.
- to search for matching history lines. The search string may be typed
3379
-
+ Non-incremental searches read the entire search string before starting
3380
-
+ to search for matching history lines. The search string may be typed
3380 ➡ 3381 by the user or be part of the contents of the current line.
3381 ➡ 3382
3382 ➡ 3383 RReeaaddlliinnee CCoommmmaanndd NNaammeess
3383
-
No equivalent source code line in the reference code can be identified.
- The following is a list of the names of the commands and the default
3384
-
+ The following is a list of the names of the commands and the default
3384 ➡ 3385 key sequences to which they are bound. Command names without an accom-
3385 ➡ 3386 panying key sequence are unbound by default. In the following descrip-
3386
-
No equivalent source code line in the reference code can be identified.
- tions, _p_o_i_n_t refers to the current cursor position, and _m_a_r_k refers to
3387
-
No equivalent source code line in the reference code can be identified.
- a cursor position saved by the sseett--mmaarrkk command. The text between the
3387
-
+ tions, _p_o_i_n_t refers to the current cursor position, and _m_a_r_k refers to
3388
-
+ a cursor position saved by the sseett--mmaarrkk command. The text between the
3388 ➡ 3389 point and mark is referred to as the _r_e_g_i_o_n.
3389 ➡ 3390
3390 ➡ 3391 CCoommmmaannddss ffoorr MMoovviinngg
@@ -3400,29 +3401,29 @@ RREEAADDLLIINNEE
3400 ➡ 3401 Move forward to the end of the next word. Words are composed of
3401 ➡ 3402 alphanumeric characters (letters and digits).
3402 ➡ 3403 bbaacckkwwaarrdd--wwoorrdd ((MM--bb))
3403
-
No equivalent source code line in the reference code can be identified.
- Move back to the start of the current or previous word. Words
3404
-
+ Move back to the start of the current or previous word. Words
3404 ➡ 3405 are composed of alphanumeric characters (letters and digits).
3405 ➡ 3406 sshheellll--ffoorrwwaarrdd--wwoorrdd
3406
-
No equivalent source code line in the reference code can be identified.
- Move forward to the end of the next word. Words are delimited
3407
-
+ Move forward to the end of the next word. Words are delimited
3407 ➡ 3408 by non-quoted shell metacharacters.
3408 ➡ 3409 sshheellll--bbaacckkwwaarrdd--wwoorrdd
3409
-
No equivalent source code line in the reference code can be identified.
- Move back to the start of the current or previous word. Words
3410
-
+ Move back to the start of the current or previous word. Words
3410 ➡ 3411 are delimited by non-quoted shell metacharacters.
3411 ➡ 3412 pprreevviioouuss--ssccrreeeenn--lliinnee
3412
-
No equivalent source code line in the reference code can be identified.
- Attempt to move point to the same physical screen column on the
3413
-
No equivalent source code line in the reference code can be identified.
- previous physical screen line. This will not have the desired
3414
-
No equivalent source code line in the reference code can be identified.
- effect if the current Readline line does not take up more than
3415
-
No equivalent source code line in the reference code can be identified.
- one physical line or if point is not greater than the length of
3413
-
+ Attempt to move point to the same physical screen column on the
3414
-
+ previous physical screen line. This will not have the desired
3415
-
+ effect if the current Readline line does not take up more than
3416
-
+ one physical line or if point is not greater than the length of
3416 ➡ 3417 the prompt plus the screen width.
3417 ➡ 3418 nneexxtt--ssccrreeeenn--lliinnee
3418
-
No equivalent source code line in the reference code can be identified.
- Attempt to move point to the same physical screen column on the
3419
-
+ Attempt to move point to the same physical screen column on the
3419 ➡ 3420 next physical screen line. This will not have the desired effect
3420
-
No equivalent source code line in the reference code can be identified.
- if the current Readline line does not take up more than one
3421
-
No equivalent source code line in the reference code can be identified.
- physical line or if the length of the current Readline line is
3421
-
+ if the current Readline line does not take up more than one
3422
-
+ physical line or if the length of the current Readline line is
3422 ➡ 3423 not greater than the length of the prompt plus the screen width.
3423 ➡ 3424 cclleeaarr--ssccrreeeenn ((CC--ll))
3424
-
No equivalent source code line in the reference code can be identified.
- Clear the screen leaving the current line at the top of the
3425
-
No equivalent source code line in the reference code can be identified.
- screen. With an argument, refresh the current line without
3425
-
+ Clear the screen leaving the current line at the top of the
3426
-
+ screen. With an argument, refresh the current line without
3426 ➡ 3427 clearing the screen.
3427 ➡ 3428 rreeddrraaww--ccuurrrreenntt--lliinnee
3428 ➡ 3429 Refresh the current line.
@@ -3430,70 +3431,70 @@ RREEAADDLLIINNEE
3430 ➡ 3431 CCoommmmaannddss ffoorr MMaanniippuullaattiinngg tthhee HHiissttoorryy
3431 ➡ 3432 aacccceepptt--lliinnee ((NNeewwlliinnee,, RReettuurrnn))
3432 ➡ 3433 Accept the line regardless of where the cursor is. If this line
3433
-
No equivalent source code line in the reference code can be identified.
- is non-empty, add it to the history list according to the state
3434
-
No equivalent source code line in the reference code can be identified.
- of the HHIISSTTCCOONNTTRROOLL variable. If the line is a modified history
3434
-
+ is non-empty, add it to the history list according to the state
3435
-
+ of the HHIISSTTCCOONNTTRROOLL variable. If the line is a modified history
3435 ➡ 3436 line, then restore the history line to its original state.
3436 ➡ 3437 pprreevviioouuss--hhiissttoorryy ((CC--pp))
3437 ➡ 3438 Fetch the previous command from the history list, moving back in
3438 ➡ 3439 the list.
3439 ➡ 3440 nneexxtt--hhiissttoorryy ((CC--nn))
3440
-
No equivalent source code line in the reference code can be identified.
- Fetch the next command from the history list, moving forward in
3441
-
+ Fetch the next command from the history list, moving forward in
3441 ➡ 3442 the list.
3442 ➡ 3443 bbeeggiinnnniinngg--ooff--hhiissttoorryy ((MM--<<))
3443 ➡ 3444 Move to the first line in the history.
3444 ➡ 3445 eenndd--ooff--hhiissttoorryy ((MM-->>))
3445
-
No equivalent source code line in the reference code can be identified.
- Move to the end of the input history, i.e., the line currently
3446
-
+ Move to the end of the input history, i.e., the line currently
3446 ➡ 3447 being entered.
3447 ➡ 3448 rreevveerrssee--sseeaarrcchh--hhiissttoorryy ((CC--rr))
3448
-
No equivalent source code line in the reference code can be identified.
- Search backward starting at the current line and moving `up'
3449
-
No equivalent source code line in the reference code can be identified.
- through the history as necessary. This is an incremental
3449
-
+ Search backward starting at the current line and moving `up'
3450
-
+ through the history as necessary. This is an incremental
3450 ➡ 3451 search.
3451 ➡ 3452 ffoorrwwaarrdd--sseeaarrcchh--hhiissttoorryy ((CC--ss))
3452
-
No equivalent source code line in the reference code can be identified.
- Search forward starting at the current line and moving `down'
3453
-
No equivalent source code line in the reference code can be identified.
- through the history as necessary. This is an incremental
3453
-
+ Search forward starting at the current line and moving `down'
3454
-
+ through the history as necessary. This is an incremental
3454 ➡ 3455 search.
3455 ➡ 3456 nnoonn--iinnccrreemmeennttaall--rreevveerrssee--sseeaarrcchh--hhiissttoorryy ((MM--pp))
3456 ➡ 3457 Search backward through the history starting at the current line
3457
-
No equivalent source code line in the reference code can be identified.
- using a non-incremental search for a string supplied by the
3458
-
+ using a non-incremental search for a string supplied by the
3458 ➡ 3459 user.
3459 ➡ 3460 nnoonn--iinnccrreemmeennttaall--ffoorrwwaarrdd--sseeaarrcchh--hhiissttoorryy ((MM--nn))
3460
-
No equivalent source code line in the reference code can be identified.
- Search forward through the history using a non-incremental
3461
-
+ Search forward through the history using a non-incremental
3461 ➡ 3462 search for a string supplied by the user.
3462 ➡ 3463 hhiissttoorryy--sseeaarrcchh--ffoorrwwaarrdd
3463
-
No equivalent source code line in the reference code can be identified.
- Search forward through the history for the string of characters
3464
-
No equivalent source code line in the reference code can be identified.
- between the start of the current line and the point. This is a
3464
-
+ Search forward through the history for the string of characters
3465
-
+ between the start of the current line and the point. This is a
3465 ➡ 3466 non-incremental search.
3466 ➡ 3467 hhiissttoorryy--sseeaarrcchh--bbaacckkwwaarrdd
3467 ➡ 3468 Search backward through the history for the string of characters
3468
-
No equivalent source code line in the reference code can be identified.
- between the start of the current line and the point. This is a
3469
-
+ between the start of the current line and the point. This is a
3469 ➡ 3470 non-incremental search.
3470 ➡ 3471 hhiissttoorryy--ssuubbssttrriinngg--sseeaarrcchh--bbaacckkwwaarrdd
3471 ➡ 3472 Search backward through the history for the string of characters
3472
-
No equivalent source code line in the reference code can be identified.
- between the start of the current line and the current cursor
3473
-
+ between the start of the current line and the current cursor
3473 ➡ 3474 position (the _p_o_i_n_t). The search string may match anywhere in a
3474 ➡ 3475 history line. This is a non-incremental search.
3475 ➡ 3476 hhiissttoorryy--ssuubbssttrriinngg--sseeaarrcchh--ffoorrwwaarrdd
3476
-
No equivalent source code line in the reference code can be identified.
- Search forward through the history for the string of characters
3477
-
+ Search forward through the history for the string of characters
3477 ➡ 3478 between the start of the current line and the point. The search
3478
-
No equivalent source code line in the reference code can be identified.
- string may match anywhere in a history line. This is a non-
3479
-
+ string may match anywhere in a history line. This is a non-
3479 ➡ 3480 incremental search.
3480 ➡ 3481 yyaannkk--nntthh--aarrgg ((MM--CC--yy))
3481
-
No equivalent source code line in the reference code can be identified.
- Insert the first argument to the previous command (usually the
3482
-
+ Insert the first argument to the previous command (usually the
3482 ➡ 3483 second word on the previous line) at point. With an argument _n,
3483
-
No equivalent source code line in the reference code can be identified.
- insert the _nth word from the previous command (the words in the
3484
-
No equivalent source code line in the reference code can be identified.
- previous command begin with word 0). A negative argument
3484
-
+ insert the _nth word from the previous command (the words in the
3485
-
+ previous command begin with word 0). A negative argument
3485 ➡ 3486 inserts the _nth word from the end of the previous command. Once
3486
-
No equivalent source code line in the reference code can be identified.
- the argument _n is computed, the argument is extracted as if the
3487
-
+ the argument _n is computed, the argument is extracted as if the
3487 ➡ 3488 "!_n" history expansion had been specified.
3488 ➡ 3489 yyaannkk--llaasstt--aarrgg ((MM--..,, MM--__))
3489
-
No equivalent source code line in the reference code can be identified.
- Insert the last argument to the previous command (the last word
3490
-
+ Insert the last argument to the previous command (the last word
3490 ➡ 3491 of the previous history entry). With a numeric argument, behave
3491
-
No equivalent source code line in the reference code can be identified.
- exactly like yyaannkk--nntthh--aarrgg. Successive calls to yyaannkk--llaasstt--aarrgg
3492
-
No equivalent source code line in the reference code can be identified.
- move back through the history list, inserting the last word (or
3493
-
No equivalent source code line in the reference code can be identified.
- the word specified by the argument to the first call) of each
3492
-
+ exactly like yyaannkk--nntthh--aarrgg. Successive calls to yyaannkk--llaasstt--aarrgg
3493
-
+ move back through the history list, inserting the last word (or
3494
-
+ the word specified by the argument to the first call) of each
3494 ➡ 3495 line in turn. Any numeric argument supplied to these successive
3495
-
No equivalent source code line in the reference code can be identified.
- calls determines the direction to move through the history. A
3496
-
No equivalent source code line in the reference code can be identified.
- negative argument switches the direction through the history
3496
-
+ calls determines the direction to move through the history. A
3497
-
+ negative argument switches the direction through the history
3497 ➡ 3498 (back or forward). The history expansion facilities are used to
3498 ➡ 3499 extract the last word, as if the "!$" history expansion had been
3499 ➡ 3500 specified.
@@ -3502,80 +3503,80 @@ RREEAADDLLIINNEE
3502 ➡ 3503 tory expansion as well as all of the shell word expansions. See
3503 ➡ 3504 HHIISSTTOORRYY EEXXPPAANNSSIIOONN below for a description of history expansion.
3504 ➡ 3505 hhiissttoorryy--eexxppaanndd--lliinnee ((MM--^^))
3505
-
No equivalent source code line in the reference code can be identified.
- Perform history expansion on the current line. See HHIISSTTOORRYY
3506
-
+ Perform history expansion on the current line. See HHIISSTTOORRYY
3506 ➡ 3507 EEXXPPAANNSSIIOONN below for a description of history expansion.
3507 ➡ 3508 mmaaggiicc--ssppaaccee
3508
-
No equivalent source code line in the reference code can be identified.
- Perform history expansion on the current line and insert a
3509
-
+ Perform history expansion on the current line and insert a
3509 ➡ 3510 space. See HHIISSTTOORRYY EEXXPPAANNSSIIOONN below for a description of history
3510 ➡ 3511 expansion.
3511 ➡ 3512 aalliiaass--eexxppaanndd--lliinnee
3512
-
No equivalent source code line in the reference code can be identified.
- Perform alias expansion on the current line. See AALLIIAASSEESS above
3513
-
+ Perform alias expansion on the current line. See AALLIIAASSEESS above
3513 ➡ 3514 for a description of alias expansion.
3514 ➡ 3515 hhiissttoorryy--aanndd--aalliiaass--eexxppaanndd--lliinnee
3515 ➡ 3516 Perform history and alias expansion on the current line.
3516 ➡ 3517 iinnsseerrtt--llaasstt--aarrgguummeenntt ((MM--..,, MM--__))
3517 ➡ 3518 A synonym for yyaannkk--llaasstt--aarrgg.
3518 ➡ 3519 ooppeerraattee--aanndd--ggeett--nneexxtt ((CC--oo))
3519
-
No equivalent source code line in the reference code can be identified.
- Accept the current line for execution and fetch the next line
3520
-
No equivalent source code line in the reference code can be identified.
- relative to the current line from the history for editing. A
3521
-
No equivalent source code line in the reference code can be identified.
- numeric argument, if supplied, specifies the history entry to
3520
-
+ Accept the current line for execution and fetch the next line
3521
-
+ relative to the current line from the history for editing. A
3522
-
+ numeric argument, if supplied, specifies the history entry to
3522 ➡ 3523 use instead of the current line.
3523 ➡ 3524 eeddiitt--aanndd--eexxeeccuuttee--ccoommmmaanndd ((CC--xx CC--ee))
3524
-
No equivalent source code line in the reference code can be identified.
- Invoke an editor on the current command line, and execute the
3525
-
No equivalent source code line in the reference code can be identified.
- result as shell commands. BBaasshh attempts to invoke $$VVIISSUUAALL,
3525
-
+ Invoke an editor on the current command line, and execute the
3526
-
+ result as shell commands. BBaasshh attempts to invoke $$VVIISSUUAALL,
3526 ➡ 3527 $$EEDDIITTOORR, and _e_m_a_c_s as the editor, in that order.
3527 ➡ 3528
3528 ➡ 3529 CCoommmmaannddss ffoorr CChhaannggiinngg TTeexxtt
3529 ➡ 3530 _e_n_d_-_o_f_-_f_i_l_e ((uussuuaallllyy CC--dd))
3530
-
No equivalent source code line in the reference code can be identified.
- The character indicating end-of-file as set, for example, by
3531
-
No equivalent source code line in the reference code can be identified.
- ``stty''. If this character is read when there are no charac-
3532
-
No equivalent source code line in the reference code can be identified.
- ters on the line, and point is at the beginning of the line,
3531
-
+ The character indicating end-of-file as set, for example, by
3532
-
+ ``stty''. If this character is read when there are no charac-
3533
-
+ ters on the line, and point is at the beginning of the line,
3533 ➡ 3534 Readline interprets it as the end of input and returns EEOOFF.
3534 ➡ 3535 ddeelleettee--cchhaarr ((CC--dd))
3535 ➡ 3536 Delete the character at point. If this function is bound to the
3536 ➡ 3537 same character as the tty EEOOFF character, as CC--dd commonly is, see
3537 ➡ 3538 above for the effects.
3538 ➡ 3539 bbaacckkwwaarrdd--ddeelleettee--cchhaarr ((RRuubboouutt))
3539
-
No equivalent source code line in the reference code can be identified.
- Delete the character behind the cursor. When given a numeric
3540
-
+ Delete the character behind the cursor. When given a numeric
3540 ➡ 3541 argument, save the deleted text on the kill ring.
3541 ➡ 3542 ffoorrwwaarrdd--bbaacckkwwaarrdd--ddeelleettee--cchhaarr
3542
-
No equivalent source code line in the reference code can be identified.
- Delete the character under the cursor, unless the cursor is at
3543
-
+ Delete the character under the cursor, unless the cursor is at
3543 ➡ 3544 the end of the line, in which case the character behind the cur-
3544 ➡ 3545 sor is deleted.
3545 ➡ 3546 qquuootteedd--iinnsseerrtt ((CC--qq,, CC--vv))
3546
-
No equivalent source code line in the reference code can be identified.
- Add the next character typed to the line verbatim. This is how
3547
-
+ Add the next character typed to the line verbatim. This is how
3547 ➡ 3548 to insert characters like CC--qq, for example.
3548 ➡ 3549 ttaabb--iinnsseerrtt ((CC--vv TTAABB))
3549 ➡ 3550 Insert a tab character.
3550 ➡ 3551 sseellff--iinnsseerrtt ((aa,, bb,, AA,, 11,, !!,, ......))
3551 ➡ 3552 Insert the character typed.
3552 ➡ 3553 ttrraannssppoossee--cchhaarrss ((CC--tt))
3553
-
No equivalent source code line in the reference code can be identified.
- Drag the character before point forward over the character at
3554
-
No equivalent source code line in the reference code can be identified.
- point, moving point forward as well. If point is at the end of
3555
-
No equivalent source code line in the reference code can be identified.
- the line, then this transposes the two characters before point.
3554
-
+ Drag the character before point forward over the character at
3555
-
+ point, moving point forward as well. If point is at the end of
3556
-
+ the line, then this transposes the two characters before point.
3556 ➡ 3557 Negative arguments have no effect.
3557 ➡ 3558 ttrraannssppoossee--wwoorrddss ((MM--tt))
3558
-
No equivalent source code line in the reference code can be identified.
- Drag the word before point past the word after point, moving
3559
-
No equivalent source code line in the reference code can be identified.
- point over that word as well. If point is at the end of the
3559
-
+ Drag the word before point past the word after point, moving
3560
-
+ point over that word as well. If point is at the end of the
3560 ➡ 3561 line, this transposes the last two words on the line.
3561 ➡ 3562 uuppccaassee--wwoorrdd ((MM--uu))
3562
-
No equivalent source code line in the reference code can be identified.
- Uppercase the current (or following) word. With a negative
3563
-
+ Uppercase the current (or following) word. With a negative
3563 ➡ 3564 argument, uppercase the previous word, but do not move point.
3564 ➡ 3565 ddoowwnnccaassee--wwoorrdd ((MM--ll))
3565
-
No equivalent source code line in the reference code can be identified.
- Lowercase the current (or following) word. With a negative
3566
-
+ Lowercase the current (or following) word. With a negative
3566 ➡ 3567 argument, lowercase the previous word, but do not move point.
3567 ➡ 3568 ccaappiittaalliizzee--wwoorrdd ((MM--cc))
3568
-
No equivalent source code line in the reference code can be identified.
- Capitalize the current (or following) word. With a negative
3569
-
+ Capitalize the current (or following) word. With a negative
3569 ➡ 3570 argument, capitalize the previous word, but do not move point.
3570 ➡ 3571 oovveerrwwrriittee--mmooddee
3571
-
No equivalent source code line in the reference code can be identified.
- Toggle overwrite mode. With an explicit positive numeric argu-
3572
-
+ Toggle overwrite mode. With an explicit positive numeric argu-
3572 ➡ 3573 ment, switches to overwrite mode. With an explicit non-positive
3573 ➡ 3574 numeric argument, switches to insert mode. This command affects
3574
-
No equivalent source code line in the reference code can be identified.
- only eemmaaccss mode; vvii mode does overwrite differently. Each call
3575
-
+ only eemmaaccss mode; vvii mode does overwrite differently. Each call
3575 ➡ 3576 to _r_e_a_d_l_i_n_e_(_) starts in insert mode. In overwrite mode, charac-
3576
-
No equivalent source code line in the reference code can be identified.
- ters bound to sseellff--iinnsseerrtt replace the text at point rather than
3577
-
No equivalent source code line in the reference code can be identified.
- pushing the text to the right. Characters bound to bbaacckk--
3578
-
No equivalent source code line in the reference code can be identified.
- wwaarrdd--ddeelleettee--cchhaarr replace the character before point with a
3577
-
+ ters bound to sseellff--iinnsseerrtt replace the text at point rather than
3578
-
+ pushing the text to the right. Characters bound to bbaacckk--
3579
-
+ wwaarrdd--ddeelleettee--cchhaarr replace the character before point with a
3579 ➡ 3580 space. By default, this command is unbound.
3580 ➡ 3581
3581 ➡ 3582 KKiilllliinngg aanndd YYaannkkiinngg
@@ -3584,31 +3585,31 @@ RREEAADDLLIINNEE
3584 ➡ 3585 bbaacckkwwaarrdd--kkiillll--lliinnee ((CC--xx RRuubboouutt))
3585 ➡ 3586 Kill backward to the beginning of the line.
3586 ➡ 3587 uunniixx--lliinnee--ddiissccaarrdd ((CC--uu))
3587
-
No equivalent source code line in the reference code can be identified.
- Kill backward from point to the beginning of the line. The
3588
-
+ Kill backward from point to the beginning of the line. The
3588 ➡ 3589 killed text is saved on the kill-ring.
3589 ➡ 3590 kkiillll--wwhhoollee--lliinnee
3590
-
No equivalent source code line in the reference code can be identified.
- Kill all characters on the current line, no matter where point
3591
-
+ Kill all characters on the current line, no matter where point
3591 ➡ 3592 is.
3592 ➡ 3593 kkiillll--wwoorrdd ((MM--dd))
3593
-
No equivalent source code line in the reference code can be identified.
- Kill from point to the end of the current word, or if between
3594
-
No equivalent source code line in the reference code can be identified.
- words, to the end of the next word. Word boundaries are the
3594
-
+ Kill from point to the end of the current word, or if between
3595
-
+ words, to the end of the next word. Word boundaries are the
3595 ➡ 3596 same as those used by ffoorrwwaarrdd--wwoorrdd.
3596 ➡ 3597 bbaacckkwwaarrdd--kkiillll--wwoorrdd ((MM--RRuubboouutt))
3597
-
No equivalent source code line in the reference code can be identified.
- Kill the word behind point. Word boundaries are the same as
3598
-
+ Kill the word behind point. Word boundaries are the same as
3598 ➡ 3599 those used by bbaacckkwwaarrdd--wwoorrdd.
3599 ➡ 3600 sshheellll--kkiillll--wwoorrdd
3600
-
No equivalent source code line in the reference code can be identified.
- Kill from point to the end of the current word, or if between
3601
-
No equivalent source code line in the reference code can be identified.
- words, to the end of the next word. Word boundaries are the
3601
-
+ Kill from point to the end of the current word, or if between
3602
-
+ words, to the end of the next word. Word boundaries are the
3602 ➡ 3603 same as those used by sshheellll--ffoorrwwaarrdd--wwoorrdd.
3603 ➡ 3604 sshheellll--bbaacckkwwaarrdd--kkiillll--wwoorrdd
3604
-
No equivalent source code line in the reference code can be identified.
- Kill the word behind point. Word boundaries are the same as
3605
-
+ Kill the word behind point. Word boundaries are the same as
3605 ➡ 3606 those used by sshheellll--bbaacckkwwaarrdd--wwoorrdd.
3606 ➡ 3607 uunniixx--wwoorrdd--rruubboouutt ((CC--ww))
3607
-
No equivalent source code line in the reference code can be identified.
- Kill the word behind point, using white space as a word bound-
3608
-
+ Kill the word behind point, using white space as a word bound-
3608 ➡ 3609 ary. The killed text is saved on the kill-ring.
3609 ➡ 3610 uunniixx--ffiilleennaammee--rruubboouutt
3610
-
No equivalent source code line in the reference code can be identified.
- Kill the word behind point, using white space and the slash
3611
-
No equivalent source code line in the reference code can be identified.
- character as the word boundaries. The killed text is saved on
3611
-
+ Kill the word behind point, using white space and the slash
3612
-
+ character as the word boundaries. The killed text is saved on
3612 ➡ 3613 the kill-ring.
3613 ➡ 3614 ddeelleettee--hhoorriizzoonnttaall--ssppaaccee ((MM--\\))
3614 ➡ 3615 Delete all spaces and tabs around point.
@@ -3617,65 +3618,65 @@ RREEAADDLLIINNEE
3617 ➡ 3618 ccooppyy--rreeggiioonn--aass--kkiillll
3618 ➡ 3619 Copy the text in the region to the kill buffer.
3619 ➡ 3620 ccooppyy--bbaacckkwwaarrdd--wwoorrdd
3620
-
No equivalent source code line in the reference code can be identified.
- Copy the word before point to the kill buffer. The word bound-
3621
-
+ Copy the word before point to the kill buffer. The word bound-
3621 ➡ 3622 aries are the same as bbaacckkwwaarrdd--wwoorrdd.
3622 ➡ 3623 ccooppyy--ffoorrwwaarrdd--wwoorrdd
3623
-
No equivalent source code line in the reference code can be identified.
- Copy the word following point to the kill buffer. The word
3624
-
+ Copy the word following point to the kill buffer. The word
3624 ➡ 3625 boundaries are the same as ffoorrwwaarrdd--wwoorrdd.
3625 ➡ 3626 yyaannkk ((CC--yy))
3626 ➡ 3627 Yank the top of the kill ring into the buffer at point.
3627 ➡ 3628 yyaannkk--ppoopp ((MM--yy))
3628
-
No equivalent source code line in the reference code can be identified.
- Rotate the kill ring, and yank the new top. Only works follow-
3629
-
+ Rotate the kill ring, and yank the new top. Only works follow-
3629 ➡ 3630 ing yyaannkk or yyaannkk--ppoopp.
3630 ➡ 3631
3631 ➡ 3632 NNuummeerriicc AArrgguummeennttss
3632 ➡ 3633 ddiiggiitt--aarrgguummeenntt ((MM--00,, MM--11,, ......,, MM----))
3633
-
No equivalent source code line in the reference code can be identified.
- Add this digit to the argument already accumulating, or start a
3634
-
+ Add this digit to the argument already accumulating, or start a
3634 ➡ 3635 new argument. M-- starts a negative argument.
3635 ➡ 3636 uunniivveerrssaall--aarrgguummeenntt
3636
-
No equivalent source code line in the reference code can be identified.
- This is another way to specify an argument. If this command is
3637
-
No equivalent source code line in the reference code can be identified.
- followed by one or more digits, optionally with a leading minus
3638
-
No equivalent source code line in the reference code can be identified.
- sign, those digits define the argument. If the command is fol-
3639
-
No equivalent source code line in the reference code can be identified.
- lowed by digits, executing uunniivveerrssaall--aarrgguummeenntt again ends the
3640
-
No equivalent source code line in the reference code can be identified.
- numeric argument, but is otherwise ignored. As a special case,
3641
-
No equivalent source code line in the reference code can be identified.
- if this command is immediately followed by a character that is
3642
-
No equivalent source code line in the reference code can be identified.
- neither a digit nor minus sign, the argument count for the next
3643
-
No equivalent source code line in the reference code can be identified.
- command is multiplied by four. The argument count is initially
3644
-
No equivalent source code line in the reference code can be identified.
- one, so executing this function the first time makes the argu-
3637
-
+ This is another way to specify an argument. If this command is
3638
-
+ followed by one or more digits, optionally with a leading minus
3639
-
+ sign, those digits define the argument. If the command is fol-
3640
-
+ lowed by digits, executing uunniivveerrssaall--aarrgguummeenntt again ends the
3641
-
+ numeric argument, but is otherwise ignored. As a special case,
3642
-
+ if this command is immediately followed by a character that is
3643
-
+ neither a digit nor minus sign, the argument count for the next
3644
-
+ command is multiplied by four. The argument count is initially
3645
-
+ one, so executing this function the first time makes the argu-
3645 ➡ 3646 ment count four, a second time makes the argument count sixteen,
3646 ➡ 3647 and so on.
3647 ➡ 3648
3648 ➡ 3649 CCoommpplleettiinngg
3649 ➡ 3650 ccoommpplleettee ((TTAABB))
3650
-
No equivalent source code line in the reference code can be identified.
- Attempt to perform completion on the text before point. BBaasshh
3651
-
+ Attempt to perform completion on the text before point. BBaasshh
3651 ➡ 3652 attempts completion treating the text as a variable (if the text
3652
-
No equivalent source code line in the reference code can be identified.
- begins with $$), username (if the text begins with ~~), hostname
3653
-
No equivalent source code line in the reference code can be identified.
- (if the text begins with @@), or command (including aliases and
3653
-
+ begins with $$), username (if the text begins with ~~), hostname
3654
-
+ (if the text begins with @@), or command (including aliases and
3654 ➡ 3655 functions) in turn. If none of these produces a match, filename
3655 ➡ 3656 completion is attempted.
3656 ➡ 3657 ppoossssiibbllee--ccoommpplleettiioonnss ((MM--??))
3657 ➡ 3658 List the possible completions of the text before point.
3658 ➡ 3659 iinnsseerrtt--ccoommpplleettiioonnss ((MM--**))
3659
-
No equivalent source code line in the reference code can be identified.
- Insert all completions of the text before point that would have
3660
-
+ Insert all completions of the text before point that would have
3660 ➡ 3661 been generated by ppoossssiibbllee--ccoommpplleettiioonnss.
3661 ➡ 3662 mmeennuu--ccoommpplleettee
3662
-
No equivalent source code line in the reference code can be identified.
- Similar to ccoommpplleettee, but replaces the word to be completed with
3663
-
No equivalent source code line in the reference code can be identified.
- a single match from the list of possible completions. Repeated
3664
-
No equivalent source code line in the reference code can be identified.
- execution of mmeennuu--ccoommpplleettee steps through the list of possible
3665
-
No equivalent source code line in the reference code can be identified.
- completions, inserting each match in turn. At the end of the
3663
-
+ Similar to ccoommpplleettee, but replaces the word to be completed with
3664
-
+ a single match from the list of possible completions. Repeated
3665
-
+ execution of mmeennuu--ccoommpplleettee steps through the list of possible
3666
-
+ completions, inserting each match in turn. At the end of the
3666 ➡ 3667 list of completions, the bell is rung (subject to the setting of
3667 ➡ 3668 bbeellll--ssttyyllee) and the original text is restored. An argument of _n
3668
-
No equivalent source code line in the reference code can be identified.
- moves _n positions forward in the list of matches; a negative
3669
-
No equivalent source code line in the reference code can be identified.
- argument may be used to move backward through the list. This
3670
-
No equivalent source code line in the reference code can be identified.
- command is intended to be bound to TTAABB, but is unbound by
3669
-
+ moves _n positions forward in the list of matches; a negative
3670
-
+ argument may be used to move backward through the list. This
3671
-
+ command is intended to be bound to TTAABB, but is unbound by
3671 ➡ 3672 default.
3672 ➡ 3673 mmeennuu--ccoommpplleettee--bbaacckkwwaarrdd
3673
-
No equivalent source code line in the reference code can be identified.
- Identical to mmeennuu--ccoommpplleettee, but moves backward through the list
3674
-
No equivalent source code line in the reference code can be identified.
- of possible completions, as if mmeennuu--ccoommpplleettee had been given a
3674
-
+ Identical to mmeennuu--ccoommpplleettee, but moves backward through the list
3675
-
+ of possible completions, as if mmeennuu--ccoommpplleettee had been given a
3675 ➡ 3676 negative argument. This command is unbound by default.
3676 ➡ 3677 ddeelleettee--cchhaarr--oorr--lliisstt
3677
-
No equivalent source code line in the reference code can be identified.
- Deletes the character under the cursor if not at the beginning
3678
-
No equivalent source code line in the reference code can be identified.
- or end of the line (like ddeelleettee--cchhaarr). If at the end of the
3678
-
+ Deletes the character under the cursor if not at the beginning
3679
-
+ or end of the line (like ddeelleettee--cchhaarr). If at the end of the
3679 ➡ 3680 line, behaves identically to ppoossssiibbllee--ccoommpplleettiioonnss. This command
3680 ➡ 3681 is unbound by default.
3681 ➡ 3682 ccoommpplleettee--ffiilleennaammee ((MM--//))
@@ -3684,67 +3685,67 @@ RREEAADDLLIINNEE
3684 ➡ 3685 List the possible completions of the text before point, treating
3685 ➡ 3686 it as a filename.
3686 ➡ 3687 ccoommpplleettee--uusseerrnnaammee ((MM--~~))
3687
-
No equivalent source code line in the reference code can be identified.
- Attempt completion on the text before point, treating it as a
3688
-
+ Attempt completion on the text before point, treating it as a
3688 ➡ 3689 username.
3689 ➡ 3690 ppoossssiibbllee--uusseerrnnaammee--ccoommpplleettiioonnss ((CC--xx ~~))
3690 ➡ 3691 List the possible completions of the text before point, treating
3691 ➡ 3692 it as a username.
3692 ➡ 3693 ccoommpplleettee--vvaarriiaabbllee ((MM--$$))
3693
-
No equivalent source code line in the reference code can be identified.
- Attempt completion on the text before point, treating it as a
3694
-
+ Attempt completion on the text before point, treating it as a
3694 ➡ 3695 shell variable.
3695 ➡ 3696 ppoossssiibbllee--vvaarriiaabbllee--ccoommpplleettiioonnss ((CC--xx $$))
3696 ➡ 3697 List the possible completions of the text before point, treating
3697 ➡ 3698 it as a shell variable.
3698 ➡ 3699 ccoommpplleettee--hhoossttnnaammee ((MM--@@))
3699
-
No equivalent source code line in the reference code can be identified.
- Attempt completion on the text before point, treating it as a
3700
-
+ Attempt completion on the text before point, treating it as a
3700 ➡ 3701 hostname.
3701 ➡ 3702 ppoossssiibbllee--hhoossttnnaammee--ccoommpplleettiioonnss ((CC--xx @@))
3702 ➡ 3703 List the possible completions of the text before point, treating
3703 ➡ 3704 it as a hostname.
3704 ➡ 3705 ccoommpplleettee--ccoommmmaanndd ((MM--!!))
3705
-
No equivalent source code line in the reference code can be identified.
- Attempt completion on the text before point, treating it as a
3706
-
No equivalent source code line in the reference code can be identified.
- command name. Command completion attempts to match the text
3707
-
No equivalent source code line in the reference code can be identified.
- against aliases, reserved words, shell functions, shell
3706
-
+ Attempt completion on the text before point, treating it as a
3707
-
+ command name. Command completion attempts to match the text
3708
-
+ against aliases, reserved words, shell functions, shell
3708 ➡ 3709 builtins, and finally executable filenames, in that order.
3709 ➡ 3710 ppoossssiibbllee--ccoommmmaanndd--ccoommpplleettiioonnss ((CC--xx !!))
3710 ➡ 3711 List the possible completions of the text before point, treating
3711 ➡ 3712 it as a command name.
3712 ➡ 3713 ddyynnaammiicc--ccoommpplleettee--hhiissttoorryy ((MM--TTAABB))
3713
-
No equivalent source code line in the reference code can be identified.
- Attempt completion on the text before point, comparing the text
3714
-
No equivalent source code line in the reference code can be identified.
- against lines from the history list for possible completion
3714
-
+ Attempt completion on the text before point, comparing the text
3715
-
+ against lines from the history list for possible completion
3715 ➡ 3716 matches.
3716 ➡ 3717 ddaabbbbrreevv--eexxppaanndd
3717
-
No equivalent source code line in the reference code can be identified.
- Attempt menu completion on the text before point, comparing the
3718
-
+ Attempt menu completion on the text before point, comparing the
3718 ➡ 3719 text against lines from the history list for possible completion
3719 ➡ 3720 matches.
3720 ➡ 3721 ccoommpplleettee--iinnttoo--bbrraacceess ((MM--{{))
3721 ➡ 3722 Perform filename completion and insert the list of possible com-
3722
-
No equivalent source code line in the reference code can be identified.
- pletions enclosed within braces so the list is available to the
3723
-
+ pletions enclosed within braces so the list is available to the
3723 ➡ 3724 shell (see BBrraaccee EExxppaannssiioonn above).
3724 ➡ 3725
3725 ➡ 3726 KKeeyybbooaarrdd MMaaccrrooss
3726 ➡ 3727 ssttaarrtt--kkbbdd--mmaaccrroo ((CC--xx (())
3727
-
No equivalent source code line in the reference code can be identified.
- Begin saving the characters typed into the current keyboard
3728
-
+ Begin saving the characters typed into the current keyboard
3728 ➡ 3729 macro.
3729 ➡ 3730 eenndd--kkbbdd--mmaaccrroo ((CC--xx ))))
3730 ➡ 3731 Stop saving the characters typed into the current keyboard macro
3731 ➡ 3732 and store the definition.
3732 ➡ 3733 ccaallll--llaasstt--kkbbdd--mmaaccrroo ((CC--xx ee))
3733
-
No equivalent source code line in the reference code can be identified.
- Re-execute the last keyboard macro defined, by making the char-
3734
-
+ Re-execute the last keyboard macro defined, by making the char-
3734 ➡ 3735 acters in the macro appear as if typed at the keyboard.
3735 ➡ 3736 pprriinntt--llaasstt--kkbbdd--mmaaccrroo (())
3736
-
No equivalent source code line in the reference code can be identified.
- Print the last keyboard macro defined in a format suitable for
3737
-
+ Print the last keyboard macro defined in a format suitable for
3737 ➡ 3738 the _i_n_p_u_t_r_c file.
3738 ➡ 3739
3739 ➡ 3740 MMiisscceellllaanneeoouuss
3740 ➡ 3741 rree--rreeaadd--iinniitt--ffiillee ((CC--xx CC--rr))
3741
-
No equivalent source code line in the reference code can be identified.
- Read in the contents of the _i_n_p_u_t_r_c file, and incorporate any
3742
-
+ Read in the contents of the _i_n_p_u_t_r_c file, and incorporate any
3742 ➡ 3743 bindings or variable assignments found there.
3743 ➡ 3744 aabboorrtt ((CC--gg))
3744
-
No equivalent source code line in the reference code can be identified.
- Abort the current editing command and ring the terminal's bell
3745
-
+ Abort the current editing command and ring the terminal's bell
3745 ➡ 3746 (subject to the setting of bbeellll--ssttyyllee).
3746 ➡ 3747 ddoo--lloowweerrccaassee--vveerrssiioonn ((MM--AA,, MM--BB,, MM--_x,, ......))
3747
-
No equivalent source code line in the reference code can be identified.
- If the metafied character _x is uppercase, run the command that
3748
-
+ If the metafied character _x is uppercase, run the command that
3748 ➡ 3749 is bound to the corresponding metafied lowercase character. The
3749 ➡ 3750 behavior is undefined if _x is already lowercase.
3750 ➡ 3751 pprreeffiixx--mmeettaa ((EESSCC))
@@ -3752,196 +3753,196 @@ RREEAADDLLIINNEE
3752 ➡ 3753 uunnddoo ((CC--__,, CC--xx CC--uu))
3753 ➡ 3754 Incremental undo, separately remembered for each line.
3754 ➡ 3755 rreevveerrtt--lliinnee ((MM--rr))
3755
-
No equivalent source code line in the reference code can be identified.
- Undo all changes made to this line. This is like executing the
3756
-
No equivalent source code line in the reference code can be identified.
- uunnddoo command enough times to return the line to its initial
3756
-
+ Undo all changes made to this line. This is like executing the
3757
-
+ uunnddoo command enough times to return the line to its initial
3757 ➡ 3758 state.
3758 ➡ 3759 ttiillddee--eexxppaanndd ((MM--&&))
3759 ➡ 3760 Perform tilde expansion on the current word.
3760 ➡ 3761 sseett--mmaarrkk ((CC--@@,, MM--<<ssppaaccee>>))
3761
-
No equivalent source code line in the reference code can be identified.
- Set the mark to the point. If a numeric argument is supplied,
3762
-
+ Set the mark to the point. If a numeric argument is supplied,
3762 ➡ 3763 the mark is set to that position.
3763 ➡ 3764 eexxcchhaannggee--ppooiinntt--aanndd--mmaarrkk ((CC--xx CC--xx))
3764
-
No equivalent source code line in the reference code can be identified.
- Swap the point with the mark. The current cursor position is
3765
-
No equivalent source code line in the reference code can be identified.
- set to the saved position, and the old cursor position is saved
3765
-
+ Swap the point with the mark. The current cursor position is
3766
-
+ set to the saved position, and the old cursor position is saved
3766 ➡ 3767 as the mark.
3767 ➡ 3768 cchhaarraacctteerr--sseeaarrcchh ((CC--]]))
3768 ➡ 3769 A character is read and point is moved to the next occurrence of
3769
-
No equivalent source code line in the reference code can be identified.
- that character. A negative count searches for previous occur-
3770
-
+ that character. A negative count searches for previous occur-
3770 ➡ 3771 rences.
3771 ➡ 3772 cchhaarraacctteerr--sseeaarrcchh--bbaacckkwwaarrdd ((MM--CC--]]))
3772
-
No equivalent source code line in the reference code can be identified.
- A character is read and point is moved to the previous occur-
3773
-
No equivalent source code line in the reference code can be identified.
- rence of that character. A negative count searches for subse-
3773
-
+ A character is read and point is moved to the previous occur-
3774
-
+ rence of that character. A negative count searches for subse-
3774 ➡ 3775 quent occurrences.
3775 ➡ 3776 sskkiipp--ccssii--sseeqquueennccee
3776
-
No equivalent source code line in the reference code can be identified.
- Read enough characters to consume a multi-key sequence such as
3777
-
No equivalent source code line in the reference code can be identified.
- those defined for keys like Home and End. Such sequences begin
3777
-
+ Read enough characters to consume a multi-key sequence such as
3778
-
+ those defined for keys like Home and End. Such sequences begin
3778 ➡ 3779 with a Control Sequence Indicator (CSI), usually ESC-[. If this
3779
-
No equivalent source code line in the reference code can be identified.
- sequence is bound to "\[", keys producing such sequences will
3780
-
No equivalent source code line in the reference code can be identified.
- have no effect unless explicitly bound to a readline command,
3781
-
No equivalent source code line in the reference code can be identified.
- instead of inserting stray characters into the editing buffer.
3780
-
+ sequence is bound to "\[", keys producing such sequences will
3781
-
+ have no effect unless explicitly bound to a readline command,
3782
-
+ instead of inserting stray characters into the editing buffer.
3782 ➡ 3783 This is unbound by default, but usually bound to ESC-[.
3783 ➡ 3784 iinnsseerrtt--ccoommmmeenntt ((MM--##))
3784
-
No equivalent source code line in the reference code can be identified.
- Without a numeric argument, the value of the readline ccoomm--
3785
-
No equivalent source code line in the reference code can be identified.
- mmeenntt--bbeeggiinn variable is inserted at the beginning of the current
3785
-
+ Without a numeric argument, the value of the readline ccoomm--
3786
-
+ mmeenntt--bbeeggiinn variable is inserted at the beginning of the current
3786 ➡ 3787 line. If a numeric argument is supplied, this command acts as a
3787
-
No equivalent source code line in the reference code can be identified.
- toggle: if the characters at the beginning of the line do not
3788
-
No equivalent source code line in the reference code can be identified.
- match the value of ccoommmmeenntt--bbeeggiinn, the value is inserted, other-
3788
-
+ toggle: if the characters at the beginning of the line do not
3789
-
+ match the value of ccoommmmeenntt--bbeeggiinn, the value is inserted, other-
3789 ➡ 3790 wise the characters in ccoommmmeenntt--bbeeggiinn are deleted from the begin-
3790
-
No equivalent source code line in the reference code can be identified.
- ning of the line. In either case, the line is accepted as if a
3791
-
No equivalent source code line in the reference code can be identified.
- newline had been typed. The default value of ccoommmmeenntt--bbeeggiinn
3792
-
No equivalent source code line in the reference code can be identified.
- causes this command to make the current line a shell comment.
3793
-
No equivalent source code line in the reference code can be identified.
- If a numeric argument causes the comment character to be
3791
-
+ ning of the line. In either case, the line is accepted as if a
3792
-
+ newline had been typed. The default value of ccoommmmeenntt--bbeeggiinn
3793
-
+ causes this command to make the current line a shell comment.
3794
-
+ If a numeric argument causes the comment character to be
3794 ➡ 3795 removed, the line will be executed by the shell.
3795 ➡ 3796 gglloobb--ccoommpplleettee--wwoorrdd ((MM--gg))
3796
-
No equivalent source code line in the reference code can be identified.
- The word before point is treated as a pattern for pathname
3797
-
No equivalent source code line in the reference code can be identified.
- expansion, with an asterisk implicitly appended. This pattern
3798
-
No equivalent source code line in the reference code can be identified.
- is used to generate a list of matching filenames for possible
3797
-
+ The word before point is treated as a pattern for pathname
3798
-
+ expansion, with an asterisk implicitly appended. This pattern
3799
-
+ is used to generate a list of matching filenames for possible
3799 ➡ 3800 completions.
3800 ➡ 3801 gglloobb--eexxppaanndd--wwoorrdd ((CC--xx **))
3801
-
No equivalent source code line in the reference code can be identified.
- The word before point is treated as a pattern for pathname
3802
-
No equivalent source code line in the reference code can be identified.
- expansion, and the list of matching filenames is inserted,
3803
-
No equivalent source code line in the reference code can be identified.
- replacing the word. If a numeric argument is supplied, an
3802
-
+ The word before point is treated as a pattern for pathname
3803
-
+ expansion, and the list of matching filenames is inserted,
3804
-
+ replacing the word. If a numeric argument is supplied, an
3804 ➡ 3805 asterisk is appended before pathname expansion.
3805 ➡ 3806 gglloobb--lliisstt--eexxppaannssiioonnss ((CC--xx gg))
3806
-
No equivalent source code line in the reference code can be identified.
- The list of expansions that would have been generated by
3807
-
No equivalent source code line in the reference code can be identified.
- gglloobb--eexxppaanndd--wwoorrdd is displayed, and the line is redrawn. If a
3808
-
No equivalent source code line in the reference code can be identified.
- numeric argument is supplied, an asterisk is appended before
3807
-
+ The list of expansions that would have been generated by
3808
-
+ gglloobb--eexxppaanndd--wwoorrdd is displayed, and the line is redrawn. If a
3809
-
+ numeric argument is supplied, an asterisk is appended before
3809 ➡ 3810 pathname expansion.
3810 ➡ 3811 dduummpp--ffuunnccttiioonnss
3811
-
No equivalent source code line in the reference code can be identified.
- Print all of the functions and their key bindings to the read-
3812
-
+ Print all of the functions and their key bindings to the read-
3812 ➡ 3813 line output stream. If a numeric argument is supplied, the out-
3813
-
No equivalent source code line in the reference code can be identified.
- put is formatted in such a way that it can be made part of an
3814
-
+ put is formatted in such a way that it can be made part of an
3814 ➡ 3815 _i_n_p_u_t_r_c file.
3815 ➡ 3816 dduummpp--vvaarriiaabblleess
3816 ➡ 3817 Print all of the settable readline variables and their values to
3817
-
No equivalent source code line in the reference code can be identified.
- the readline output stream. If a numeric argument is supplied,
3818
-
No equivalent source code line in the reference code can be identified.
- the output is formatted in such a way that it can be made part
3818
-
+ the readline output stream. If a numeric argument is supplied,
3819
-
+ the output is formatted in such a way that it can be made part
3819 ➡ 3820 of an _i_n_p_u_t_r_c file.
3820 ➡ 3821 dduummpp--mmaaccrrooss
3821
-
No equivalent source code line in the reference code can be identified.
- Print all of the readline key sequences bound to macros and the
3822
-
No equivalent source code line in the reference code can be identified.
- strings they output. If a numeric argument is supplied, the
3822
-
+ Print all of the readline key sequences bound to macros and the
3823
-
+ strings they output. If a numeric argument is supplied, the
3823 ➡ 3824 output is formatted in such a way that it can be made part of an
3824 ➡ 3825 _i_n_p_u_t_r_c file.
3825 ➡ 3826 ddiissppllaayy--sshheellll--vveerrssiioonn ((CC--xx CC--vv))
3826 ➡ 3827 Display version information about the current instance of bbaasshh.
3827 ➡ 3828
3828 ➡ 3829 PPrrooggrraammmmaabbllee CCoommpplleettiioonn
3829
-
No equivalent source code line in the reference code can be identified.
- When word completion is attempted for an argument to a command for
3830
-
No equivalent source code line in the reference code can be identified.
- which a completion specification (a _c_o_m_p_s_p_e_c) has been defined using
3831
-
No equivalent source code line in the reference code can be identified.
- the ccoommpplleettee builtin (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below), the program-
3830
-
+ When word completion is attempted for an argument to a command for
3831
-
+ which a completion specification (a _c_o_m_p_s_p_e_c) has been defined using
3832
-
+ the ccoommpplleettee builtin (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below), the program-
3832 ➡ 3833 mable completion facilities are invoked.
3833 ➡ 3834
3834
-
No equivalent source code line in the reference code can be identified.
- First, the command name is identified. If the command word is the
3835
-
No equivalent source code line in the reference code can be identified.
- empty string (completion attempted at the beginning of an empty line),
3836
-
No equivalent source code line in the reference code can be identified.
- any compspec defined with the --EE option to ccoommpplleettee is used. If a
3837
-
No equivalent source code line in the reference code can be identified.
- compspec has been defined for that command, the compspec is used to
3835
-
+ First, the command name is identified. If the command word is the
3836
-
+ empty string (completion attempted at the beginning of an empty line),
3837
-
+ any compspec defined with the --EE option to ccoommpplleettee is used. If a
3838
-
+ compspec has been defined for that command, the compspec is used to
3838 ➡ 3839 generate the list of possible completions for the word. If the command
3839
-
No equivalent source code line in the reference code can be identified.
- word is a full pathname, a compspec for the full pathname is searched
3840
-
No equivalent source code line in the reference code can be identified.
- for first. If no compspec is found for the full pathname, an attempt
3841
-
No equivalent source code line in the reference code can be identified.
- is made to find a compspec for the portion following the final slash.
3842
-
No equivalent source code line in the reference code can be identified.
- If those searches do not result in a compspec, any compspec defined
3840
-
+ word is a full pathname, a compspec for the full pathname is searched
3841
-
+ for first. If no compspec is found for the full pathname, an attempt
3842
-
+ is made to find a compspec for the portion following the final slash.
3843
-
+ If those searches do not result in a compspec, any compspec defined
3843 ➡ 3844 with the --DD option to ccoommpplleettee is used as the default.
3844 ➡ 3845
3845
-
No equivalent source code line in the reference code can be identified.
- Once a compspec has been found, it is used to generate the list of
3846
-
No equivalent source code line in the reference code can be identified.
- matching words. If a compspec is not found, the default bbaasshh comple-
3846
-
+ Once a compspec has been found, it is used to generate the list of
3847
-
+ matching words. If a compspec is not found, the default bbaasshh comple-
3847 ➡ 3848 tion as described above under CCoommpplleettiinngg is performed.
3848 ➡ 3849
3849
-
No equivalent source code line in the reference code can be identified.
- First, the actions specified by the compspec are used. Only matches
3850
-
No equivalent source code line in the reference code can be identified.
- which are prefixed by the word being completed are returned. When the
3851
-
No equivalent source code line in the reference code can be identified.
- --ff or --dd option is used for filename or directory name completion, the
3850
-
+ First, the actions specified by the compspec are used. Only matches
3851
-
+ which are prefixed by the word being completed are returned. When the
3852
-
+ --ff or --dd option is used for filename or directory name completion, the
3852 ➡ 3853 shell variable FFIIGGNNOORREE is used to filter the matches.
3853 ➡ 3854
3854
-
No equivalent source code line in the reference code can be identified.
- Any completions specified by a pathname expansion pattern to the --GG
3855
-
+ Any completions specified by a pathname expansion pattern to the --GG
3855 ➡ 3856 option are generated next. The words generated by the pattern need not
3856
-
No equivalent source code line in the reference code can be identified.
- match the word being completed. The GGLLOOBBIIGGNNOORREE shell variable is not
3857
-
+ match the word being completed. The GGLLOOBBIIGGNNOORREE shell variable is not
3857 ➡ 3858 used to filter the matches, but the FFIIGGNNOORREE variable is used.
3858 ➡ 3859
3859
-
No equivalent source code line in the reference code can be identified.
- Next, the string specified as the argument to the --WW option is consid-
3860
-
No equivalent source code line in the reference code can be identified.
- ered. The string is first split using the characters in the IIFFSS spe-
3861
-
No equivalent source code line in the reference code can be identified.
- cial variable as delimiters. Shell quoting is honored. Each word is
3862
-
No equivalent source code line in the reference code can be identified.
- then expanded using brace expansion, tilde expansion, parameter and
3863
-
No equivalent source code line in the reference code can be identified.
- variable expansion, command substitution, and arithmetic expansion, as
3860
-
+ Next, the string specified as the argument to the --WW option is consid-
3861
-
+ ered. The string is first split using the characters in the IIFFSS spe-
3862
-
+ cial variable as delimiters. Shell quoting is honored. Each word is
3863
-
+ then expanded using brace expansion, tilde expansion, parameter and
3864
-
+ variable expansion, command substitution, and arithmetic expansion, as
3864 ➡ 3865 described above under EEXXPPAANNSSIIOONN. The results are split using the rules
3865 ➡ 3866 described above under WWoorrdd SSpplliittttiinngg. The results of the expansion are
3866 ➡ 3867 prefix-matched against the word being completed, and the matching words
3867 ➡ 3868 become the possible completions.
3868 ➡ 3869
3869
-
No equivalent source code line in the reference code can be identified.
- After these matches have been generated, any shell function or command
3870
-
No equivalent source code line in the reference code can be identified.
- specified with the --FF and --CC options is invoked. When the command or
3870
-
+ After these matches have been generated, any shell function or command
3871
-
+ specified with the --FF and --CC options is invoked. When the command or
3871 ➡ 3872 function is invoked, the CCOOMMPP__LLIINNEE, CCOOMMPP__PPOOIINNTT, CCOOMMPP__KKEEYY, and CCOOMMPP__TTYYPPEE
3872 ➡ 3873 variables are assigned values as described above under SShheellll VVaarriiaabblleess.
3873
-
No equivalent source code line in the reference code can be identified.
- If a shell function is being invoked, the CCOOMMPP__WWOORRDDSS and CCOOMMPP__CCWWOORRDD
3874
-
No equivalent source code line in the reference code can be identified.
- variables are also set. When the function or command is invoked, the
3875
-
No equivalent source code line in the reference code can be identified.
- first argument ($$11) is the name of the command whose arguments are
3876
-
No equivalent source code line in the reference code can be identified.
- being completed, the second argument ($$22) is the word being completed,
3877
-
No equivalent source code line in the reference code can be identified.
- and the third argument ($$33) is the word preceding the word being com-
3874
-
+ If a shell function is being invoked, the CCOOMMPP__WWOORRDDSS and CCOOMMPP__CCWWOORRDD
3875
-
+ variables are also set. When the function or command is invoked, the
3876
-
+ first argument ($$11) is the name of the command whose arguments are
3877
-
+ being completed, the second argument ($$22) is the word being completed,
3878
-
+ and the third argument ($$33) is the word preceding the word being com-
3878 ➡ 3879 pleted on the current command line. No filtering of the generated com-
3879 ➡ 3880 pletions against the word being completed is performed; the function or
3880 ➡ 3881 command has complete freedom in generating the matches.
3881 ➡ 3882
3882
-
No equivalent source code line in the reference code can be identified.
- Any function specified with --FF is invoked first. The function may use
3883
-
No equivalent source code line in the reference code can be identified.
- any of the shell facilities, including the ccoommppggeenn builtin described
3884
-
No equivalent source code line in the reference code can be identified.
- below, to generate the matches. It must put the possible completions
3883
-
+ Any function specified with --FF is invoked first. The function may use
3884
-
+ any of the shell facilities, including the ccoommppggeenn builtin described
3885
-
+ below, to generate the matches. It must put the possible completions
3885 ➡ 3886 in the CCOOMMPPRREEPPLLYY array variable, one per array element.
3886 ➡ 3887
3887
-
No equivalent source code line in the reference code can be identified.
- Next, any command specified with the --CC option is invoked in an envi-
3888
-
No equivalent source code line in the reference code can be identified.
- ronment equivalent to command substitution. It should print a list of
3889
-
No equivalent source code line in the reference code can be identified.
- completions, one per line, to the standard output. Backslash may be
3888
-
+ Next, any command specified with the --CC option is invoked in an envi-
3889
-
+ ronment equivalent to command substitution. It should print a list of
3890
-
+ completions, one per line, to the standard output. Backslash may be
3890 ➡ 3891 used to escape a newline, if necessary.
3891 ➡ 3892
3892
-
No equivalent source code line in the reference code can be identified.
- After all of the possible completions are generated, any filter speci-
3893
-
No equivalent source code line in the reference code can be identified.
- fied with the --XX option is applied to the list. The filter is a pat-
3894
-
No equivalent source code line in the reference code can be identified.
- tern as used for pathname expansion; a && in the pattern is replaced
3895
-
No equivalent source code line in the reference code can be identified.
- with the text of the word being completed. A literal && may be escaped
3896
-
No equivalent source code line in the reference code can be identified.
- with a backslash; the backslash is removed before attempting a match.
3897
-
No equivalent source code line in the reference code can be identified.
- Any completion that matches the pattern will be removed from the list.
3893
-
+ After all of the possible completions are generated, any filter speci-
3894
-
+ fied with the --XX option is applied to the list. The filter is a pat-
3895
-
+ tern as used for pathname expansion; a && in the pattern is replaced
3896
-
+ with the text of the word being completed. A literal && may be escaped
3897
-
+ with a backslash; the backslash is removed before attempting a match.
3898
-
+ Any completion that matches the pattern will be removed from the list.
3898 ➡ 3899 A leading !! negates the pattern; in this case any completion not match-
3899
-
No equivalent source code line in the reference code can be identified.
- ing the pattern will be removed. If the nnooccaasseemmaattcchh shell option is
3900
-
No equivalent source code line in the reference code can be identified.
- enabled, the match is performed without regard to the case of alpha-
3900
-
+ ing the pattern will be removed. If the nnooccaasseemmaattcchh shell option is
3901
-
+ enabled, the match is performed without regard to the case of alpha-
3901 ➡ 3902 betic characters.
3902 ➡ 3903
3903 ➡ 3904 Finally, any prefix and suffix specified with the --PP and --SS options are
3904 ➡ 3905 added to each member of the completion list, and the result is returned
3905 ➡ 3906 to the readline completion code as the list of possible completions.
3906 ➡ 3907
3907
-
No equivalent source code line in the reference code can be identified.
- If the previously-applied actions do not generate any matches, and the
3908
-
No equivalent source code line in the reference code can be identified.
- --oo ddiirrnnaammeess option was supplied to ccoommpplleettee when the compspec was
3908
-
+ If the previously-applied actions do not generate any matches, and the
3909
-
+ --oo ddiirrnnaammeess option was supplied to ccoommpplleettee when the compspec was
3909 ➡ 3910 defined, directory name completion is attempted.
3910 ➡ 3911
3911
-
No equivalent source code line in the reference code can be identified.
- If the --oo pplluussddiirrss option was supplied to ccoommpplleettee when the compspec
3912
-
+ If the --oo pplluussddiirrss option was supplied to ccoommpplleettee when the compspec
3912 ➡ 3913 was defined, directory name completion is attempted and any matches are
3913 ➡ 3914 added to the results of the other actions.
3914 ➡ 3915
3915
-
No equivalent source code line in the reference code can be identified.
- By default, if a compspec is found, whatever it generates is returned
3916
-
No equivalent source code line in the reference code can be identified.
- to the completion code as the full set of possible completions. The
3916
-
+ By default, if a compspec is found, whatever it generates is returned
3917
-
+ to the completion code as the full set of possible completions. The
3917 ➡ 3918 default bbaasshh completions are not attempted, and the readline default of
3918 ➡ 3919 filename completion is disabled. If the --oo bbaasshhddeeffaauulltt option was sup-
3919
-
No equivalent source code line in the reference code can be identified.
- plied to ccoommpplleettee when the compspec was defined, the bbaasshh default com-
3920
-
+ plied to ccoommpplleettee when the compspec was defined, the bbaasshh default com-
3920 ➡ 3921 pletions are attempted if the compspec generates no matches. If the --oo
3921
-
No equivalent source code line in the reference code can be identified.
- ddeeffaauulltt option was supplied to ccoommpplleettee when the compspec was defined,
3922
-
No equivalent source code line in the reference code can be identified.
- readline's default completion will be performed if the compspec (and,
3922
-
+ ddeeffaauulltt option was supplied to ccoommpplleettee when the compspec was defined,
3923
-
+ readline's default completion will be performed if the compspec (and,
3923 ➡ 3924 if attempted, the default bbaasshh completions) generate no matches.
3924 ➡ 3925
3925
-
No equivalent source code line in the reference code can be identified.
- When a compspec indicates that directory name completion is desired,
3926
-
No equivalent source code line in the reference code can be identified.
- the programmable completion functions force readline to append a slash
3927
-
No equivalent source code line in the reference code can be identified.
- to completed names which are symbolic links to directories, subject to
3928
-
No equivalent source code line in the reference code can be identified.
- the value of the mmaarrkk--ddiirreeccttoorriieess readline variable, regardless of the
3926
-
+ When a compspec indicates that directory name completion is desired,
3927
-
+ the programmable completion functions force readline to append a slash
3928
-
+ to completed names which are symbolic links to directories, subject to
3929
-
+ the value of the mmaarrkk--ddiirreeccttoorriieess readline variable, regardless of the
3929 ➡ 3930 setting of the mmaarrkk--ssyymmlliinnkkeedd--ddiirreeccttoorriieess readline variable.
3930 ➡ 3931
3931
-
No equivalent source code line in the reference code can be identified.
- There is some support for dynamically modifying completions. This is
3932
-
No equivalent source code line in the reference code can be identified.
- most useful when used in combination with a default completion speci-
3933
-
No equivalent source code line in the reference code can be identified.
- fied with ccoommpplleettee --DD. It's possible for shell functions executed as
3934
-
No equivalent source code line in the reference code can be identified.
- completion handlers to indicate that completion should be retried by
3935
-
No equivalent source code line in the reference code can be identified.
- returning an exit status of 124. If a shell function returns 124, and
3932
-
+ There is some support for dynamically modifying completions. This is
3933
-
+ most useful when used in combination with a default completion speci-
3934
-
+ fied with ccoommpplleettee --DD. It's possible for shell functions executed as
3935
-
+ completion handlers to indicate that completion should be retried by
3936
-
+ returning an exit status of 124. If a shell function returns 124, and
3936 ➡ 3937 changes the compspec associated with the command on which completion is
3937
-
No equivalent source code line in the reference code can be identified.
- being attempted (supplied as the first argument when the function is
3938
-
+ being attempted (supplied as the first argument when the function is
3938 ➡ 3939 executed), programmable completion restarts from the beginning, with an
3939
-
No equivalent source code line in the reference code can be identified.
- attempt to find a new compspec for that command. This allows a set of
3940
-
No equivalent source code line in the reference code can be identified.
- completions to be built dynamically as completion is attempted, rather
3940
-
+ attempt to find a new compspec for that command. This allows a set of
3941
-
+ completions to be built dynamically as completion is attempted, rather
3941 ➡ 3942 than being loaded all at once.
3942 ➡ 3943
3943
-
No equivalent source code line in the reference code can be identified.
- For instance, assuming that there is a library of compspecs, each kept
3944
-
No equivalent source code line in the reference code can be identified.
- in a file corresponding to the name of the command, the following
3944
-
+ For instance, assuming that there is a library of compspecs, each kept
3945
-
+ in a file corresponding to the name of the command, the following
3945 ➡ 3946 default completion function would load completions dynamically:
3946 ➡ 3947
3947 ➡ 3948 _completion_loader()
@@ -3952,162 +3953,162 @@ RREEAADDLLIINNEE
3952 ➡ 3953
3953 ➡ 3954
3954 ➡ 3955 HHIISSTTOORRYY
3955
-
No equivalent source code line in the reference code can be identified.
- When the --oo hhiissttoorryy option to the sseett builtin is enabled, the shell
3956
-
+ When the --oo hhiissttoorryy option to the sseett builtin is enabled, the shell
3956 ➡ 3957 provides access to the _c_o_m_m_a_n_d _h_i_s_t_o_r_y, the list of commands previously
3957
-
No equivalent source code line in the reference code can be identified.
- typed. The value of the HHIISSTTSSIIZZEE variable is used as the number of
3958
-
+ typed. The value of the HHIISSTTSSIIZZEE variable is used as the number of
3958 ➡ 3959 commands to save in a history list. The text of the last HHIISSTTSSIIZZEE com-
3959
-
No equivalent source code line in the reference code can be identified.
- mands (default 500) is saved. The shell stores each command in the
3960
-
No equivalent source code line in the reference code can be identified.
- history list prior to parameter and variable expansion (see EEXXPPAANNSSIIOONN
3961
-
No equivalent source code line in the reference code can be identified.
- above) but after history expansion is performed, subject to the values
3960
-
+ mands (default 500) is saved. The shell stores each command in the
3961
-
+ history list prior to parameter and variable expansion (see EEXXPPAANNSSIIOONN
3962
-
+ above) but after history expansion is performed, subject to the values
3962 ➡ 3963 of the shell variables HHIISSTTIIGGNNOORREE and HHIISSTTCCOONNTTRROOLL.
3963 ➡ 3964
3964 ➡ 3965 On startup, the history is initialized from the file named by the vari-
3965
-
No equivalent source code line in the reference code can be identified.
- able HHIISSTTFFIILLEE (default _~_/_._b_a_s_h___h_i_s_t_o_r_y). The file named by the value
3966
-
No equivalent source code line in the reference code can be identified.
- of HHIISSTTFFIILLEE is truncated, if necessary, to contain no more than the
3967
-
No equivalent source code line in the reference code can be identified.
- number of lines specified by the value of HHIISSTTFFIILLEESSIIZZEE. If HHIISSTTFFIILLEE--
3968
-
No equivalent source code line in the reference code can be identified.
- SSIIZZEE is unset, or set to null, a non-numeric value, or a numeric value
3969
-
No equivalent source code line in the reference code can be identified.
- less than zero, the history file is not truncated. When the history
3970
-
No equivalent source code line in the reference code can be identified.
- file is read, lines beginning with the history comment character fol-
3966
-
+ able HHIISSTTFFIILLEE (default _~_/_._b_a_s_h___h_i_s_t_o_r_y). The file named by the value
3967
-
+ of HHIISSTTFFIILLEE is truncated, if necessary, to contain no more than the
3968
-
+ number of lines specified by the value of HHIISSTTFFIILLEESSIIZZEE. If HHIISSTTFFIILLEE--
3969
-
+ SSIIZZEE is unset, or set to null, a non-numeric value, or a numeric value
3970
-
+ less than zero, the history file is not truncated. When the history
3971
-
+ file is read, lines beginning with the history comment character fol-
3971 ➡ 3972 lowed immediately by a digit are interpreted as timestamps for the fol-
3972 ➡ 3973 lowing history line. These timestamps are optionally displayed depend-
3973
-
No equivalent source code line in the reference code can be identified.
- ing on the value of the HHIISSTTTTIIMMEEFFOORRMMAATT variable. When a shell with
3974
-
No equivalent source code line in the reference code can be identified.
- history enabled exits, the last $$HHIISSTTSSIIZZEE lines are copied from the
3975
-
No equivalent source code line in the reference code can be identified.
- history list to $$HHIISSTTFFIILLEE. If the hhiissttaappppeenndd shell option is enabled
3976
-
No equivalent source code line in the reference code can be identified.
- (see the description of sshhoopptt under SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below), the
3977
-
No equivalent source code line in the reference code can be identified.
- lines are appended to the history file, otherwise the history file is
3974
-
+ ing on the value of the HHIISSTTTTIIMMEEFFOORRMMAATT variable. When a shell with
3975
-
+ history enabled exits, the last $$HHIISSTTSSIIZZEE lines are copied from the
3976
-
+ history list to $$HHIISSTTFFIILLEE. If the hhiissttaappppeenndd shell option is enabled
3977
-
+ (see the description of sshhoopptt under SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below), the
3978
-
+ lines are appended to the history file, otherwise the history file is
3978 ➡ 3979 overwritten. If HHIISSTTFFIILLEE is unset, or if the history file is
3979
-
No equivalent source code line in the reference code can be identified.
- unwritable, the history is not saved. If the HHIISSTTTTIIMMEEFFOORRMMAATT variable
3980
-
No equivalent source code line in the reference code can be identified.
- is set, time stamps are written to the history file, marked with the
3981
-
No equivalent source code line in the reference code can be identified.
- history comment character, so they may be preserved across shell ses-
3982
-
No equivalent source code line in the reference code can be identified.
- sions. This uses the history comment character to distinguish time-
3980
-
+ unwritable, the history is not saved. If the HHIISSTTTTIIMMEEFFOORRMMAATT variable
3981
-
+ is set, time stamps are written to the history file, marked with the
3982
-
+ history comment character, so they may be preserved across shell ses-
3983
-
+ sions. This uses the history comment character to distinguish time-
3983 ➡ 3984 stamps from other history lines. After saving the history, the history
3984 ➡ 3985 file is truncated to contain no more than HHIISSTTFFIILLEESSIIZZEE lines. If HHIISSTT--
3985
-
No equivalent source code line in the reference code can be identified.
- FFIILLEESSIIZZEE is unset, or set to null, a non-numeric value, or a numeric
3986
-
+ FFIILLEESSIIZZEE is unset, or set to null, a non-numeric value, or a numeric
3986 ➡ 3987 value less than zero, the history file is not truncated.
3987 ➡ 3988
3988
-
No equivalent source code line in the reference code can be identified.
- The builtin command ffcc (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below) may be used
3989
-
+ The builtin command ffcc (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below) may be used
3989 ➡ 3990 to list or edit and re-execute a portion of the history list. The hhiiss--
3990
-
No equivalent source code line in the reference code can be identified.
- ttoorryy builtin may be used to display or modify the history list and
3991
-
No equivalent source code line in the reference code can be identified.
- manipulate the history file. When using command-line editing, search
3992
-
No equivalent source code line in the reference code can be identified.
- commands are available in each editing mode that provide access to the
3991
-
+ ttoorryy builtin may be used to display or modify the history list and
3992
-
+ manipulate the history file. When using command-line editing, search
3993
-
+ commands are available in each editing mode that provide access to the
3993 ➡ 3994 history list.
3994 ➡ 3995
3995
-
No equivalent source code line in the reference code can be identified.
- The shell allows control over which commands are saved on the history
3996
-
+ The shell allows control over which commands are saved on the history
3996 ➡ 3997 list. The HHIISSTTCCOONNTTRROOLL and HHIISSTTIIGGNNOORREE variables may be set to cause the
3997 ➡ 3998 shell to save only a subset of the commands entered. The ccmmddhhiisstt shell
3998
-
No equivalent source code line in the reference code can be identified.
- option, if enabled, causes the shell to attempt to save each line of a
3999
-
No equivalent source code line in the reference code can be identified.
- multi-line command in the same history entry, adding semicolons where
4000
-
No equivalent source code line in the reference code can be identified.
- necessary to preserve syntactic correctness. The lliitthhiisstt shell option
4001
-
No equivalent source code line in the reference code can be identified.
- causes the shell to save the command with embedded newlines instead of
3999
-
+ option, if enabled, causes the shell to attempt to save each line of a
4000
-
+ multi-line command in the same history entry, adding semicolons where
4001
-
+ necessary to preserve syntactic correctness. The lliitthhiisstt shell option
4002
-
+ causes the shell to save the command with embedded newlines instead of
4002 ➡ 4003 semicolons. See the description of the sshhoopptt builtin below under SSHHEELLLL
4003 ➡ 4004 BBUUIILLTTIINN CCOOMMMMAANNDDSS for information on setting and unsetting shell
4004 ➡ 4005 options.
4005 ➡ 4006
4006 ➡ 4007 HHIISSTTOORRYY EEXXPPAANNSSIIOONN
4007
-
No equivalent source code line in the reference code can be identified.
- The shell supports a history expansion feature that is similar to the
4008
-
No equivalent source code line in the reference code can be identified.
- history expansion in ccsshh.. This section describes what syntax features
4009
-
No equivalent source code line in the reference code can be identified.
- are available. This feature is enabled by default for interactive
4008
-
+ The shell supports a history expansion feature that is similar to the
4009
-
+ history expansion in ccsshh.. This section describes what syntax features
4010
-
+ are available. This feature is enabled by default for interactive
4010 ➡ 4011 shells, and can be disabled using the ++HH option to the sseett builtin com-
4011 ➡ 4012 mand (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below). Non-interactive shells do not
4012 ➡ 4013 perform history expansion by default.
4013 ➡ 4014
4014 ➡ 4015 History expansions introduce words from the history list into the input
4015
-
No equivalent source code line in the reference code can be identified.
- stream, making it easy to repeat commands, insert the arguments to a
4016
-
+ stream, making it easy to repeat commands, insert the arguments to a
4016 ➡ 4017 previous command into the current input line, or fix errors in previous
4017 ➡ 4018 commands quickly.
4018 ➡ 4019
4019
-
No equivalent source code line in the reference code can be identified.
- History expansion is performed immediately after a complete line is
4020
-
No equivalent source code line in the reference code can be identified.
- read, before the shell breaks it into words, and is performed on each
4020
-
+ History expansion is performed immediately after a complete line is
4021
-
+ read, before the shell breaks it into words, and is performed on each
4021 ➡ 4022 line individually without taking quoting on previous lines into
4022 ➡ 4023 account. It takes place in two parts. The first is to determine which
4023
-
No equivalent source code line in the reference code can be identified.
- line from the history list to use during substitution. The second is
4024
-
No equivalent source code line in the reference code can be identified.
- to select portions of that line for inclusion into the current one.
4025
-
No equivalent source code line in the reference code can be identified.
- The line selected from the history is the _e_v_e_n_t, and the portions of
4026
-
No equivalent source code line in the reference code can be identified.
- that line that are acted upon are _w_o_r_d_s. Various _m_o_d_i_f_i_e_r_s are avail-
4027
-
No equivalent source code line in the reference code can be identified.
- able to manipulate the selected words. The line is broken into words
4028
-
No equivalent source code line in the reference code can be identified.
- in the same fashion as when reading input, so that several _m_e_t_a_c_h_a_r_a_c_-
4024
-
+ line from the history list to use during substitution. The second is
4025
-
+ to select portions of that line for inclusion into the current one.
4026
-
+ The line selected from the history is the _e_v_e_n_t, and the portions of
4027
-
+ that line that are acted upon are _w_o_r_d_s. Various _m_o_d_i_f_i_e_r_s are avail-
4028
-
+ able to manipulate the selected words. The line is broken into words
4029
-
+ in the same fashion as when reading input, so that several _m_e_t_a_c_h_a_r_a_c_-
4029 ➡ 4030 _t_e_r-separated words surrounded by quotes are considered one word. His-
4030
-
No equivalent source code line in the reference code can be identified.
- tory expansions are introduced by the appearance of the history expan-
4031
-
No equivalent source code line in the reference code can be identified.
- sion character, which is !! by default. Only backslash (\\) and single
4032
-
No equivalent source code line in the reference code can be identified.
- quotes can quote the history expansion character, but the history
4033
-
No equivalent source code line in the reference code can be identified.
- expansion character is also treated as quoted if it immediately pre-
4031
-
+ tory expansions are introduced by the appearance of the history expan-
4032
-
+ sion character, which is !! by default. Only backslash (\\) and single
4033
-
+ quotes can quote the history expansion character, but the history
4034
-
+ expansion character is also treated as quoted if it immediately pre-
4034 ➡ 4035 cedes the closing double quote in a double-quoted string.
4035 ➡ 4036
4036
-
No equivalent source code line in the reference code can be identified.
- Several characters inhibit history expansion if found immediately fol-
4037
-
No equivalent source code line in the reference code can be identified.
- lowing the history expansion character, even if it is unquoted: space,
4038
-
No equivalent source code line in the reference code can be identified.
- tab, newline, carriage return, and ==. If the eexxttgglloobb shell option is
4037
-
+ Several characters inhibit history expansion if found immediately fol-
4038
-
+ lowing the history expansion character, even if it is unquoted: space,
4039
-
+ tab, newline, carriage return, and ==. If the eexxttgglloobb shell option is
4039 ➡ 4040 enabled, (( will also inhibit expansion.
4040 ➡ 4041
4041
-
No equivalent source code line in the reference code can be identified.
- Several shell options settable with the sshhoopptt builtin may be used to
4042
-
No equivalent source code line in the reference code can be identified.
- tailor the behavior of history expansion. If the hhiissttvveerriiffyy shell
4042
-
+ Several shell options settable with the sshhoopptt builtin may be used to
4043
-
+ tailor the behavior of history expansion. If the hhiissttvveerriiffyy shell
4043 ➡ 4044 option is enabled (see the description of the sshhoopptt builtin below), and
4044
-
No equivalent source code line in the reference code can be identified.
- rreeaaddlliinnee is being used, history substitutions are not immediately
4045
-
No equivalent source code line in the reference code can be identified.
- passed to the shell parser. Instead, the expanded line is reloaded
4045
-
+ rreeaaddlliinnee is being used, history substitutions are not immediately
4046
-
+ passed to the shell parser. Instead, the expanded line is reloaded
4046 ➡ 4047 into the rreeaaddlliinnee editing buffer for further modification. If rreeaaddlliinnee
4047
-
No equivalent source code line in the reference code can be identified.
- is being used, and the hhiissttrreeeeddiitt shell option is enabled, a failed
4048
-
No equivalent source code line in the reference code can be identified.
- history substitution will be reloaded into the rreeaaddlliinnee editing buffer
4049
-
No equivalent source code line in the reference code can be identified.
- for correction. The --pp option to the hhiissttoorryy builtin command may be
4050
-
No equivalent source code line in the reference code can be identified.
- used to see what a history expansion will do before using it. The --ss
4048
-
+ is being used, and the hhiissttrreeeeddiitt shell option is enabled, a failed
4049
-
+ history substitution will be reloaded into the rreeaaddlliinnee editing buffer
4050
-
+ for correction. The --pp option to the hhiissttoorryy builtin command may be
4051
-
+ used to see what a history expansion will do before using it. The --ss
4051 ➡ 4052 option to the hhiissttoorryy builtin may be used to add commands to the end of
4052
-
No equivalent source code line in the reference code can be identified.
- the history list without actually executing them, so that they are
4053
-
+ the history list without actually executing them, so that they are
4053 ➡ 4054 available for subsequent recall.
4054 ➡ 4055
4055
-
No equivalent source code line in the reference code can be identified.
- The shell allows control of the various characters used by the history
4056
-
+ The shell allows control of the various characters used by the history
4056 ➡ 4057 expansion mechanism (see the description of hhiissttcchhaarrss above under SShheellll
4057
-
No equivalent source code line in the reference code can be identified.
- VVaarriiaabblleess). The shell uses the history comment character to mark his-
4058
-
+ VVaarriiaabblleess). The shell uses the history comment character to mark his-
4058 ➡ 4059 tory timestamps when writing the history file.
4059 ➡ 4060
4060 ➡ 4061 EEvveenntt DDeessiiggnnaattoorrss
4061
-
No equivalent source code line in the reference code can be identified.
- An event designator is a reference to a command line entry in the his-
4062
-
No equivalent source code line in the reference code can be identified.
- tory list. Unless the reference is absolute, events are relative to
4062
-
+ An event designator is a reference to a command line entry in the his-
4063
-
+ tory list. Unless the reference is absolute, events are relative to
4063 ➡ 4064 the current position in the history list.
4064 ➡ 4065
4065
-
No equivalent source code line in the reference code can be identified.
- !! Start a history substitution, except when followed by a bbllaannkk,
4066
-
No equivalent source code line in the reference code can be identified.
- newline, carriage return, = or ( (when the eexxttgglloobb shell option
4066
-
+ !! Start a history substitution, except when followed by a bbllaannkk,
4067
-
+ newline, carriage return, = or ( (when the eexxttgglloobb shell option
4067 ➡ 4068 is enabled using the sshhoopptt builtin).
4068 ➡ 4069 !!_n Refer to command line _n.
4069 ➡ 4070 !!--_n Refer to the current command minus _n.
4070 ➡ 4071 !!!! Refer to the previous command. This is a synonym for `!-1'.
4071 ➡ 4072 !!_s_t_r_i_n_g
4072
-
No equivalent source code line in the reference code can be identified.
- Refer to the most recent command preceding the current position
4073
-