documentation updates

how_to_install.txt

@@ -29,8 +29,9 @@ Procedure:
        install the uSmallTalk package. Since this package is not officially
        supported, you'll have to install it manually.
 
-       Move the uSmallTalk package directory inside Sublime's "Packages" folder.
-       The location of this folder varies based on your operating system:
+       Move the 'uSmallTalk' package directory inside Sublime's "Packages"
+       folder. The location of this folder varies based on your
+       operating system:
 
            (a) Windows: $APPDATA/Sublime Text 3/Packages
            (b) OSX:     ~/Library/Application\ Support/Sublime\ Text\ 3/Packages

uSmallTalk/usmalltalk.sublime-syntax

@@ -57,9 +57,29 @@ contexts:
     - include: brackets
     - include: keyword
     - include: literal
+    # - include: operator
+
+
+
 
   keyword:
 
+
+    # - match: \b{{register}}\b
+    #   scope: register
+
+    # - match: '{{label}}(?=:)'
+    #   scope: label
+
+
+    # - match: '\.{{directive}}\b'
+    #   scope: directive
+
+    # - match : '(?s)\b(class)\s+({{name}})(\b)?'
+    #   captures :
+    #     1 : keyword.class
+    #     2 : entity.name.class
+
     - match : '\b(self|super)\b'
       scope : variable.language
 
@@ -88,6 +108,8 @@ contexts:
         - match : '(?={{bracket}})'
           pop   : true
 
+
+
     - match : '\b{{method_definition}}\s+'
       scope : keyword.method
       push  :
@@ -98,6 +120,8 @@ contexts:
     - match : ({{unit_test}})
       scope : unit-test
 
+
+
     - match: \b{{reserved}}\b
       scope: keyword
 
@@ -115,6 +139,14 @@ contexts:
       scope: punctuation.definition.string.begin
       push: quoted_literal
 
+
+
+
+    # string-literals begin and end with quotes, and use backslashes as an escape character.
+    # - match: '"'
+    #   scope: punctuation.definition.string.begin
+    #   push: inside_string
+
   quoted_literal:
     - meta_include_prototype: false
     - meta_scope: string.quoted.single
@@ -134,10 +166,36 @@ contexts:
       scope: punctuation.definition.array.end
       pop: true
 
+  # inside_string:
+  #   - meta_include_prototype: false
+  #   - meta_scope: string.quoted.double
+  #   - match: '\.'
+  #     scope: constant.character.escape
+  #   - match: '"'
+  #     scope: punctuation.definition.string.end
+  #     pop: true
+
+
+
+  # operator:
+  #   # assignment operator
+  #   - match: \:\=
+  #     scope: operator.assignment
+
+  #   - match: '{{relop}}'
+  #     scope: operator.relational
+
+  #   - match: '{{binop}}'
+  #     scope: operator.binary
+
+  #   - match: '{{unop}}'
+  #     scope: operator.unary
+
 
 
   comments:
     # Comments begin with a ';' and finish at the end of the line.
+    #- meta_include_prototype: false
     - match: ';'
       scope: punctuation.definition.comment
       push: