Browse Source

Fixes to documentation to fix warnings and overflow issues. Fixes #49.

Bentley James Oakes 7 years ago
parent
commit
1c9b4aa639

File diff suppressed because it is too large
+ 1 - 1
doc/creating_buttons_and_plugins.rst


+ 1 - 0
doc/installation.rst

@@ -5,6 +5,7 @@ Installation
 ------------
 
 To install AToMPM, follow these steps:
+
 * Download and install the latest Python 2.7.X
     * Use a package manager on Linux
     * Or visit http://python.org/download/

+ 4 - 6
doc/modelling_transformation.rst

@@ -126,6 +126,8 @@ Action Library
 
 .. note:: The *_id* attribute can either be an abstract syntax identifier, or a *__pLabel* value.
 
+.. note:: The notion of full types is best explained by example: the full type of a SimpleClassDiagram.Class entity is "/Formalisms/__LanguageSyntax__/SimpleClassDiagram/SimpleClassDiagram/Class".
+
 +----------------------------------------+-------------------------------------+-------------------------------------------------------------------------------+
 | name                                   | parameters                          | Description                                                                   |
 +========================================+=====================================+===============================================================================+
@@ -142,9 +144,7 @@ Action Library
 +----------------------------------------+-------------------------------------+-------------------------------------------------------------------------------+
 | getAllNodes(_fulltypes)                | * *_fulltypes*: list<string>        | Return the abstract syntax identifiers of all entities whose types are        |
 |                                        |                                     | contained within the fulltypes array. If it is omitted, return the abstract   |
-|                                        |                                     | syntax identifiers of all entities. The notion of full types is best          |
-|                                        |                                     | explained by example: the full type of a SimpleClassDiagram.Class entity is   |
-|                                        |                                     | "/Formalisms/__LanguageSyntax__/SimpleClassDiagram/SimpleClassDiagram/Class". |
+|                                        |                                     | syntax identifiers of all entities.                                           |
 +----------------------------------------+-------------------------------------+-------------------------------------------------------------------------------+
 | getNeighbors(_dir[, _type, _id])       | * *_dir*: string                    | Return neighbours of the given entity, specified via its abstract syntax      |
 |                                        | * *_type*: string                   | identifier or __pLabel. The *_dir* parameter can take on three values: "in"   |
@@ -152,9 +152,7 @@ Action Library
 |                                        |                                     | only outbound neighbours should be returned, "*" implies that neighbours in   |
 |                                        |                                     | either direction should be returned. Finally, the *_type* parameter can be    |
 |                                        |                                     | set to indicate that only neighbours of the given full type should be         |
-|                                        |                                     | returned. The notion of full types is best explained by example: the full     |
-|                                        |                                     | type of a SimpleClassDiagram.Class entity is                                  |
-|                                        |                                     | "/Formalisms/__LanguageSyntax__/SimpleClassDiagram/SimpleClassDiagram/Class". |
+|                                        |                                     | returned.                                                                     |
 |                                        |                                     | To match any type, use "*".                                                   |
 +----------------------------------------+-------------------------------------+-------------------------------------------------------------------------------+
 | print(msg)                             | * *msg*: string                     | Print the given string to the console that launched the AToMPM back-end.      |

+ 9 - 11
doc/new_language.rst

@@ -246,6 +246,8 @@ Action Library
 
 .. rst-class:: table-with-borders
 
+.. note:: The notion of full types is best explained by example: the full type of a SimpleClassDiagram.Class entity is "/Formalisms/__LanguageSyntax__/SimpleClassDiagram/SimpleClassDiagram/Class".
+
 +---------------------------------+-------------------------------------+-------------------------------------------------------------------------------+
 | name                            | parameters                          | Description                                                                   |
 +=================================+=====================================+===============================================================================+
@@ -262,19 +264,15 @@ Action Library
 +---------------------------------+-------------------------------------+-------------------------------------------------------------------------------+
 | getAllNodes(_fulltypes)         | * *_fulltypes*: list<string>        | Return the abstract syntax identifiers of all entities whose types are        |
 |                                 |                                     | contained within the fulltypes array. If it is omitted, return the abstract   |
-|                                 |                                     | syntax identifiers of all entities. The notion of full types is best          |
-|                                 |                                     | explained by example: the full type of a SimpleClassDiagram.Class entity is   |
-|                                 |                                     | "/Formalisms/__LanguageSyntax__/SimpleClassDiagram/SimpleClassDiagram/Class". |
+|                                 |                                     | syntax identifiers of all entities.                                           |
 +---------------------------------+-------------------------------------+-------------------------------------------------------------------------------+
 | getNeighbors(_dir[, _type, _id])| * *_dir*: string                    | Return neighbours of the given entity, specified via its abstract syntax      |
-|                                 | * *_type*: string                   | identifier. The *_dir* parameter can take on three values: "in" implies that  |
-|                                 | * *_id*: string                     | only inbound neighbours should be returned, "out" implies that only outbound  |
-|                                 |                                     | neighbours should be returned, "*" implies that neighbours in either          |
-|                                 |                                     | direction should be returned. Finally, the *_type* parameter can be set to    |
-|                                 |                                     | indicate that only neighbours of the given full type should be re turned. The |
-|                                 |                                     | notion of full types is best explained by example: the full type of a         |
-|                                 |                                     | SimpleClassDiagram.Class entity is                                            |
-|                                 |                                     | "/Formalisms/__LanguageSyntax__/SimpleClassDiagram/SimpleClassDiagram/Class". |
+|                                 | * *_type*: string                   | identifier or __pLabel. The *_dir* parameter can take on three values: "in"   |
+|                                 | * *_id*: string                     | implies that only inbound neighbours should be returned, "out" implies that   |
+|                                 |                                     | only outbound neighbours should be returned, "*" implies that neighbours in   |
+|                                 |                                     | either direction should be returned. Finally, the *_type* parameter can be    |
+|                                 |                                     | set to indicate that only neighbours of the given full type should be         |
+|                                 |                                     | returned.                                                                     |
 |                                 |                                     | To match any type, use "*".                                                   |
 +---------------------------------+-------------------------------------+-------------------------------------------------------------------------------+
 | print(msg)                      | * *msg*: string                     | Print the given string to the console that launched the AToMPM back-end.      |

+ 4 - 4
doc/overview.rst

@@ -173,7 +173,7 @@ When in the **SOMETHING SELECTED** state (*i.e.*, when one or more entity is sel
 | Snap selection to nearest grid point | Press TAB. Enters the **DEFAULT** state.                                    |
 +--------------------------------------+-----------------------------------------------------------------------------+
 
-When in the **DRAGGING SELECTION** state (*i.e.*, when left-dragging one or more selected entity), |dragging_selection|
+When in the **DRAGGING SELECTION** state (*i.e.*, when left-dragging one or more selected entity),
 
 .. image:: img/dragging_selection.png
     :class: inline-image
@@ -194,7 +194,7 @@ When in the **DRAGGING SELECTION** state (*i.e.*, when left-dragging one or more
 | Cancel motion                        | Click ESC. Enters the **DEFAULT** state.                                    |
 +--------------------------------------+-----------------------------------------------------------------------------+
 
-When in the **DRAWING EDGE** state (*i.e.*, when dragging to-be edge from source to target entities), |drawing_edge|
+When in the **DRAWING EDGE** state (*i.e.*, when dragging to-be edge from source to target entities),
 
 .. image:: img/drawing_edge.png
     :class: inline-image
@@ -214,7 +214,7 @@ When in the **DRAWING EDGE** state (*i.e.*, when dragging to-be edge from source
 | Cancel current edge                   | Left-release anywhere on the Canvas. Enters the **DEFAULT** state.          |
 +---------------------------------------+-----------------------------------------------------------------------------+
 
-When in the **EDGE EDITING** state, |edge_editing|
+When in the **EDGE EDITING** state,
 
 .. image:: img/edge_editing.png
     :class: inline-image
@@ -239,7 +239,7 @@ When in the **EDGE EDITING** state, |edge_editing|
 |                                       | **DEFAULT** state.                                                          |
 +---------------------------------------+-----------------------------------------------------------------------------+
 
-When in the **GEOMETRY EDITING** state, |geometry_editing|
+When in the **GEOMETRY EDITING** state,
 
 .. image:: img/geometry_editing.png
     :class: inline-image