CMake 手冊詳解(二)


書接上回:-)

====================================================

  • --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獲得相關語言要素的完整幫助信息。

下一章將介紹“生成器”。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM