aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/index.rst1
-rw-r--r--doc/view.rst110
2 files changed, 111 insertions, 0 deletions
diff --git a/doc/index.rst b/doc/index.rst
index ef53ca8..e83bb53 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -6,6 +6,7 @@ Vis Editor API Documenation
vis
text
+ view
buffer
array
map
diff --git a/doc/view.rst b/doc/view.rst
new file mode 100644
index 0000000..c48d565
--- /dev/null
+++ b/doc/view.rst
@@ -0,0 +1,110 @@
+View
+====
+
+Provides a viewport of a text instance and mangages selections.
+
+Lifecycle
+---------
+
+.. doxygengroup:: view_life
+ :content-only:
+
+Viewport
+--------
+
+The cursor of the primary selection is always visible.
+
+.. doxygengroup:: view_viewport
+ :content-only:
+
+Dimension
+---------
+
+.. doxygengroup:: view_size
+ :content-only:
+
+Draw
+----
+
+.. doxygengroup:: view_draw
+ :content-only:
+
+Selections
+----------
+
+A selection is a non-empty, directed range with two endpoints called *cursor*
+and *anchor*. A selection can be anchored in which case the anchor remains
+fixed while only the position of the cursor is adjusted. For non-anchored
+selections both endpoints are updated. A singleton selection
+covers one character on which both cursor and anchor reside. There always
+exists a primary selection which remains visible (i.e. changes to its position
+will adjust the viewport).
+
+Creation and Destruction
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. doxygengroup:: view_selnew
+ :content-only:
+
+Navigation
+~~~~~~~~~~
+
+.. doxygengroup:: view_navigate
+ :content-only:
+
+Cover
+~~~~~
+
+.. doxygengroup:: view_cover
+ :content-only:
+
+Anchor
+~~~~~~
+
+.. doxygengroup:: view_anchor
+ :content-only:
+
+Cursor
+~~~~~~
+
+Selection endpoint to which cursor motions apply.
+
+Properties
+^^^^^^^^^^
+
+.. doxygengroup:: view_props
+ :content-only:
+
+Placement
+^^^^^^^^^
+
+.. doxygengroup:: view_place
+ :content-only:
+
+Motions
+^^^^^^^^
+
+These functions perform motions based on the current selection cursor position.
+
+.. doxygengroup:: view_motions
+ :content-only:
+
+Primary Selection
+~~~~~~~~~~~~~~~~~
+
+These are convenience function which operate on the primary selection.
+
+.. doxygengroup:: view_primary
+ :content-only:
+
+Save and Restore
+~~~~~~~~~~~~~~~~
+
+.. doxygengroup:: view_save
+ :content-only:
+
+Style
+-----
+
+.. doxygengroup:: view_style
+ :content-only: