“詞法著色器 V0.1”使用說明
============================

程序簡介
=========
    “C于語言詞法著色器”是一個對C語言源程序進行詞法加亮處理的小
程序。他的最終輸出結(jié)果是一個HTML網(wǎng)頁文件，可以使用瀏覽器觀看。這
個程序的目的也僅僅是為了演示Lex在詞法分析中的應(yīng)用而起。

    詞法著色器應(yīng)該說也是一個簡單的詞法分析器，詞法著色器是比較容
易實現(xiàn)的，學過編譯原理并且使用過lex工具的人，都可以輕易的借助lex
工具制作出一個這樣的詞法分析器。比起制作一個編譯器來，制作這樣的
程序簡直就是不費吹灰之力。

    本程序?qū)語言的詞法分為8類進行著色處理，分別是“關(guān)鍵字”、
“標識符”、“數(shù)字”、“字符串”、“預(yù)處理”、“注釋”、“運算符”
和“其他符號”。程序識別每一類單詞，并對其進行著色，我采用了HTML
文件為輸出，這樣是最簡便的辦法，而且也有實用性。

    程序設(shè)計的難點就是對HTML中特殊符號的處理，以及對TabSIze的處理。
由于如空格、“<”、“>”，等一些符號在HTML中是不能直接輸出的，而
是需要對其進行編碼處理，另外就是對Tab鍵的處理也比較麻煩。程序中每
類單詞的顏色是可配置的，這樣可以方便用戶的使用。

    壓縮包中提供了完整的Lex源程序，lex工具，以及編譯好的可執(zhí)行程
序和一個測試結(jié)果，品質(zhì)保證，方便大家的學習和研究。



使用方法
=========
    直接雙擊運行可執(zhí)行程序即可。按照提示輸入C源程序名和輸入文件名
接下來會提示輸入顏色配置文件，可以輸入“0”使用默認的顏色配置文
件。然后在輸入TabSize，也就是Tab鍵的大小，一般都是為4。就開始進行
詞法著色了，程序運行結(jié)束后，會在當前目錄生成一個網(wǎng)頁文件，文件名
就是你輸入的“輸出文件名”，通過瀏覽器就可以觀看結(jié)果。

    你也可以通過命令行運行本程序，命令行格式如下：
	cscanner [[-i] filename] [-c colorconfigfile] [-t tabsie] [-o outputfile]
	命令行參數(shù)的含義如下：
	-i filename:        指定輸入文件名
	-c colorconfigfile: 指定顏色配置文件名
	-t tabsize:         指定TabSize
	-o outputfile:      指定輸出文件名
	所有命令行參數(shù)都是可選的，如果缺省的話，程序自動使用默認值。


關(guān)于顏色配置文件
================
    使用顏色配置文件，用戶可以自己配置每一類單詞的顏色，顏色配置文
件的格式如下：
"#0000ff"
"#000000"
"#ee0000"
"#057595"
"#a0009e"
"#009900"
"#000000"
"#000000"
"#000000"
    也就是需要在顏色配置文件中給出每類單詞的顏色，其格式就是HTML中
指定字體顏色的RGB格式，其排列順序是：“關(guān)鍵字”、“標識符”、“數(shù)
字”、“字符串”、“預(yù)處理”、“注釋”、“運算符”、“其他符號”和
Reserved，Reserved是系統(tǒng)保留的顏色，在制作顏色配置文件時必須給出，
且值為"#000000"。
    注意：顏色配置文件必須按照以上格式正確書寫，否則無法正常使用。


文件說明
=========
cscanner.exe:  是編譯好的可執(zhí)行程序
text.c:        是一個用于測試的C源程序
test.htm:      是語法著色處理的結(jié)果
config.txt:    是一個顏色配置文件的例子
使用說明.txt:  就是這個文件自己了
lex目錄:       lex目錄中放的是lex工具
SRC目錄:       SRC目錄中放的是本程序的Lex源代碼以及由Lex工具生成
               的C代碼



                                  RockCarry工作室
                                  2005.7.15