@fendent/react-native-enriched 0.5.2-fork.1

package/cpp/README.md

@@ -0,0 +1,59 @@
+# C++ – Gumbo HTML Normalizer
+
+## Gumbo-parser setup
+
+The normalizer depends on a single amalgamation file `GumboParser/GumboParser.h`.
+
+This file was created from the [gumbo-parser](https://codeberg.org/gumbo-parser/gumbo-parser) repository — an actively maintained fork of the original Google gumbo-parser.
+
+### Updating gumbo-parser
+
+If you want to upgrade to a newer version:
+
+1. Clone the repository:
+   ```bash
+   git clone https://codeberg.org/gumbo-parser/gumbo-parser.git
+   ```
+2. Create a new amalgamation from the cloned source files.
+3. Replace the existing `cpp/GumboParser/GumboParser.h` with the newly generated amalgamation.
+
+## Building and running tests
+
+Prerequisites: **CMake ≥ 3.14** and a C/C++ compiler (Clang or GCC).
+
+```bash
+cd cpp
+
+# Configure (only needed once, or after editing CMakeLists.txt)
+cmake -B build -DCMAKE_BUILD_TYPE=Debug
+
+# Build
+cmake --build build
+
+# Run tests
+ctest --test-dir build --output-on-failure
+```
+
+## Upgrading Google Test
+
+GTest is fetched automatically by CMake via `FetchContent`. To change the
+version, edit the `GIT_TAG` in `cpp/CMakeLists.txt`:
+
+```cmake
+FetchContent_Declare(
+    googletest
+    GIT_REPOSITORY https://github.com/google/googletest.git
+    GIT_TAG        v1.17.0   # ← change this to the desired version/tag
+)
+```
+
+Then re-configure and rebuild:
+
+```bash
+cd cpp
+rm -rf build
+cmake -B build -DCMAKE_BUILD_TYPE=Debug
+cmake --build build
+```
+
+Available tags can be found at https://github.com/google/googletest/tags.