aboutsummaryrefslogtreecommitdiff
path: root/src/lib/string/lib_string.dox
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2019-11-04 10:19:41 -0500
committerNick Mathewson <nickm@torproject.org>2019-11-04 10:21:10 -0500
commit51a98929148e9ca08b33735fb0542759380c57a9 (patch)
tree96951d1d564d4ac379e9feba4a28807c2855e875 /src/lib/string/lib_string.dox
parentb6b125709998a81d9c9c23d77c6a770ca7a927a7 (diff)
downloadtor-51a98929148e9ca08b33735fb0542759380c57a9.tar.gz
tor-51a98929148e9ca08b33735fb0542759380c57a9.zip
doxygen: Take "lib" descriptions from doc/HACKING/design.
This commit takes descriptions for src/lib and moves them into our doxygen hierarchy. I've covered everything from lib/cc through lib/sandbox here.
Diffstat (limited to 'src/lib/string/lib_string.dox')
-rw-r--r--src/lib/string/lib_string.dox13
1 files changed, 12 insertions, 1 deletions
diff --git a/src/lib/string/lib_string.dox b/src/lib/string/lib_string.dox
index 3e038ea072..95645ab368 100644
--- a/src/lib/string/lib_string.dox
+++ b/src/lib/string/lib_string.dox
@@ -1,4 +1,15 @@
/**
@dir lib/string
-@brief lib/string
+@brief lib/string: Low-level string manipulation.
+
+We have a number of compatibility functions here: some are for handling
+functionality that is not implemented (or not implemented the same) on every
+platform; some are for providing locale-independent versions of libc
+functions that would otherwise be defined differently for different users.
+
+Other functions here are for common string-manipulation operations that we do
+in the rest of the codebase.
+
+Any string function high-level enough to need logging belongs in a
+higher-level module.
**/