Added docs for the parser

Author: Bernardo-MG

docs/source/_static/diagram/parser_class_diagram.png

@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<diagram program="umlet" version="14.2">
+  <zoom_level>10</zoom_level>
+  <element>
+    <id>UMLClass</id>
+    <coordinates>
+      <x>320</x>
+      <y>110</y>
+      <w>100</w>
+      <h>70</h>
+    </coordinates>
+    <panel_attributes>bg=orange
+/Parser/
+-
+
+-
++parse(): int
+</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>UMLClass</id>
+    <coordinates>
+      <x>320</x>
+      <y>220</y>
+      <w>100</w>
+      <h>70</h>
+    </coordinates>
+    <panel_attributes>bg=yellow
+PlyParser
+-
+
+-
+</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>UMLClass</id>
+    <coordinates>
+      <x>320</x>
+      <y>330</y>
+      <w>100</w>
+      <h>70</h>
+    </coordinates>
+    <panel_attributes>bg=yellow
+DiceParser
+-
+
+-
+</panel_attributes>
+    <additional_attributes/>
+  </element>
+  <element>
+    <id>Relation</id>
+    <coordinates>
+      <x>360</x>
+      <y>170</y>
+      <w>30</w>
+      <h>70</h>
+    </coordinates>
+    <panel_attributes>lt=&lt;&lt;-</panel_attributes>
+    <additional_attributes>10.0;10.0;10.0;50.0</additional_attributes>
+  </element>
+  <element>
+    <id>Relation</id>
+    <coordinates>
+      <x>360</x>
+      <y>280</y>
+      <w>30</w>
+      <h>70</h>
+    </coordinates>
+    <panel_attributes>lt=&lt;&lt;-</panel_attributes>
+    <additional_attributes>10.0;10.0;10.0;50.0</additional_attributes>
+  </element>
+</diagram>

docs/source/_static/diagram/parser_class_diagram.uxf

@@ -118,7 +118,8 @@
                                         ('Usage', './usage.html'),
                                         ('Dice model', './docs/dice.html'),
                                         ('Grammar', './docs/grammar.html'),
-                                        ('Notation', './docs/notation.html')]),
+                                        ('Notation', './docs/notation.html'),
+                                        ('Parser', './docs/parser.html')]),
                      ('Info and Reports', [('Reports', './reports.html'),
                                            ('Code docs', './code/index.html')])],
 }

docs/source/conf.py

@@ -0,0 +1,14 @@
+======
+Parser
+======
+
+.. image:: ../_static/diagram/parser_class_diagram.png
+	:alt: Parser class diagram
+
+The DiceParser is capable of transforming dice notation expressions into the
+dice notation model.
+
+It is based on Ply, and contains all the rules defined in itself.
+
+The classes it extends over are just meant to allow extensions, not to be used
+by themselves.

docs/source/docs/parser.rst

@@ -27,3 +27,4 @@ Features
    docs/dice
    docs/grammar
    docs/notation
+   docs/parser