buzz_toolset

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revisionBoth sides next revision
buzz_toolset [2016/04/23 23:02] – [bzzrun] ilpincybuzz_toolset [2016/09/03 00:25] root
Line 1: Line 1:
 ===== Buzz Toolset ===== ===== Buzz Toolset =====
- 
-{{ :toolset.png?nolink&700 |}} 
  
 The most common use of the Buzz toolset is to compile a Buzz script into bytecode executable by the [[buzz_vm|Buzz Virtual Machine]]. As shown in the above image, the process is composed two sequential transformations: The most common use of the Buzz toolset is to compile a Buzz script into bytecode executable by the [[buzz_vm|Buzz Virtual Machine]]. As shown in the above image, the process is composed two sequential transformations:
Line 11: Line 9:
  
 The fourth tool, called ''bzzdeasm'', produces an annotated assembly file from the bytecode and the debug information. The fourth tool, called ''bzzdeasm'', produces an annotated assembly file from the bytecode and the debug information.
 +
 +==== bzzc ====
 +
 +<code bash>
 +$ bzzc [options] <file.bzz>
 +</code>
 +
 +This command combines ''bzzparse'' and ''bzzasm''. It takes as input a script ''file.bzz'' and produces two files: ''file.bo'' (the bytecode file), and ''file.bdb'' (the debugging information file).
 +
 +''bzzc'' honors ''BUZZ_INCLUDE_PATH'' like ''bzzparse''.
 +
 +In addition, it is possible to specify the path of ''bzzparse'' and ''bzzasm'' with the environment variables ''BZZPARSE'' and ''BZZASM'', respectively. This is usually not necessary, as ''bzzc'' looks for these paths automatically. This feature was added to make seamless support of automated build systems like [[https://cmake.org/|CMake]] possible.
 +
 +The ''bzzc'' command accepts the following options:
 +
 +  * ''-I|%%--%%include path1:path2:...:pathN'': specifies a list of include paths to append to ''BUZZ_INCLUDE_PATH''
 +  * ''-b|%%--%%bytecode file.bo'': specifies an explicit name for the bytecode file
 +  * ''-d|%%--%%debug file.bdb'': specifies an explicit name for the debugging information file
 +  * ''-h|%%--%%help'': shows help on the command line
  
 ==== bzzparse ==== ==== bzzparse ====
Line 33: Line 50:
 This command compiles a Buzz [[buzz_assembler|assembly code]] file ''infile.basm'' and produces two output files. The first, ''outfile.bo'', is the bytecode to be executed by the [[buzz_vm|Buzz Virtual Machine]]. The second, ''outfile.bdb'', is a binary file containing debugging information. This command compiles a Buzz [[buzz_assembler|assembly code]] file ''infile.basm'' and produces two output files. The first, ''outfile.bo'', is the bytecode to be executed by the [[buzz_vm|Buzz Virtual Machine]]. The second, ''outfile.bdb'', is a binary file containing debugging information.
  
-==== bzzc ==== 
- 
-<code bash> 
-$ bzzc [options] <file.bzz> 
-</code> 
- 
-This command combines ''bzzparse'' and ''bzzasm''. It takes as input a script ''file.bzz'' and produces two files: ''file.bo'' (the bytecode file), and ''file.bdb'' (the debugging information file). 
- 
-''bzzc'' honors ''BUZZ_INCLUDE_PATH'' like ''bzzparse''. 
- 
-In addition, it is possible to specify the path of ''bzzparse'' and ''bzzasm'' with the environment variables ''BZZPARSE'' and ''BZZASM'', respectively. This is usually not necessary, as ''bzzc'' looks for these paths automatically. This feature was added to make seamless support of automated build systems like [[https://cmake.org/|CMake]] possible. 
- 
-The ''bzzc'' command accepts the following options: 
- 
-  * ''-I|%%--%%include path1:path2:...:pathN'': specifies a list of include paths to append to ''BUZZ_INCLUDE_PATH'' 
-  * ''-b|%%--%%bytecode file.bo'': specifies an explicit name for the bytecode file 
-  * ''-d|%%--%%debug file.bdb'': specifies an explicit name for the debugging information file 
-  * ''-h|%%--%%help'': shows help on the command line 
 ==== bzzdeasm ==== ==== bzzdeasm ====
  
  • buzz_toolset.txt
  • Last modified: 2016/09/03 00:28
  • by ilpincy