Welcome to the OpenBIOS detokenizer README. Here you'll find a short
description about the detokenizer and how to use it.

Table of contents:

1. What is the OpenBIOS detokenizer?
2. What is required to build the OpenBIOS detokenizer?
3. How to use the OpenBIOS detokenizer
4. Contact

---------------------------------------------------------------------

1. What is the OpenBIOS detokenizer?
   detok is a GPLed FCode detokenizer. It can detokenize (disassemble)
   fcode bytecode files as described by the IEEE 1275-1994 standard.
   This program aims towards IEEE 1275-1994 compliancy, but there is
   no warranty that it is actually compliant.
   bytecode files normally contain Open Firmware drivers or other 
   packages for use with an Open Firmware compliant system.
   
2. What is required to build the OpenBIOS detokenizer?
   detok should build with any ANSI compliant C compiler, although 
   currently only Linux on i386/alpha/ia64 are tested. To build 
   detok on other platforms you might have to adjust the Makefile.
   To build detok, just enter "make". To clean up an existing build, 
   use "make clean" or "make distclean"
   
3. How to use the OpenBIOS detokenizer
   detokenize an fcode binary file with 
	detok [-v|--verbose] <file.fc> <file.fc> ...
   Get help with:
	detok [-h|--help]

4. Contact
   Any ideas, bug reports, patches, contributions, discussion is 
   welcome.
   Stefan Reinauer <stepan@core-systems.de>


