書接上回:-)
====================================================
--build <dir>
: 構建由CMake生成的工程的二進制樹。(這個選項的含義我不是很清楚—譯注)
該選項用以下的選項概括了內置構建工具的命令行界面
<dir> = 待創建的工程二進制路徑。
--target <tgt> = 構建<tgt>,而不是默認目標。
--config <cfg> = 對於多重配置工具,選擇配置<cfg>。
--clean-first = 首先構建目標的clean偽目標,然后再構建。
(如果僅僅要clean掉,使用--target 'clean'選項。)
-- = 向內置工具(native tools)傳遞剩余的選項。運行不帶選項的cmake --build來獲取快速幫助信息。
-N
: 查看模式。
僅僅加載緩存信息,並不實際運行配置和生成步驟。
-P <file>
: 處理腳本模式。
將給定的cmake文件按照CMake語言編寫的腳本進行處理。不執行配置和生成步驟,不修改緩存信息。如果要使用-D選項定義變量,-D選項必須在-P選項之前。
--graphviz=[file]
: 生成依賴的graphviz圖。
生成一個graphviz軟件的輸入文件,其中包括了項目中所有庫和可執行文件之間的依賴關系。
--system-information [file]
: 輸出與該系統相關的信息。輸出范圍比較廣的、與當前使用的系統有關的信息。如果在一個CMake工程的二進制構建樹的頂端運行該命令,它還會打印一些附加信息,例如緩存,日志文件等等。
--debug-trycompile
: 不刪除“嘗試編譯”路徑。
不刪除那些為try_compile調用生成的路徑。這在調試失敗的try_compile文件時比較有用。不過,因為上一次“嘗試編譯”生成的舊的垃圾輸出文件也許會導致一次不正確通過/不通過,且該結果與上次測試的結果不同,所以該選項可能會改變“嘗試編譯”的結果。對於某一次“嘗試編譯”,該選項最好只用一次;並且僅僅在調試時使用。
--debug-output
: 將cmake設置為調試模式。
在cmake運行時,打印額外的信息;比如使用message(send_error)調用得到的棧跟蹤信息。
--trace
: 將cmake設置為跟蹤模式。
用message(send_error )調用,打印所有調用生成的跟蹤信息,以及這些調用發生的位置。(這句話含義不是很確定—譯注。)
--help-command cmd [file]
: 打印單個命令cmd的幫助信息,然后退出。
顯示給定的命令的完整的文檔。如果指定了[file]參數,該文檔會寫入該文件,其輸出格式由該文件的后綴名確定。支持的文件類型有:man page,HTML,DocBook以及純文本。
--help-command-list [file]
: 列出所有可用命令的清單,然后退出。
該選項列出的信息含有所有命令的名字;其中,每個命令的幫助信息可以使用--help-command選項后跟一個命令名字得到。如果指定了[file]參數,幫助信息會寫到file中,輸出格式依賴於文件名后綴。支持的文件格式包括:man page,HTML,DocBook以及純文本。
--help-commands [file]
: 打印所有命令的幫助文件,然后退出。
顯示所有當前版本的命令的完整文檔。如果指定了[file]參數,幫助信息會寫到file中,輸出格式依賴於文件名后綴。支持的文件格式包括:man page,HTML,DocBook以及純文本。
--help-compatcommands [file]
: 打印兼容性命令(過時的命令—譯注)的幫助信息。
顯示所有關於兼容性命令的完整文檔。如果指定了[file]參數,幫助信息會寫到file中,輸出格式依賴於文件名后綴。支持的文件格式包括:man page,HTML,DocBook以及純文本。
--help-module module [file]
: 打印某單一模塊的幫助信息,然后退出。
打印關於給定模塊的完整信息。如果指定了[file]參數,幫助信息會寫到file中,且輸出格式依賴於文件名后綴。支持的文件格式包括:man page,HTML,DocBook以及純文本。
--help-module-list [file]
: 列出所有可用模塊名,然后退出。
列出的清單包括所有模塊的名字;其中,每個模塊的幫助信息可以使用--help-module選項,后跟模塊名的方式得到。如果指定了[file]參數,幫助信息會寫到file中,且輸出格式依賴於文件名后綴。支持的文件格式包括:man page,HTML,DocBook以及純文本。
--help-modules [file]
: 打印所有模塊的幫助信息,然后退出。顯示關於所有模塊的完整文檔。如果指定了[file]參數,幫助信息會寫到file中,且輸出格式依賴於文件名后綴。支持的文件格式包括:man page,HTML,DocBook以及純文本。
--help-custom-modules [file]
: 打印所有自定義模塊名,然后退出。
顯示所有自定義模塊的完整文檔。如果指定了[file]參數,幫助信息會寫到file中,且輸出格式依賴於文件名后綴。支持的文件格式包括:man page,HTML,DocBook以及純文本。
--help-policy cmp [file]
: 打印單個策略的幫助信息,然后退出。
顯示給定的策略的完整文檔。如果指定了[file]參數,幫助信息會寫到file中,且輸出格式依賴於文件名后綴。支持的文件格式包括:man page,HTML,DocBook以及純文本。
--help-policies [file]
: 打印所有策略的幫助信息,然后退出。
顯示所有策略的完整文檔。如果指定了[file]參數,幫助信息會寫到file中,且輸出格式依賴於文件名后綴。支持的文件格式包括:man page,HTML,DocBook以及純文本。
--help-property prop [file]
: 打印單個屬性的幫助信息,然后退出。
顯示指定屬性的完整文檔。如果指定了[file]參數,幫助信息會寫到file中,且輸出格式依賴於文件名后綴。支持的文件格式包括:man page,HTML,DocBook以及純文本。
--help-property-list [file]
: 列出所有可用的屬性,然后退出。
該命令列出的清單包括所有屬性的名字;其中,每個屬性的幫助信息都可以通過--help-property選項后跟一個屬性名的方式獲得。如果指定了[file]參數,幫助信息會寫到file中,且輸出格式依賴於文件名后綴。支持的文件格式包括:man page,HTML,DocBook以及純文本。
--help-properties [file]
: 打印所有屬性的幫助信息,然后退出。
顯示所有屬性的完整文檔。如果指定了[file]參數,幫助信息會寫到file中,且輸出格式依賴於文件名后綴。支持的文件格式包括:man page,HTML,DocBook以及純文本。
--help-variable var [file]
: 打印單個變量的幫助信息,然后退出。
顯示指定變量的完整文檔。如果指定了[file]參數,幫助信息會寫到file中,且輸出格式依賴於文件名后綴。支持的文件格式包括:man page,HTML,DocBook以及純文本。
--help-variable-list [file]
: 列出文檔中有記錄的變量,然后退出。
該命令列出的清單包括所有變量的名字;其中,每個變量的幫助信息都可以通過--help-variable選項后跟一個變量名的方式獲得。如果指定了[file]參數,幫助信息會寫到file中,且輸出格式依賴於文件名后綴。支持的文件格式包括:man page,HTML,DocBook以及純文本。
--help-variables [file]
: 打印所有變量的幫助信息,然后退出。
顯示所有變量的完整幫助文檔。如果指定了[file]參數,幫助信息會寫到file中,且輸出格式依賴於文件名后綴。支持的文件格式包括:man page,HTML,DocBook以及純文本。
--copyright [file]
: 打印CMake的版權信息,然后退出。
如果指定了[file]參數,版權信息會寫到這個文件中。
--help
: 打印用法信息,然后退出。
用法信息描述了基本的命令行界面及其選項。
--help-full [file]
: 打印完整的幫助信息,然后退出。
顯示大多數UNIX man page提供的幫助信息。該選項是為非UNIX平台提供的;但是如果man手冊頁沒有安裝,它也能提供便利。如果制定了[file]參數,幫助信息會寫到這個文件中。
--help-html [file]
: 以HTML格式打印完整的幫助信息,然后退出。
CMake的作者使用該選來幫助生成web頁面。如果指定了[file]參數,幫助信息會寫到這個文件中。
--help-man [file]
: 以UNIX的man手冊頁格式打印完整的幫助信息,然后退出。
cmake使用該選生成UNIX的man手冊頁。如果指定了[file]參數,幫助信息會寫到這個文件中。
--version [file]
: 顯示程序名/版本信息行,然后退出。
如果指定了[file]參數,版本信息會寫到這個文件中。
===========================================================
對於CMake的語言要素,比如命令,屬性和變量,幫助命令選項也是很有規律的,一般是用--help-xxx-list查看所有值的名字,找出感興趣的項,然后用--help-xxx name查看該名字的詳細信息;也可以用--help-xxxs獲得相關語言要素的完整幫助信息。
下一章將介紹“生成器”。