User guide

110 CHAPTER 4. THE COMMAND LANGUAGE
bin-hex FROM/A,TO/K CIN:y, POS:y, NAT:y
This outputs the bytes of the FROM in hex. For instance, if the file xxx was
ABCDEFGH
12345678
Then the command bin-hex xxx would generate
41 42 43 44 45 46 47 48 0A 31 32 33 34 35 36 37
38 0A
Unless TO is specified output is sent to the terminal..
bin-x8 FROM/A,TO/K CIN:y, POS:y, NAT:y
This outputs the words of the FROM in hex. For instance, if the file xxx was
ABCDEFGH
12345678
Then the command bin-x8 xxx would generate
44434241 48474645 3332310A 37363534 00000A38
The default TO file name is JUNK.
bmake TARGET,FROM/K,TO/K,-m/S,-l/S,-p/S,-r/S,-s/S,-c/S,-d/S
CIN:y, POS:y, NAT:n
This command pr ovides an approximation the make comm and found in other sys-
tems. It uses a makefile (normally bmakefile) to generate a CLI sequence of commands
to bring a specified target up to date . The makefile is expanded usi n g the BGPM macro-
generator and parsed to form a set of pattern rules and explicit rules. Each rule has a
target, an optional se t of items on which the target depends and a possibly empty CLI
command sequence to execute if the target need to be brought up to date.
Pattern rules generate explicit rul e s when nee de d. They contain p aram et er s of the
form <tag>. Within a pattern all tags must be the same and must be declared in the
target of the rule.
The optional first argument (TARGET) is normally a file name and specifies the target
to make. If no target is specified, the target of the first rule is used. The optional FROM
argument specified the makefile name. The default makefile is bmakefile. The opti onal
TO argument specifi es where the output is to be sent .
The -m ar gume nt causes bmake to output the makefile file after macrogeneration.
The -l argument outputs t he makefile as a sequence of lexical tokens. The -p argument
outputs the set of rule patterns. The arguments -r and -s output the expl i c i t rules
before and after the application of the rule patterns, respectively. The -c output the
sequence of commands required to bring the target up to date. The -d argument
generates a debugging trace of the execution of bmake.
The BGPM macrogenerator is described elsewhere, but the version use in bmake
uses the following special characters: