forward-paragraph(2)

NAME

forward-paragraph - Move the cursor to the next paragraph
backward-paragraph - Move the cursor to the previous paragraph

SYNOPSIS

n forward-paragraph (esc n) 
n backward-paragraph (esc p) 

DESCRIPTION

forward-paragraph moves forwards n paragraphs. The cursor is placed at the end of the nth paragraph at the start of the blank paragraph separation line. The default value of n is 1, if n is negative then the direction is backwards.

backward-paragraph similarly moves backwards n paragraphs. The cursor is placed at the start of the blank paragraph separation line. The default value of n is 1, if n is negative then the direction is forwards.

DIAGNOSTICS

The following errors can be generated, in each case the command returns a FALSE status:

[end of buffer]


When moving forwards, the given argument n was greater that the number of remaining paragraphs, the cursor is left at the end of the buffer.

[top of buffer]


When moving backwards, the given argument n was greater than the number of paragraphs before the cursor, the cursor is left at the beginning of the buffer.

NOTES

• For both invocations a negative value reverses the sense of movement as expected.
• A paragraph break is defined as a blank line.

SEE ALSO

backward-line(2), forward-line(2), kill-paragraph(2), scroll-down(2), scroll-up(2).

Ref: forward-paragraph(2) File: m2cmd094.2 Date: 2026/02/28

(c) Copyright JASSPA 2026