.scan [-v][-i <ignorepattern>] baseline | checkpoint
使用 .scan 指令,可加強儲存在 BOM 中的工作資料。它會追蹤步驟工作目錄中的檔案,以及各檔案的 MD5 值。
- .scan baseline
- 將所有檔案的清單儲存在步驟的工作目錄中。系統會針對工作,在 BOM 中將清單顯示為種類。一個工作中可以有多個 baseline 指令,但是在指令執行時,每一個指令都會將清單重設為步驟工作目錄的狀態。最後一個 BOM
只會顯示一個 baseline 種類。
- .scan checkpoint
- 儲存自前次在工作中執行 .scan baseline 或 .scan checkpoint 指令以來,所有新建、已變更及已刪除的檔案清單。系統會在 BOM 中顯示清單。每一個 checkpoint
指令都會在 BOM 中建立新種類。
您必須先使用
.scan baseline 指令,才能在工作中使用第一個
.scan checkpoint 指令。在
.scan baseline
指令之前的
.scan checkpoint 指令會被忽略。
指令選項:
- -v
- 將變更資訊的副本記錄在工作日誌中。
- -i
- 忽略符合所提供型樣的目錄。型樣可以符合路徑的開頭、結束或任何的目錄部分。您可以使用這個選項,來刪除變更清單中的來源控制目錄。
CVS 範例:
.scan -i CVS checkpoint
此範例指令會將
CVS 目錄從報告中剔除。
Subversion 範例:
.scan -i .svn baseline
如果搭配使用 -v 與 -i,系統會記載來源控制目錄的變更,但 BOM 中不會包含這些變更。
註: 請勿在單一步驟中使用多個 .scan 指令。如果您在單一步驟中使用多個 .scan 指令,系統將無法提供精確的輸出。
如需使用這些指令的相關資訊,請參閱使用 .scan 指令來新增基準線及核對點。