summaryrefslogtreecommitdiff
path: root/docs/api
diff options
context:
space:
mode:
authorkotfu <kotfu@kotfu.net>2020-02-22 20:44:11 -0700
committerkotfu <kotfu@kotfu.net>2020-02-22 20:44:11 -0700
commite034b67130de6bfd41199391e3933ef21414fa42 (patch)
tree2af70fd97c46aab0bda8d7d59cde2fbfe0b6e0af /docs/api
parentacf269f07f9437a54d8b02491ed1db3da05f374f (diff)
downloadcmd2-git-e034b67130de6bfd41199391e3933ef21414fa42.tar.gz
Clarify that the API documentation is the public API.
Diffstat (limited to 'docs/api')
-rw-r--r--docs/api/index.rst13
1 files changed, 13 insertions, 0 deletions
diff --git a/docs/api/index.rst b/docs/api/index.rst
index 5935e216..d5fc013b 100644
--- a/docs/api/index.rst
+++ b/docs/api/index.rst
@@ -1,6 +1,19 @@
API Reference
=============
+These pages document the public API for ``cmd2``. If a method, class, function,
+attribute, or constant is not documented here, consider it private and subject
+to change. There are many classes, methods, functions, and constants in the
+source code which do not begin with an underscore but are not documented here.
+When looking at the source code for this library, you can not safely assume
+that because something doesn't start with an underscore, it is a public API.
+
+If a release of this library changes any of the items documented here, the
+version number will be incremented according to the `Semantic Version
+Specification <https://semver.org>`_.
+
+This documentation is for version |version| of ``cmd2``.
+
.. toctree::
:maxdepth: 1