# forward-paragraph(2)

[Home] [Commands] [Variables] [Macro-Dev] [Glossary]

## 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).

(c) Copyright JASSPA 2009
Last Modified: 2009/08/29
Generated On: 2009/10/12

</HMTL>