aboutsummaryrefslogtreecommitdiff
path: root/TESTING.md
diff options
context:
space:
mode:
authorebraminio <ebrahim@gnu.org>2020-08-14 10:14:14 +0430
committerGitHub <noreply@github.com>2020-08-14 10:14:14 +0430
commit99b8a84cc50346b6788a67eadfe0ebe17545724a (patch)
tree151c8ddbbcd57ce7979f62d9dcda41ca2c59036e /TESTING.md
parent1e48225ca312a955cc7f4a4b7683492e83d77117 (diff)
downloadharfbuzz_ng-99b8a84cc50346b6788a67eadfe0ebe17545724a.tar.gz
[docs] Reorder TESTING.md sections
And use --reconfigure where makes sense
Diffstat (limited to 'TESTING.md')
-rw-r--r--TESTING.md42
1 files changed, 20 insertions, 22 deletions
diff --git a/TESTING.md b/TESTING.md
index bc5f80d10..7e90e9d43 100644
--- a/TESTING.md
+++ b/TESTING.md
@@ -1,48 +1,46 @@
-## Build & Run
+## Build and Test
+
+```shell
+meson build
+ninja -Cbuild
+meson test -Cbuild
+```
+
+### Debug with GDB
+
+```shell
+meson test -Cbuild --gdb testname
+```
+
+## Build and Run
Depending on what area you are working in change or add `HB_DEBUG_<whatever>`.
Values defined in `hb-debug.hh`.
```shell
-CPPFLAGS='-DHB_DEBUG_SUBSET=100' meson setup build
+CPPFLAGS='-DHB_DEBUG_SUBSET=100' meson setup build --reconfigure
meson test -C build
```
### Run tests with asan
```shell
-meson setup build -Db_sanitize=address
+meson setup build -Db_sanitize=address --reconfigure
meson compile -C build
meson test -C build
```
-### Debug with GDB
-
-```
-meson setup build
-meson compile -C build
-meson test -C build --gdb testname
-```
-
### Enable Debug Logging
```shell
-CPPFLAGS=-DHB_DEBUG_SUBSET=100 meson build
+CPPFLAGS=-DHB_DEBUG_SUBSET=100 meson build --reconfigure
ninja -C build
```
-## Build and Test
-
-```shell
-meson build
-ninja -Cbuild
-meson test -Cbuild
-```
-
## Test with the Fuzzer
```shell
-CXXFLAGS="-fsanitize=address,fuzzer-no-link" meson build --default-library=static -Dfuzzer_ldflags="-fsanitize=address,fuzzer" -Dexperimental_api=true
+CXXFLAGS="-fsanitize=address,fuzzer-no-link" meson build --default-library=static -Dfuzzer_ldflags="-fsanitize=address,fuzzer" -Dexperimental_api=true --reconfigure
ninja -C build test/fuzzing/hb-{shape,draw,subset,set}-fuzzer
build/test/fuzzing/hb-subset-fuzzer
```
@@ -50,7 +48,7 @@ build/test/fuzzing/hb-subset-fuzzer
## Profiling
```
-meson build
+meson build --reconfigure
meson compile -C build
build/perf/perf
```