b/list

b/list


assignfq Index Level basic
Syntax b/list file.reference itemlist* {(options}
Category TCL
Type Verb
Description formats and outputs FlashBASIC source code listings.

It may also be used to format a FlashBASIC source program and write it back to the file from which it came.
Options b  Expands lines containing one "!" to a string of "*"'s. This only works if the "!" is all by itself on the line.

c  Does not indent comment lines.

f  Writes "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. See the "*blist" item listed under warnings.

l  Suppresses display of line (attribute) numbers.

m  Double spaces listing.

n  No pause; suppresses pause at end of page on terminal display.

o  Overwrites existing item (when used with "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 zero.

s  Draws vertical structure lines. This "connects" statements that are generally "nested". For example, "for" statements are connected to their corresponding "next" statements with vertical lines composed of "|" characters.

t  Outputs to crt, unless an "f" option is included.

u  Updates item with unresolved format structure.
See Also itemlist* blist
Example
Warnings There are multiple versions of this program floating around the system. R83 supported a "blist" verb which had some of the same functionality. "b/list" is the latest and greatest version.

The following item is used by the "i" option and resides in the "messages" file:

*blist
attribute   Description             Default
---------   ---------------------   -------

  1        Left margin indent        0
  2        Code indent               2
  3        Comment left margin       0
  4        Comment indent            0
Compatibility D3 7.0 AP
assignfq Index Level basic