Document how to use beman projects using CMake FetchContent workflows

[frankmiller]

No description provided.

[frankmiller]

I created a new project that uses cmake FetchContent to build the beman example project and link it into an executable.

CMakeLists.txt

cmake_minimum_required(VERSION 3.27.6)
project(use_beman_example LANGUAGES CXX)

include(FetchContent)
FetchContent_Declare(
  example
  GIT_REPOSITORY https://github.com/beman-org/example.git
  GIT_TAG        3f56ffded19291656e6f8cc708c9297f86d7c6cb
)
FetchContent_MakeAvailable(example)

add_executable(use_beman_example main.cpp)
target_link_libraries(use_beman_example PRIVATE example)

main.cpp

#include <iostream>
#include <example.hxx>

int main()
{
  std::cout << "hello beman!\n";
}

[neatudarius]

@frankmiller , can you check #27 ? If you'll add something into docs, please sync with examples from Beman Standard (or update them if required). Thanks!

[ClausKlein]

If a library is used as a subproject no test an no example must be compiled!

You need an individual library_name_build_tests option ...

[neatudarius]

I think was completed via #75