The Input Line (ne’s manual)

Next: The Command Line, Previous: The Status Bar, Up: Reference [Contents][Index]

### 3.3 The Input Line

The bottom line of the screen is usually occupied by the status bar (see The Status Bar). However, whenever `ne` prompts you for a command or file name or asks you to confirm some action, the bottom line becomes the input line. You can see this because a prompt is displayed at the start of the line, suggesting what kind of input is required. (Prompts always ends with a colon, so it is easy to distinguish them from error messages, which overwrite the status bar from time to time.)

`ne` uses the input line in two essentially different ways: immediate input and long input. You can easily distinguish between these two modes because in immediate input mode the cursor is not on the input line, while for long input mode it is.

Immediate input is used whenever `ne` needs you to specify a simple choice that can be expressed by one character (for example, ‘`y`’ or ‘`n`’). When you type the character, `ne` will immediately accept and use your input. Most immediate inputs display a character just after the prompt. This character is the default response, which is used if you just press the `Return` key. Note that immediate input is not case sensitive. Moreover, if a yes/no choice is requested, anything other than ‘`y`’ will be considered a negative response.

Long input is used when a whole string is required. You can enter and edit your response to long inputs like a line of text in a document. Most key bindings related to line editing work on the command line exactly as they do in a document. This is true even of custom key bindings. Just edit as you are used to. Moreover, the you can paste the first line of the current clip using the keystroke that is bound to the `Paste` command, usually `Control-V`. If your long input is longer than the screen width, the input line scrolls to accommodate your text so you can input very long lines even on small monitors. (There is a limit of 2048 characters.)

The default response to a long input is the response you gave to the previous long input. Your first action when presented with a long input will either erase the default response or allow you to edit it. If the first thing you type is a printing character, the default response will be erased. Anything else (cursor movement for example) will allow you to edit it further.

Long input also lets you access your previous long input responses with the up and down cursor commands (or with wider movement commands, such as start/end of file, page up/down, etc.). Once you find a previous input you like, you can edit it further. Long input history is not document specific, so you can recall any of your inputs regardless of which document was active when you entered it. Furthermore, `ne` saves the most recent long inputs in `~/.ne/.history` when you end your `ne` session and loads them again when you begin another `ne` session.

Invoking the `Find` command, usually bound to `Control-F`, brings up a requester showing your prior inputs. You can close the requester with the `Escape` key, replace your input line with a highlighted prior entry with the `Enter` key, or insert that prior entry into your input line with the `Tab` key.

When asked to input a number, you can choose between decimal, octal and hexadecimal notation in the standard way: a number starting with ‘`0`’ is considered in octal, a number starting with ‘`0x`’ is considered in hexadecimal, and in all other cases decimal base is assumed.

Whenever a file name is requested, you can type a partial file name and complete it with the `Tab` key. `ne` will scan the current directory (or the directory that you partially specified) and search for the files matching your partial suggestion. The longest prefix common to all such files will be copied to the input line (`ne` will beep if no completion exists). It’s easier done than said—just try. If you press `Tab` again, you will be brought into the file requester: only the files and directories matching your partial specification will appear, and as usual you will be able to navigate and select a file or escape. See The Requester. Note that `ne` considers the last word on the input line the partial file name to complete, no matter where the cursor is currently (you must use quotes if the name contains spaces, even if it is the only item on the input line).

Complete long input with the `Return` key. You can cancel a long input using `f1`, `Escape`, `Escape`-`Escape` or any key that is bound to the `Escape` command. The effect will vary depending on what your were requested to input, but the execution of the command requiring the input will stop.

Next: The Command Line, Previous: The Status Bar, Up: Reference [Contents][Index]