summaryrefslogtreecommitdiff
path: root/o3tl
diff options
context:
space:
mode:
authorHossein <hossein.ir@gmail.com>2021-03-29 21:55:26 +0430
committerAdolfo Jayme Barrientos <fitojb@ubuntu.com>2021-04-07 17:47:16 +0200
commitea5641baeef73af60d025d185901a303844e2d85 (patch)
tree94b343b35e7b8805beb9a1745fe1de2f382574fb /o3tl
parent33da78c21f4243a3e469fb7df79ed1745df70078 (diff)
Updated README.md files to represent current code / use Markdown format
Previously, all of the README files have been renamed to README.md and now, the contents of these files were changed to use Markdown format. Other than format inconsistency, some README.md files lacked information about modules, or were out of date. By using LibreOffice / OpenOffice wiki and other documentation websites, these files were updated. Now every README.md file has a title, and some description. The top-level README.md file is changed to add links to the modules. The result of processing the Markdown format README.md files can be seen at: https://docs.libreoffice.org/ Change-Id: Ic3b0c3c064a2498d6a435253b041df010cd7797a Reviewed-on: https://gerrit.libreoffice.org/c/core/+/113424 Tested-by: Jenkins Reviewed-by: Michael Stahl <michael.stahl@allotropia.de> Reviewed-by: Adolfo Jayme Barrientos <fitojb@ubuntu.com>
Diffstat (limited to 'o3tl')
-rw-r--r--o3tl/README.md46
1 files changed, 27 insertions, 19 deletions
diff --git a/o3tl/README.md b/o3tl/README.md
index 7900e70171d0..89cb9a5c1315 100644
--- a/o3tl/README.md
+++ b/o3tl/README.md
@@ -1,30 +1,38 @@
-Very basic template functionality, a bit like boost or stl, but specific to LibO
+# LibreOffice Template Library
-o3tl stands for "OOo [o3, get it?] template library"
+Very basic template functionality, a bit like boost or STL, but specific to LibreOffice.
-From [http://blog.thebehrens.net/2006/01/15/update-cow_wrapper-is-available-now/]
+o3tl stands for "OOo [o3, get it?] template library", in which OOo stands for OpenOffice.org,
+predecessor of LibreOffice.
+
+From <https://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
+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 ==
+## 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`
-[git:o3tl/inc/o3tl/cow_wrapper.hxx]
-A copy-on-write wrapper.
+ Represents a range of integer or iterator values.
-[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/vector_pool.hxx`
-[git:o3tl/inc/o3tl/range.hxx]
-Represents a range of integer or iterator values.
+ Simple vector-based memory pool allocator.
-[git:o3tl/inc/o3tl/vector_pool.hxx]
-Simple vector-based memory pool allocator.
+- `git:o3tl/inc/o3tl/functional.hxx`
-[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).
+ 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).