summaryrefslogtreecommitdiff
path: root/o3tl/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'o3tl/README.md')
-rw-r--r--o3tl/README.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/o3tl/README.md b/o3tl/README.md
new file mode 100644
index 000000000000..7900e70171d0
--- /dev/null
+++ b/o3tl/README.md
@@ -0,0 +1,30 @@
+Very basic template functionality, a bit like boost or stl, but specific to LibO
+
+o3tl stands for "OOo [o3, get it?] template library"
+
+From [http://blog.thebehrens.net/2006/01/15/update-cow_wrapper-is-available-now/]
+The scope for o3tl is admittedly kind of ambitious, as it should contain "...very basic (template)
+functionality, comparable to what's provided by boost or stl, but specific to OOo (what comes to mind
+are e.g. stl adapters for our own data types and UNO, and stuff that could in principle be upstreamed
+to boost, but isn't as of now)."
+
+== Class overview ==
+
+[git:o3tl/inc/o3tl/cow_wrapper.hxx]
+A copy-on-write wrapper.
+
+[git:o3tl/inc/o3tl/lazy_update.hxx]
+This template collects data in input type, and updates the output type with the given update functor,
+but only if the output is requested. Useful if updating is expensive, or input changes frequently, but
+output is only comparatively seldom used.
+
+[git:o3tl/inc/o3tl/range.hxx]
+Represents a range of integer or iterator values.
+
+[git:o3tl/inc/o3tl/vector_pool.hxx]
+Simple vector-based memory pool allocator.
+
+[git:o3tl/inc/o3tl/functional.hxx]
+Some more templates, leftovers in spirit of STLport's old functional
+header that are not part of the C++ standard (STLport has been
+replaced by direct use of the C++ STL in LibreOffice).