switch to using itemized lists

Author: ratmice

doc/src/lexsyntax.md

@@ -6,48 +6,28 @@ Definitions
 %%
 Rules
 %%
-UserSubroutines
+User Subroutines
 ```
 
 ## Definitions
 
-### Optional %grmtools section
-
-Defined in [extensions](./lexextensions.md)
+Within the definitions section, you can add an option `%grmtools` section
+documented in [extensions](./lexextensions.md)
 
 ## Rules 
 
-Each rule is given by
-
-### Optional Start State
-Between angle brackets <Start_State>
-
-### Regex
-
-Regular expressions are define by the rust [regex](https://docs.rs/regex) crate.
-
-
-### Separator space
-
-Any horizontal space character in the unicode `Pattern_White_Space` character set.
-
-### Optional State operator
-
-Between angle brackets these are documented in [Start States](./start_states.md)
-* `<+STATE>` Push the state given by `STATE` to the top of the stack.
-* `<-STATE> Pop the state off the top of the stack.
-* `<STATE>` Replace the state stack with the state `STATE`
-
-
-### Token Name
-
-Token name may contain any non-space character between double quotes, including double quotes
-
-### End of line
-
-The end of line finishes a rule.
+Each rule is given by the following elements in sequence:
 
-## UserSubroutines
+1. Optional Start State, a name given between angle brackets for example `<Start_State>` documented in [Start States](./start_states.md)
+2. Regex, syntax defined by the rust [regex](https://docs.rs/regex) crate with optional escaping for any character.
+3. Separator space, any horizontal space character in the unicode `Pattern_White_Space` character set
+4. Optional State operator, given between angle brackets documented in [Start States](./start_states.md)
+    + `<+STATE>` Push the state given by `STATE` to the top of the stack.
+    + `<-STATE>` Pop the state off the top of the stack.
+    + `<STATE>` Replace the state stack with the state `STATE`
+5. Token Name, for example `"token"` any non-space character between double quotes, including double quotes.
+6. End of line, finishes each rule.
 
-Since lrlex doesn't support user actions, it doesn't support User Subroutines either.
+## User Subroutines
 
+Since lrlex doesn't support user actions, it doesn't support User Subroutines either.