JJDoc

自 Apache Ant 1.6 起

說明

呼叫 JavaCC 編譯器編譯器的 JJDoc 預處理器。它會採用 JavaCC 剖析器規格,並產生 BNF 語法的文件。它可以透過命令列選項來操作三種模式。

若要使用 jjdoc 任務,請將 target 屬性設定為要處理的 JavaCC 語法檔案名稱。您也需要使用 javacchome 屬性指定包含 JavaCC 安裝的目錄,以便 Ant 可以找到 JavaCC 類別。您也可以選擇設定 outputfile,將產生的 BNF 文件寫入特定(目錄及)檔案。否則,jjdoc 會將產生的 BNF 文件寫入 JavaCC 語法檔案,並加上 .txt.html 字尾。

此任務只會在語法檔案比產生的 BNF 文件新時,才會呼叫 JJDoc

參數

屬性 說明 必要
target 要處理的 JavaCC 語法檔案。
javacchome 包含 JavaCC 發行版的目錄。
outputfile 將產生的 BNF 文件寫入的檔案。如果未設定,檔案會寫入與 JavaCC 語法檔案相同的名稱,但字尾為 .html.txt
text 設定 TEXT BNF 文件選項。這是一個布林選項。
onetable 設定 ONE_TABLE BNF 文件選項。這是一個布林選項。
maxmemory 分配給分岔 JVM 的最大記憶體量。自 Ant 1.8.3 起

範例

在語法檔案 src/Parser.jj 上呼叫 JJDoc,將產生的 BNF 文件 ParserBNF.html 寫入 doc

<jjdoc target="src/Parser.jj"
       outputfile="doc/ParserBNF.html"
       javacchome="c:/program files/JavaCC"/>