From ed775a2da054027d5bc31fd61c62f1ac2c96d9e5 Mon Sep 17 00:00:00 2001 From: Tilo K Date: Sat, 23 Aug 2025 13:17:52 +0200 Subject: [PATCH] feat: readme and doxyfile --- Doxyfile | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++----- README.md | 34 ++++++++++++++++++++++++++++++ 2 files changed, 92 insertions(+), 5 deletions(-) create mode 100644 README.md diff --git a/Doxyfile b/Doxyfile index d847b4f..dde44ce 100644 --- a/Doxyfile +++ b/Doxyfile @@ -1,5 +1,58 @@ -OUTPUT_DIRECTORY = docs -GENERATE_HTML = YES -GENERATE_LATEX = NO -INPUT *.c *.h -USE_MDFILE_AS_MAINPAGE = README.md \ No newline at end of file +# Project identity +PROJECT_NAME = "tstd" +PROJECT_NUMBER = 0.1.0 +PROJECT_BRIEF = "Tiny STD-like utilities in C" +OUTPUT_DIRECTORY = docs + +# Input +INPUT = src include README.md +FILE_PATTERNS = *.c *.h *.md +RECURSIVE = YES +EXCLUDE = build docs +EXCLUDE_PATTERNS = */.git/* */.cache/* + +# Main page +USE_MDFILE_AS_MAINPAGE = README.md +MARKDOWN_SUPPORT = YES +EXTENSION_MAPPING = md=markdown + +# HTML +GENERATE_HTML = YES +HTML_OUTPUT = html +GENERATE_TREEVIEW = YES +HTML_DYNAMIC_SECTIONS = YES +SEARCHENGINE = YES + +# LaTeX/PDF +GENERATE_LATEX = NO + +# Source browsing +SOURCE_BROWSER = YES +INLINE_SOURCES = YES +STRIP_CODE_COMMENTS = NO + +# Extraction and docs quality +EXTRACT_ALL = YES +EXTRACT_PRIVATE = NO +EXTRACT_STATIC = YES +EXTRACT_LOCAL_CLASSES = YES +HAVE_DOT = YES +CALL_GRAPH = YES +CALLER_GRAPH = YES +DOT_IMAGE_FORMAT = svg +INTERACTIVE_SVG = YES +DOT_TRANSPARENT = YES + +# Warnings and tidy +WARNINGS = YES +WARN_IF_UNDOCUMENTED = YES +WARN_IF_DOC_ERROR = YES +WARN_NO_PARAMDOC = YES +WARN_AS_ERROR = NO +QUIET = NO + +# Preprocessor +ENABLE_PREPROCESSING = YES +MACRO_EXPANSION = YES +EXPAND_ONLY_PREDEF = NO +INCLUDE_PATH = include \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..7399b32 --- /dev/null +++ b/README.md @@ -0,0 +1,34 @@ +# TSTD + +A C library providing various string manipulation utilities. + +## Usage + +To use TSTD in your CMake project, you can either build it from source or include it using FetchContent. + +### Integration with FetchContent + +Add the following to your CMakeLists.txt: + +```cmake +cmake_minimum_required(VERSION 3.20) + +project(myproj C) + +set(CMAKE_C_STANDARD 23) +set(CMAKE_C_STANDARD_REQUIRED ON) + +include(FetchContent) + +FetchContent_Declare( + tstd + GIT_REPOSITORY https://github.com/Tilo-K/tstd.git + GIT_TAG main +) + +FetchContent_MakeAvailable(tstd) + +add_executable(myapp src/main.c) + +target_link_libraries(myapp PRIVATE tstd) +``` \ No newline at end of file