使用说明.txt

一个使用Lex编写的C语言词法加亮的小程序。能将指定的C源程序进行词法加亮

“词法着色器 V0.1”使用说明
============================

程序简介
=========
    “C于语言词法着色器”是一个对C语言源程序进行词法加亮处理的小
程序。他的最终输出结果是一个HTML网页文件，可以使用浏览器观看。这
个程序的目的也仅仅是为了演示Lex在词法分析中的应用而起。

    词法着色器应该说也是一个简单的词法分析器，词法着色器是比较容
易实现的，学过编译原理并且使用过lex工具的人，都可以轻易的借助lex
工具制作出一个这样的词法分析器。比起制作一个编译器来，制作这样的
程序简直就是不费吹灰之力。

    本程序将C语言的词法分为8类进行着色处理，分别是“关键字”、
“标识符”、“数字”、“字符串”、“预处理”、“注释”、“运算符”
和“其他符号”。程序识别每一类单词，并对其进行着色，我采用了HTML
文件为输出，这样是最简便的办法，而且也有实用性。

    程序设计的难点就是对HTML中特殊符号的处理，以及对TabSIze的处理。
由于如空格、“<”、“>”，等一些符号在HTML中是不能直接输出的，而
是需要对其进行编码处理，另外就是对Tab键的处理也比较麻烦。程序中每
类单词的颜色是可配置的，这样可以方便用户的使用。

    压缩包中提供了完整的Lex源程序，lex工具，以及编译好的可执行程
序和一个测试结果，品质保证，方便大家的学习和研究。



使用方法
=========
    直接双击运行可执行程序即可。按照提示输入C源程序名和输入文件名
接下来会提示输入颜色配置文件，可以输入“0”使用默认的颜色配置文
件。然后在输入TabSize，也就是Tab键的大小，一般都是为4。就开始进行
词法着色了，程序运行结束后，会在当前目录生成一个网页文件，文件名
就是你输入的“输出文件名”，通过浏览器就可以观看结果。

    你也可以通过命令行运行本程序，命令行格式如下：
	cscanner [[-i] filename] [-c colorconfigfile] [-t tabsie] [-o outputfile]
	命令行参数的含义如下：
	-i filename:        指定输入文件名
	-c colorconfigfile: 指定颜色配置文件名
	-t tabsize:         指定TabSize
	-o outputfile:      指定输出文件名
	所有命令行参数都是可选的，如果缺省的话，程序自动使用默认值。


关于颜色配置文件
================
    使用颜色配置文件，用户可以自己配置每一类单词的颜色，颜色配置文
件的格式如下：
"#0000ff"
"#000000"
"#ee0000"
"#057595"
"#a0009e"
"#009900"
"#000000"
"#000000"
"#000000"
    也就是需要在颜色配置文件中给出每类单词的颜色，其格式就是HTML中
指定字体颜色的RGB格式，其排列顺序是：“关键字”、“标识符”、“数
字”、“字符串”、“预处理”、“注释”、“运算符”、“其他符号”和
Reserved，Reserved是系统保留的颜色，在制作颜色配置文件时必须给出，
且值为"#000000"。
    注意：颜色配置文件必须按照以上格式正确书写，否则无法正常使用。


文件说明
=========
cscanner.exe:  是编译好的可执行程序
text.c:        是一个用于测试的C源程序
test.htm:      是语法着色处理的结果
config.txt:    是一个颜色配置文件的例子
使用说明.txt:  就是这个文件自己了
lex目录:       lex目录中放的是lex工具
SRC目录:       SRC目录中放的是本程序的Lex源代码以及由Lex工具生成
               的C代码



                                  RockCarry工作室
                                  2005.7.15