rlx-page(3) -- page commands
============================

## SYNOPSIS

Commands for paginating view result sets.

## COMMANDS

Page commands require that page information is available. Page information is automatically generated when a view is queried, for example, using the `doc ls` command.

* `limit [rows]`:

Sets the number of rows to display per page, when *rows* is not specified this will print the current value of the *limit* setting. Note that for pagination of result sets the actually query string value for *limit* will be `limit + 1`. This command is an alias for the *limit* setting.

The *rows* option must be a positive integer and cannot be zero.

* `next`:

Run a view query to display the next page of results.

* `previous`:

Run a view query to show the previous page of results, this command is only available after the `next` command has been executed.

* `reverse`:

Reverse the direction for a view query. This command toggles the value of the *descending* setting and clears page information so if you have changed page it will be reset to the first page.

* `invert`:

Prints the current view result set rows with the order of the rows inverted. This command does not change the currently selected page or the *descending* setting however when you navigate away from a page where the result set is inverted then the direction of the returned rows for the next (or previous) page will depend upon the current value for *descending*.

* `page info`:

Prints the current page information.

* `page clean`:

Removes all page information.

## BUGS

**rlx** is written in bash and depends upon `bash >= 4.2`.

## COPYRIGHT

**rlx** is copyright (c) 2013 muji <http://xpm.io>

## SEE ALSO

rlx(1), couchdb(3), rlx-settings(3)