Jaki jest najlepszy darmowy odnośnik dla CMake?

Question

Próbuję nauczyć się korzystać z CMake, aby przekonwertować stosunkowo duży i nieco okrutny zestaw plików Makefile dla projektu średniego i dużego rozmiaru C. Mamy sporo skomplikowanych reguł tworzenia (wygenerowany kod, zestawy testów, które "muszą się zawiesić", duże zestawy opcji dla valgrind, helgrind, drd itd.). Znam sporo autotoolów, ale projekt woli CMake, więc jesteśmy tutaj.

Nauczyłem się, co mogę z wiki i niektórych blogów, ale dokumentacja wydaje się raczej cienka. Czy czegoś brakuje? Widzę mnóstwo odwołań do "Mastering CMake", ale kupuję książkę, aby nauczyć się korzystać z projektu open source (który wydaje się być intensywnie rozwijany ... równolegle "make test" został ostatnio zaimplementowany) pozostawia zły smak w moich ustach .

Answer 1

Moim zdaniem najlepszą referencją jest połączenie przeglądania przykładów online (szczególnie w bibliotekach kitware), a także korzystanie z wbudowanej pomocy (cmake --help) wraz z subskrybowaniem listy mailingowej. A przynajmniej tak nauczyłem się używać CMake. Używam go z wszystkimi moimi nowymi projektami od połowy 2008 roku. Mam książkę i użyłem jej najbardziej, by zacząć, ale jak się obawiałeś, na pewno nie obejmuje ona wszystkiego w CMake szczególnie nowych funkcji.

Answer 2

Od 2016 roku, CMake to niezwykle zaawansowany i potężny system kompilacji składający się z 117 poleceń, 231 modułów i 404 zmiennych. Prawidłowe posługiwanie się nim wymaga przynajmniej przekazania wiedzy o jego wielu możliwościach. Dlatego proponuję, aby próba uczenia się CMake'a w oparciu o wiedzę uzyskaną za pośrednictwem cmake --help lub informacji o liście adresowej, jak opisano powyżej, nie jest już praktyczna.

Do tej pory nie znalazłem przydatnej bezpłatnej dokumentacji PDF. Numer online documentation at cmake.org jest bezpłatny, aktualny i kompleksowy, ale dostęp jest oparty na przeglądarce i trudno jest szybko zlokalizować informacje według słów kluczowych; w zasadzie to poszukiwanie pająków. Ta sama treść to offered as a .qch file, ale aby ją przeglądać, muszę zainstalować pełną wersję QT framework (ponad 900 MB w systemie Windows).

Dlatego do tej pory najlepszym darmowym numerem referencyjnym, który znalazłem jest devdocs.io. Podejrzewam, że DevDocs 'CMake Reference Documentation jest po prostu wersją QT materiału cmake.org prezentowanego przez interfejs sieciowy, ale jest lepiej "dodany do zakładek" niż odnośnik online cmake.org, a jeśli używasz DevDoc's Wybierz dokumentację menu w lewym dolnym rogu na ekranie, aby usunąć wszystkie oprócz CMake, można użyć pola wyszukiwania DevDocs w lewym górnym rogu ekranu, aby szybko znaleźć wszystkie odniesienia do dowolnego słowa kluczowego dowolnego nagłówka sekcji.

Chociaż program DevDocs jest oparty na przeglądarce, istnieje możliwość pobrania całej dokumentacji CMake do użytku w trybie offline.

P.S .: Właśnie odkryłem CMake Tutorial – excerpt from Mastering CMake, który wydaje się bardzo przydatnym wprowadzeniem.

Answer 3

Znalazłem [ this ] zasób, od którego zacząłem z dobrym zasobem, jeśli dopiero zaczynasz.
6. wydanie.