Сборка под-проекта с примерами даже на Марсе

cmake с зависимостями. Спроси резета, он хоть и вендотролль, но в cmake хорошо разбирается.

мог бы и кастануть :) Reset

Пока можешь в моей сосфоржерепе полазить: все более-менее жирное у меня на cmake, в т.ч. так и не добитая до конца CGI-library (хотел туда вебсокеты запилить, да пока хотел, уже запилили — надо тупо под готовье обертку воткнуть).

CMakeLists.txt библиотеки у меня готов, add_subdirectory я сделать могу. основная загвоздка в том, как в дочернем подпроекте сделать «понималку» с кем линковать и откуда инклудить: из каталога уровнем выше или из /usr

Дык, добавь переменную, чтобы LD_LIBRARY_PATH модифицировать и/или флаг -L втыкать.

впринципе да, можно банально подчитать переменные родителя из подпроекта.

пользователь мог собрать примеры указав -DWITH_EXAMPLE=YES _не_устанавливая_либу_, т.е. линковка с только что собранным mylib, инклудятся локальные хедеры

Оберни секцию install в if'ы

в случае установки пользователь мог бы копирнуть /usr/share/mylib/example куда нибудь, зайти внутрь и собрать пример тем самым линкуя его с _установленной_ либой

Положи туда FindMylib.cmake. В каждом примере будет

find_package(MyLib REQUIRED)

В FinMylib.cmake стандартный заголовок типа

if (Mylib_FOUND)
    return ()
endif ()