add the beginning of troubleshooting docs

Aspidites/woma/fileutils.py

@@ -1,3 +1,4 @@
+# cython: language_level=3, annotation_typing=True, c_string_encoding=utf-8, boundscheck=False, wraparound=False, initializedcheck=False
 # -*- coding: utf-8 -*-
 """Virtually every Python programmer has used Python for wrangling
 disk contents, and ``fileutils`` collects solutions to some of the

Aspidites/woma/gcutils.py

@@ -1,3 +1,4 @@
+# cython: language_level=3, annotation_typing=True, c_string_encoding=utf-8, boundscheck=False, wraparound=False, initializedcheck=False
 # -*- coding: utf-8 -*-
 """The Python Garbage Collector (`GC`_) doesn't usually get too much
 attention, probably because:

Aspidites/woma/guiutils.py

@@ -1,3 +1,4 @@
+# cython: language_level=3, annotation_typing=True, c_string_encoding=utf-8, boundscheck=False, wraparound=False, initializedcheck=False
 """Disabled as of 2.1.6 but it does seem to work.Except with CD
 """
 # TODO Fix dearpygui module not found

Aspidites/woma/library.wom

@@ -16,5 +16,5 @@
 (mod(x = 0 -> number; y = 0 -> number)) number
     <*> x % y
 
-(mul(x = 0 -> number; y = 0 -> number)) number
+(mul(x = 0 -> number; y = 0 -> number))
 	<*> x * y

Aspidites/woma/mathutils.py

@@ -1,3 +1,4 @@
+# cython: language_level=3, annotation_typing=True, c_string_encoding=utf-8, boundscheck=False, wraparound=False, initializedcheck=False
 """This module provides useful math functions on top of Python's
 built-in :mod:`math` module.
 """

docs/index.rst

@@ -179,6 +179,7 @@ Table of Contents
    limits
    indepth
    builtins
+   troubleshooting
    api
    devinfo
 

docs/troubleshooting.rst

@@ -0,0 +1,20 @@
+Troubleshooting
+###############
+
+Expected end of text
+--------------------
+
+This is particularly common, unfortunately when you neglect certain parsable symbols you get this (rather unhelpful) error.
+For these we have to look at the found context and look for whats missing.
+In the following example we define a function but forgot to include a return annotation:
+
+.. code-block:: woma
+
+    (mul(x = 0 -> number; y = 0 -> number))
+        <*> x * y
+
+This is the error we get when we try to compile:
+
+.. code-block::
+
+    Aspidites._vendor.pyparsing_extension.ParseException: Expected end of text, found in '(mul(x = 0 -> number'...