more docs consolidation

zopefoundation · Feb 4, 2017 · edd5682 · edd5682
1 parent 1e402f7
commit edd5682
Show file tree

Hide file tree

Showing 3 changed files with 14 additions and 45 deletions.
diff --git a/docs/update_notes.rst b/docs/update_notes.rst
diff --git a/docs/usage/index.rst b/docs/usage/index.rst
@@ -4,3 +4,4 @@ Usage of RestrictedPython
 .. include:: api.rst
 .. include:: basic_usage.rst
 .. include:: framework_usage.rst
+.. include:: policy.rst
diff --git a/docs/usage/policy.rst b/docs/usage/policy.rst
@@ -0,0 +1,13 @@
+Policies & builtins
+-------------------
+
+
+
+Also RestrictedPython provides a way to define Policies, by redefining restricted versions of ``print``, ``getattr``, ``setattr``, ``import``, etc..
+As shortcutes it offers three stripped down versions of Pythons ``__builtins__``:
+
+* ``safe_builtins`` (by Guards.py)
+* ``limited_builtins`` (by Limits.py), which provides restriced sequence types
+* ``utilities_builtins`` (by Utilities.py), which provides access for standard modules math, random, string and for sets.
+
+There is also a guard function for making attributes immutable --> ``full_write_guard`` (write and delete protected)