Update the docs: extending.rst and optlib.rst sections

universal-ctags · Aug 14, 2018 · b40096f · b40096f
1 parent 7a6202b
commit b40096f
Show file tree

Hide file tree

Showing 2 changed files with 756 additions and 361 deletions.
diff --git a/docs/extending.rst b/docs/extending.rst
@@ -2,17 +2,18 @@
 Extending ctags
 =============================================================================
 
-Exuberant-ctags allows a user adding a new parser to ctags with ``--langdef=<LANG>``
-and ``--regex-<LANG>=...`` options,
+Exuberant-ctags allows a user to add a new parser to ctags with ``--langdef=<LANG>``
+and ``--regex-<LANG>=...`` options.
 
-Universal-ctags follows and extends the design of Exuberant-ctags.
+Universal-ctags follows and extends the design of Exuberant-ctags in more
+powerful ways, as described in the following chapters.
 
 Universal-ctags encourages users to share the new parsers defined by
-the options. See :ref:`optlib <optlib>` to know how you can share your
-parser definition with other.
+their options. See :ref:`optlib <optlib>` to know how you can share your
+parser definition with others.
 
-Above new feature is very experimental, especially the directory layout
-for :ref:`optlib <optlib>` will be changed in the future.
+Note that some of the new features are experimental, and will be marked as such
+in the documentation.
 
 .. toctree::
 	:maxdepth: 2