# Development Tools Words

There are a number of useful words provided with zeptoforth's development tools.

These words are in `forth`.

## Pager

##### `more`
( ? xt -- ? )

A general-purpose pager provided by `full`, `full_swdcom`, and `full_usb` builds. It redirects output from a given xt such that it is displayed one screenful at a time, and the user can after each screenful can enter `q` or `Q` to exit out of the pager early or any other key to continue output. When exiting out of the pager early the data stack is cleaned up afterwards. Otherwise, the stack state before the pager is entered and the stack state left over after xt exits is left unperturbed.

Note that this words cannot be used with zeptocom.js or e4thcom as it assumes full ANSI terminal support, and xterm.js, used by zeptocom.js, and e4thcom do not provide this. This results in waiting forever for a response from the terminal when attempting to look up the size of the terminal or the current cursor coordinates.

## Disassembler

A disassembler that covers (almost all of) the instructions utilized by zeptoforth is included with zeptoforth. It has two different orthogonal modes of operation; one is whether it disassembles instructions in a specified range of addresses or it disassembles just a selected word, the other is whether it disassembles user-friendly assembly including instruction addresses, instructions as hex, addresses to go along with labels, and in one set of cases computes absolute addresses from PC-relative instructions, or whether it disassembles assembler-friendly assembly without such niceities. In both modes it

As a result there are four different words for invoking the disassembler:

##### `disassemble`
( start-addr end-addr -- )

This word disassembles instructions, for human consumption, starting from *start-addr* and ending at, non-inclusive, *end-addr*.

##### `disassemble-for-gas`
( start-addr end-addr -- )

This word disassembles instructions, for feeding into an assembler, starting from *start-addr* and ending at, non-inclusive, *end-addr*.

##### `see`
( "name" -- )

This word disassembles instructions, for human consumption, comprising the whole of the word whose name is specified afterwards.

##### `see-for-gas`
( "name" -- )

This word disassembles instructions, for feeding into an assembler, comprising the whole of the word whose name is specified afterwards.

## Viewing Memory

Memory can be viewed with the following word:

##### `dump`
( start-addr end-addr -- )

This word dumps memory as sequences of 16 bytes in hexadecimal, along with displaying each byte, if a valid ASCII character, starting from *start-addr* and ending at, non-inclusive, *end-addr*.

##### `dump-halfs`
( start-addr end-addr -- )

This word dumps memory as sequences of 8 16-bit halfwords in hexadecimal, along with displaying each byte, if a valid ASCII character, starting from *start-addr* and ending at, non-inclusive, *end-addr*.

##### `dump-cells`
( start-addr end-addr -- )

This word dumps memory as sequences of 4 32-bit cells in hexadecimal, along with displaying each byte, if a valid ASCII character, starting from *start-addr* and ending at, non-inclusive, *end-addr*.

##### `dump-ascii`
( start-addr end-addr -- )

This word dumps memory as sequences of 64 ASCII characters, starting from *start-addr* and ending at, non-inclusing *end-addr*.

## Listing Words

##### `words`
( -- )

This word simply lists every user-viewable word in the current namespace in RAM or in flash, organized as four columns.

##### `words-in`
( module -- )

This word list every user-viewable word in a selected module in RAM or in flash, organized as four columns.

##### `lookup`
( "name" -- )

This word lists each word which has a prefix corresponding to the maximal prefix or the specified token which any word in the current namespace in RAM or in flash matches, organized as four columns.

##### `lookup-in`
( module "name" -- )

This word lists each word which has a prefix corresponding to the maximal prefix or the specified token which any word in a selected module in RAM or in flash matches, organized as four columns.

##### `word-info`
( "name" -- )

Dump all the words that go by a certain name.

## Listing Words with a Pager

In full builds of zeptoforth "more" versions of `words`, `words-in`, `lookup`, and `lookup-in` are provided. These are named `more-words`, `more-words-in`, `more-lookup`, and `more-lookup-in` respectively. Unlike their non-"more" counterparts these integrate a pager, where one screenful of words is printed to the console at a time, and then afterwards the user is prompted to either enter `q` to exit the "more" word or to enter any other key to continue

##### `more-words`
( -- )

This word simply lists with a pager every user-viewable word in the current namespace in RAM or in flash, organized as four columns.

##### `more-words-in`
( module -- )

This word list with a pager every user-viewable word in a selected module in RAM or in flash, organized as four columns.

##### `more-lookup`
( "name" -- )

This word lists with a pager each word which has a prefix corresponding to the maximal prefix or the specified token which any word in the current namespace in RAM or in flash matches, organized as four columns.

##### `more-lookup-in`
( module "name" -- )

This word lists with a pager each word which has a prefix corresponding to the maximal prefix or the specified token which any word in a selected module in RAM or in flash matches, organized as four columns.