View source for Razzle

'''Razzle''' is the build environment of Windows NT operating systems, which is used in OpenXP too. It is named after the codename of Windows NT 3.1 and it's purpose is to define building variables and set up an environment for building necessary components and source code of Windows NT. It was also used in OS/2 before the partnership refusal between Microsoft and IBM in plan of OS/2 development.

== Usage ==
The common arguments of Razzle are following:

* <code>free</code> - retail build,
* <code>chk</code> - checked build, which contains additional debugging information and therefore slower in execution,
* <code>offline</code> - isolates source code from Source Depot or similar linked programs. Without this argument, Razzle tries to connect with the source server via <code>sd.exe</code>, but due to internal addresses absence, it goes abrupt and errors start to appear. This workaround is fixed in OpenXP internally, changing points to Git.

=== Architectures ===
By default, Razzle builds for x86 platforms. To specify another one, you should append one of these arguments after previous one:

* <code>win64</code> - choosing an Intel Itanium 64 (IA-64) target for build. If you append <code>amd64</code>, it will build for AMD64 targets,
* <code>pocketpc</code> - builds ARMv4 target, prevailingly for Windows CE 2003 (or Windows Mobile 2003).

=== Miscellaneous ===
Miscellaneous arguments of Razzle are these:

* <code>verbose</code> - executes Razzle script suite and outputs every action happening,
* <code>ntttest</code> - builds NT test sources (if they exist),
* <code>emulation</code> - builds sources runnable on various simulators of processors and their architectures,
* <code>chkkernel</code> - builds checked versions of NT kernel,
* <code>no_opt</code> - disables compiler optimizations which may lead to larger file sizes,
* <code>mui_magic</code> - generates language-neutral (or pseudo language) build. Highly incomplete and needs workarounds,
* <code>no_binaries</code> - compiles without creating specific directory for binaries (e.g. <code>binaries.x86fre</code>),
* <code>binaries_dir</code> - specifies custom path of binaries different from original one,
* <code>sepchar</code> - replaces dot in binaries path with custom symbol, specified by user,
* <code>postbld_dir</code> - specifies path of post-build directory,
* <code>temp</code> - specifies custom temporary folder,
* <code>no_title</code> - disallows title change of Command Prompt to "Build Environment",
* <code>no_certcheck</code> - doesn't check for code signing certificate existence,
* <code>no_sdrefresh</code> - doesn't update Source Depot client (sd.exe),
* <code>restricted_path</code> - sets path to the same restricted path that build uses (for debugging "why can't build find my tool" problems),
* <code>officialbuild</code> - makes retail builds, reducing remnants of development code. It checks for tools/BuildMachines.txt, and if exists, the specific values to build official builds,
* <code>exec</code> - optional arguments to execute after Razzle initiation,
* <code>enigma</code> - turns on CSP signing and CSP signature checks,
* <code>vaultsign</code> - requires CSP's to be vault signed with the Microsoft key.
[[Category:OpenXP]]