Skip to content

FAQ.md

Latest commit

 

History

History
70 lines (42 loc) · 2.25 KB

FAQ.md

File metadata and controls

70 lines (42 loc) · 2.25 KB
Raw

cstring - FAQ

The FAQ list is under (constant) development. If you post a question on the Issues forum (https://github.com/synesissoftware/cstring/issues) it will be used to create one.

Table of Contents

FAQs:

Q1: "How do I build cstring?"

See INSTALL.md for the recommended CMake flow (prepare_cmake.sh, then build_cmake.sh).

For a minimal library install with no external dependencies:

$ ./prepare_cmake.sh --no-cpp --disable-testing -m

For a full build including examples and tests, install STLSoft 1.11 and xTests first, then:

$ ./prepare_cmake.sh -m

Execute $ ./prepare_cmake.sh --help for the full set of options.

Q2: "Does cstring have its own unit-tests?"

Yes. Automated tests live under:

  • ./test/unit — unit tests;
  • ./test/component — component tests;
  • ./test/scratch — scratch / exploratory programs (for example libver);

When testing is enabled, build them via prepare_cmake.sh / build_cmake.sh and run with run_all_unit_tests.sh (and CTest where configured). Tests require STLSoft and xTests (and may optionally recognise shwild).

Q3: "How do I build without the C++ examples and tests?"

Pass --no-cpp (or -C) to prepare_cmake.sh, which sets CMake NO_CSTRING_CPP_API=ON. That omits C++ examples and remaining C++ tests.

The C unit-tests still require STLSoft and xTests unless you also pass --disable-testing / -T.

Q4: "Where are the examples?"

Examples live under examples/ (c/ and cpp/), each with a short README.md. They are built when BUILD_EXAMPLES is on (the default); omit them with --disable-examples / -E. Run built examples via run_all_examples.sh. See the examples table in README.md.