Skip to content

Commit

Permalink
MANUAL: Update to reflect auto-increment changes
Browse files Browse the repository at this point in the history
  • Loading branch information
micahcowan authored Aug 11, 2022
1 parent 0e49bf8 commit ab92091
Showing 1 changed file with 2 additions and 2 deletions.
4 changes: 2 additions & 2 deletions MANUAL.md
Original file line number Diff line number Diff line change
Expand Up @@ -225,14 +225,14 @@ If no line was summoned yet into the current prompt, then **a2vimode** will chec

If you type `CONTROL-A` (in either mode), a line number will be inserted at the start of the line. By default, the first line number generated would be 10, and then each successive line would be increased by ten.

Each line number is generated based on the last line number that **a2vimode** saw at the start of a line that the user entered at the main AppleSoft prompt. So, if the auto-increment generates a line starting with the number 220, and you delete that number and rewrite it to 512, and then type out the rest of your line followed by `RETURN`, the next prompt will give you a line beginning with line number 520. This example also serves to point out that each new line number is *not* generated by simply adding ten to the last-seen line number: the number will instead be the next number that is a *multiple* of ten (by default).
Each line number is generated based on the last line number that **a2vimode** saw at the start of a line that the user entered at the main AppleSoft prompt. So, if the auto-increment generates a line starting with the number 220, and you delete that number and rewrite it to 512, and then type out the rest of your line followed by `RETURN`, the next prompt will give you a line beginning with line number 522.

Automatic line-number generation will continue until
- `CONTROL-A` is typed again (toggle),
- a line with no number at the start is typed (commands that are executed by ProDOS are excluded), or
- a line at a prompt other than the direct-mode AppleSoft prompt is typed.

If you are in **normal** mode, and type a number before executing `CONTROL-A`, then it is handled specially. Normally, prefixing a normal-mode command with a number will repeat that command the specified number of times (for those commands that support it). With `CONTROL-A`, it will instead set the auto-increment interval. For example, if you type `100` `CONTROL-A`, then line numbers will be generated in successive multiples of 100, rather than 10. If this technique is used when the current line already has a line number at the start, that number will be removed, and replaced with one that conforms to the new formula (the replacing number will still be generated based on the last line-number seen on a previously-completed input line).
If you are in **normal** mode, and type a number before executing `CONTROL-A`, then it is handled specially. Normally, prefixing a normal-mode command with a number will repeat that command the specified number of times (for those commands that support it). With `CONTROL-A`, it will instead set the auto-increment interval. For example, if you type `100` `CONTROL-A`, then line numbers will be advanced by 100, rather than 10. If this technique is used when the current line already has a line number at the start, that number will be removed, and replaced with one that conforms to the new formula (the replacing number will still be generated based on the last line-number seen on a previously-completed input line).

## Jump-to-Char

Expand Down

0 comments on commit ab92091

Please sign in to comment.