# b/list command

The `b/list` BASIC program formats and outputs
BASIC source code listings. It can also be used to format a BASIC
source program and write it back to the file from which it came.

## Syntax

```
b/list file.reference itemlist* {(options}
```

## Parameter(s)

| options | b | Expands lines containing one exclamation point to a string of asterisks. This only works if the exclamation point is all by itself on the line. |
| --- | --- | --- |
| c | Does not indent comment lines. | |
| f | Writes the formatted program back to the file in which it was found. | |
| i | Uses internal defaults for formatting instead of *blist defaults in the messages file. | |
| l | Suppresses display of line (attribute) numbers. | |
| m | Double-spaces listing. | |
| n | No pause option suppresses pause at end of page on terminal display. | |
| o | Overwrites an existing item (when used with the f option); otherwise, it creates a new item-ID of ID.blist, where ID is the original program name, followed by .blist. | |
| p | Outputs to printer; does not update file. | |
| r | Forces all indentations to 0. | |
| s | Draws vertical structure lines and connects statements that are nested. For example, for statements are connected to their corresponding next statements with vertical lines composed of pipe characters. | |
| t | Outputs to screen, unless an f option is included. | |
| u | Updates item with unresolved format structure. | |
The table below lists the `*blist` attributes
in the messages file.

| Attribute | Description | Default |
| --- | --- | --- |
| 1 | left margin indent | 0 |
| 2 | code indent | 2 |
| 3 | comment left margin | 0 |
| 4 | comment indent | 0 |

## See also

- [blist command](https://d3codex.com/tcl/blist-command/)

---
Source: https://d3codex.com/tcl/b-list-command/ - part of the D3Codex reference.