bbjlst - BBj Lister

Syntax

bbjlst {-?} {-R} {-l} {-p<password>} {-d<directory>} {-e<errorlog>} {-w<width>}
{-x<extension>} {-@<filelist>} {files} {directory}

Description

For Windows-specific information, see bbjlstw - BBj Lister (Windows only).

The bbjlst utility is a stand-alone program that turns tokenized BBj program files into ASCII text files to produce listings.

The bbjlst utility can be used as a pipe (read from stdin, write to stdout).

 

Parameter

Description

-?

Provides a syntax listing.

-@<filelist>

In BBj 5.0 and higher, reads files from a filelist file, which is a list of filenames delimited by line terminators (line feed, carriage return, or carriage return/line feed.)

-R

Use recursion when a directory is specified to list each program found in the specified directory and subdirectories. If used in configuration with the –d option, all output subdirectories will be automatically created.

bbjlst –R –d/usr/BBx/listings /usr/BBx/compiled

-l

Suppresses line numbers in the listing.

-p<password>

In BBj 16.0 and higher, this option specifies the password for password-protected programs.

-d<directory>

Name of the directory in which to place the output files. If this switch is used, then the listing files have exactly the same names as the source files but are in a different directory.

I=SCALL("bbjlst -d/usr/BBxfile1 file2 file3")

-e<errorlog>

Writes the error output into an errorlog file.

-w<width>

Sets the output line width. The default width is 78. The minimum width is 40. If -w0 is specified, complete lines will be listed (with no line breaks).

-x<extension>

Appends the extension to the file name.

files

BBj program file(s), PRO/5 program file(s), or ASCII program file(s) to be listed.

If no file names are specified, bbjlst will read from standard input and write to standard output. This allows it to be used with pipes.

If a source file name has no extension, the corresponding output filename will have an extension of ".lst".

If a source file name has an extension, the corresponding output filename will have no extension.

Example

The following lists four files to be named, file1.lst, file2.lst, file3.lst, and file4.lst:

LET I=SCALL("bbjlst file1 file2 file3 file4")