Release 1.3.0

.gitignore

@@ -0,0 +1,2 @@
+.vscode
+tools

.vscode/settings.json

@@ -1,3 +1,5 @@
 // Place your settings in this file to overwrite default and user settings.
 {
+    "debug.openDebug": "neverOpen",
+    "debug.internalConsoleOptions": "neverOpen"
 }

CHANGELOG.md

@@ -1,124 +1,131 @@
+## 1.3.0
+- [**general**] Converted both Lua and TOC grammars from PLIST to JSON format.
+- [**language.lua**] Updated to (hopefully) match WoW 8.0.1 build 28153 (most notably caught up a bunch of C_* namespaces I somehow missed in the previous release).
+- [**language.lua**] Fine-tuned the grammar in many ways.
+- [**themes**] Incorporated the latest (v1.28) VS Code themes.
+- [**general**] Updated [Readme.md](Readme.md).
+
 ## 1.2.7
-- [language.lua] Added some more idenfiers.
-- [language.lua] Fixed some minor glitches.
-- [language.lua] Added support for folding regions in lua code with `--#region` and `--#endregion`
+- [**language.lua**] Updated to (hopefully) match WoW 8.0.1 build 27791.
+- [**language.lua**] Fixed some minor glitches.
+- [**language.lua**] Added support for folding regions in Lua code with `--#region` and `--#endregion`.
 
 ## 1.2.6
-- [language.lua] Updated to (hopefully) match WoW 8.0 build 27547.
+- [**language.lua**] Updated to (hopefully) match WoW 8.0 build 27547.
 
 ## 1.2.5
-- [language.lua] Updated to (hopefully) match WoW 7.3.2 build 25549.
-- [language.lua] Added support for intendation rules to lua-language-configuration.json
+- [**language.lua**] Updated to (hopefully) match WoW 7.3.2 build 25549.
+- [**language.lua**] Added support for intendation rules to `lua-language-configuration.json`.
 
 ## 1.2.4
-- [language.lua] Updated to match WoW 7.2.5 build 24330.
+- [**language.lua**] Updated to match WoW 7.2.5 build 24330.
 
 ## 1.2.3
-- [language.lua] Updated to match WoW 7.2.5 build 24076.
+- [**language.lua**] Updated to match WoW 7.2.5 build 24076.
 
 ## 1.2.2
-- [language.lua] More identifiers. Again.
-- [themes] Incorporated the latest (1.12.2) VS Code default themes
+- [**language.lua**] More identifiers. Again.
+- [**themes**] Incorporated the latest (1.12.2) VS Code default themes.
 
 ## 1.2.1
-- [language.lua] More closely match WoW's Lua 5.1 environement: functions like `tinsert()`, `table.getn()`, `table.foreach()`... actually exist in WoW so we don't tag them as invalid or deprecated anymore.
-- [language.lua] Fixed a typo in `'RightButton'`
-- [language.lua] Added a few more identifiers
-- [general] Reworked and simplified [Readme.md](Readme.md)
+- [**language.lua**] More closely match WoW's Lua 5.1 environement: functions like `tinsert()`, `table.getn()`, `table.foreach()`... actually exist in WoW so we don't tag them as invalid or deprecated anymore.
+- [**language.lua**] Fixed a typo in `'RightButton'`.
+- [**language.lua**] Added a few more identifiers.
+- [**general**] Reworked and simplified [Readme.md](Readme.md).
 
 ## 1.2.0
-- [language.lua] Added some more identifiers to match up WoW 7.2.0
-- [snippets] New: 80+ code snippets, courtesy of m4xc4v413r4
-- [themes] Incorporated the latest (1.11) VS Code default themes
-- [general] Cleaned up directories
+- [**language.lua**] Added some more identifiers to match up WoW 7.2.0.
+- [**snippets**] New: 80+ code snippets, courtesy of [m4xc4v413r4](https://github.com/m4xc4v413r4).
+- [**themes**] Incorporated the latest (1.11) VS Code default themes.
+- [**general**] Cleaned up directories.
 
 ## 1.1.11
-- [language.lua] Added some more identifiers to match up WoW 7.1.5
+- [**language.lua**] Added some more identifiers to match up WoW 7.1.5.
 
 ## 1.1.10
-- [general] Fixed the color mismatch in WoW themes introduced by VS Code 1.9.0
+- [**general**] Fixed the color mismatch in WoW themes introduced by VS Code 1.9.0.
 
 ## 1.1.9
-- [language.lua] Added some more identifiers -- again
+- [**language.lua**] Added some more identifiers -- again.
 
 ## 1.1.8
-- [language.lua] Added some more identifiers
+- [**language.lua**] Added some more identifiers.
 
 ## 1.1.7
-- [language.lua] Added some more identifiers
+- [**language.lua**] Added some more identifiers.
 
 ## 1.1.6
-- [language.lua] More regexes optimizations
-- [language.lua] Added some more identifiers
+- [**language.lua**] More regexes optimizations.
+- [**language.lua**] Added some more identifiers.
 
 ## 1.1.5
 - Inadvertently broke a regex. Oops.
 
 ## 1.1.4
-- [language.lua] Optimized some more regexes
-- [language.lua] Added some more identifiers
-- [themes] Incorporated latest (v1.7) Dark and Dark+ themes
-- [misc] moved CHANGELOG.md to a separate file
+- [**language.lua**] Optimized some more regexes.
+- [**language.lua**] Added some more identifiers.
+- [**themes**] Incorporated latest (v1.7) Dark and Dark+ themes.
+- [**misc**] moved CHANGELOG.md to a separate file.
 
 ## 1.1.3
-- [language.lua] Corrected a typo that prevented the bundle from correctly loading. Sorry guys.
+- [**language.lua**] Corrected a typo that prevented the bundle from correctly loading. Sorry guys.
 
 ## 1.1.2
-- [language.lua] Allow method calls on array items, eg. thins like `mytable[1]:SetText('something')` will be correctly recognized
-- [language.lua] Added some missing widget methods
+- [**language.lua**] Allow method calls on array items, eg. thins like `mytable[1]:SetText('something')` will be correctly recognized.
+- [**language.lua**] Added some missing widget methods.
 
 ## 1.1.1
-- [language.lua] More regexes optimizations
-- [language.lua] More Library and removed functions
-- [themes] Added Light+ (WoW) color theme
+- [**language.lua**] More regexes optimizations.
+- [**language.lua**] More Library and removed functions.
+- [**themes**] Added Light+ (WoW) color theme.
 
 ## 1.1.0
-- [general] Major code cleanup, rewrote almost all regexes
-- [languages.lua] No longer differenciate Blizzard's Lua extensions like `strsplit()` or `wipe()` from core Lua functions, they all show up as **support.function.lua**. This was done because a) wow-bundle is a WoW-colorizer, not a Lua one; and b) this reduces the kaleidoscope-ish look of Lua code
-- [language.lua] Lua tables do not have a __metatable, things like `mytable:sort()` do not exist
-- [language.lua] Renamed a bunch of scopes to more closely adhere to scope naming conventions
+- [**general**] Major code cleanup, rewrote almost all regexes.
+- [**languages.lua**] No longer differenciate Blizzard's Lua extensions like `strsplit()` or `wipe()` from core Lua functions, they all show up as **support.function.lua**. This was done because a) wow-bundle is a WoW-colorizer, not a Lua one; and b) this reduces the kaleidoscope-ish look of Lua code.
+- [**language.lua**] Lua tables do not have a __metatable, things like `mytable:sort()` do not exist.
+- [**language.lua**] Renamed a bunch of scopes to more closely adhere to scope naming conventions.
 
 ## 1.0.8
 - Not really. Just got things mixed up and bumped an already bumped version tag...
 
 ## 1.0.7
-- [language.lua] Added `'k'`, `'v'`, `'kv'` and `'vk'` (used by the `__mode` metamethod) as quoted constants
-- [language.lua] Also added the comma (`,`) and the ellipsis (`...`) as operators
-- [language.lua] Better `meta.function.lua` patterns
-- [themes] Tweaked some colors and styles
+- [**language.lua**] Added `'k'`, `'v'`, `'kv'` and `'vk'` (used by the `__mode` metamethod) as quoted constants.
+- [**language.lua**] Also added the comma (`,`) and the ellipsis (`...`) as operators.
+- [**language.lua**] Better `meta.function.lua` patterns.
+- [**themes**] Tweaked some colors and styles.
 
 ## 1.0.6
-- [themes] Added the **Monokai (WoW)** and **Monokai Dimmed (WoW)** themes
-- [language.lua] Added the semicolon `;` as an operator (which it is, albeit an optional one)
-- [language.lua] Better character escapes matching and colorizing
-- [language.lua] Added some identifiers to `support.constant.wow.global.lua`
+- [**themes**] Added the **Monokai (WoW)** and **Monokai Dimmed (WoW)** themes.
+- [**language.lua**] Added the semicolon `;` as an operator (which it is, albeit an optional one).
+- [**language.lua**] Better character escapes matching and colorizing.
+- [**language.lua**] Added some identifiers to `support.constant.wow.global.lua`
 
 ## 1.0.5
-- [language.lua] Added support for Lua types (eg. `'string'`, `'table'`, `'function'`...) as returned by the the `type()` function
-- [language.lua] Don't highlight partial words like 'date' in 'update' or 'time' in 'downtime'
-- [language.lua] Added API constants for `texture:SetBlendMode()`: `'ADD'`, `'ALPHAKEY'`, `'BLEND'`, `'DISABLE'` and `'MOD'`
-- [language.toc] Allow all chars in X-tags, not only numbers, letters and hyphen
-- [misc] Removed old `./sources` directory which was completely out of sync
+- [**language.lua**] Added support for Lua types (eg. `'string'`, `'table'`, `'function'`...) as returned by the the `type()` function.
+- [**language.lua**] Don't highlight partial words like 'date' in 'update' or 'time' in 'downtime'.
+- [**language.lua**] Added API constants for `texture:SetBlendMode()`: `'ADD'`, `'ALPHAKEY'`, `'BLEND'`, `'DISABLE'` and `'MOD'`.
+- [**language.toc**] Allow all chars in X-tags, not only numbers, letters and hyphen.
+- [**misc**] Removed old `./sources` directory which was completely out of sync.
 
 ## 1.0.4
-- [language.lua] Finally found a way to differenciate quoted constants like functions parameters, event names, script handlers... from strings
-- [language.lua] `message()`, `print()`, `getprinthandler()`, `setprinthandler()`, `tostringall()` are actually Lua code in FrameXML, not language extensions
-- [language.lua] Added some 7.0.3 identifiers, many are still missing though
-- [theme] Changed colors of .toc file keywords for consistency with the default Dark+ colors
-- [misc] When the source code reads _'For testing only, comment out before publishing'_, well... just do it
+- [**language.lua**] Finally found a way to differenciate quoted constants like functions parameters, event names, script handlers... from strings.
+- [**language.lua**] `message()`, `print()`, `getprinthandler()`, `setprinthandler()`, `tostringall()` are actually Lua code in FrameXML, not language extensions.
+- [**language.lua**] Added some 7.0.3 identifiers, many are still missing though.
+- [**theme**] Changed colors of .toc file keywords for consistency with the default Dark+ colors.
+- [**misc**] When the source code reads _'For testing only, comment out before publishing'_, well... just do it.
 
 ## 1.0.3
-- [language.toc] Renamed `keyword.language.toc` and `support.language.toc` scopes to `keyword.other.toc` and `support.other.toc`
-- [language.lua] Added a bunch of API definitions
-- [language.lua] `tinsert()` and `tremove()` were actually Blizzard language extensions that got ~~removed~~ deprecated in WoW 6.0.2
+- [**language.toc**] Renamed `keyword.language.toc` and `support.language.toc` scopes to `keyword.other.toc` and `support.other.toc`.
+- [**language.lua**] Added a bunch of API definitions.
+- [**language.lua**] `tinsert()` and `tremove()` were actually Blizzard language extensions that got ~~removed~~ deprecated in WoW 6.0.2.
 
 ## 1.0.2
-- [language.lua] Stupid typo fix
-- Updated `Readme.md`
+- [**language.lua**] Stupid typo fix.
+- **Updated** `Readme.md`.
 
 ## 1.0.1
-- [theme] Stop recolorizing the default Lua language constructs, you'll really get Dark+ colors for these
-- Reorganized the internal directory structure in preparation for TODO #4
+- [**theme**] Stop recolorizing the default Lua language constructs, you'll really get Dark+ colors for these.
+- Reorganized the internal directory structure in preparation for TODO #4.
 
 ## 1.0.0
 Initial release.

README.md

@@ -5,7 +5,11 @@
 
 This World of Warcraft addon developer toolset for VS Code includes an improved Lua language grammar with WoW API knowledge, a .toc file grammar, colorization for both .lua source and .toc files, and more.
 
-**Notice:** wow-bundle is NOT a generic Lua colorizer, it is closely bound to WoW specificities and may not be adapted to other Lua environments.
+
+## Notice
+
+* **wow-bundle is NOT a generic Lua colorizer, it is closely bound to WoW specificities and is not adapted to other Lua environments.** Therefore, you may want to disable this extension when working on non-WoW Lua projects.
+
 
 ## Warning
 
@@ -14,7 +18,7 @@ This World of Warcraft addon developer toolset for VS Code includes an improved
 
 ## Features
 
-* **Full (I hope...) WoW 8.0.1 (Build 27791) API**
+* **Full (I hope...) WoW 8.0.1 (Build 28153) API**
 * Includes a bunch of useful code snippets, thanks to [m4xc4v413r4](https://github.com/m4xc4v413r4)
 * Improved Lua 5.1 grammar with World of Warcraft's built-in Lua interpreter specificities
 * Extensive FrameXML widgets and Lua library support
@@ -28,9 +32,9 @@ This World of Warcraft addon developer toolset for VS Code includes an improved
 
 wow-bundle replaces VS Code's built-in Lua language grammar. Changes worth noticing are:
 
-* **OO-style string functions** support, ie. both `string.upper(mystring)` and `mystring:upper()` are supported
+* **OO-style string functions** support, ie. `string.upper(mystring)`, `mystring:upper()` and even `("somestring"):upper()` are supported!
 * **Full metamethods** support
-* **Quoted string constants** as used or returned by the `collectgarbage()`, `date()` and `type()` functions and the `__mode()` metamethod
+* **Quoted string constants** as consumed or returned by the `collectgarbage()`, `date()` and `type()` functions and the `__mode()` metamethod
 * Better **character escapes** inside strings: Unicode entities, decimal and hexadecimal values and control chars
 
 
@@ -39,7 +43,7 @@ wow-bundle replaces VS Code's built-in Lua language grammar. Changes worth notic
 wow-bundle's Lua grammar also tags a bunch of WoW-related stuff:
 
 * **Blizzard's extensions to the Lua language** like `[table.]wipe()`, `strjoin()`, etc.
-* **World of Warcraft API functions**, with support for functions that can't be called while in combat and functions that can be called only from secure code
+* **World of Warcraft API functions**, with (poor, honestly) support for functions that can't be called while in combat and functions that can be called only from secure code
 * **WoW Library functions** written in Lua (mostly used by UI code)
 * **Global objects** like `UIParent`, `GameFontNormal` and such
 * **Global variables** like `HIGHLIGHT_FONT_COLOR_CODE`, `UIDROPDOWNMENU_INIT_MENU` and such
@@ -69,7 +73,13 @@ However, for further colorization granularity, wow-bundle also includes four spe
 
 wow-bundle's themes do not interfere with VS Code default colors for Lua or any other language you may use.
 
->New since 1.0.1: I do however add italics to ALL comments ~~and underline to invalid/deprecated keywords~~.
+>New since 1.0.1: I do however add italics to ALL comments ~~and underline to invalid/deprecated keywords~~. Should you whish to disable this feature, set the following setting into VS Code settings:
+
+    "editor.tokenColorCustomizations": {
+        "comments": {
+            "fontStyle": ""
+        }
+    }
 
 >New since 1.0.7: No more underline for invalids, not everybody likes it.
 
@@ -98,7 +108,4 @@ Found an issue not listed here? Head up to Github and [open an issue](https://gi
 
 ## Release notes
 
-See [Changelog.md](CHANGELOG.md)
-
-[wow-bundle]: https://github.com/Septh/vscode-wow-bundle
-[VS Code]: https://code.visualstudio.com/
+See [Changelog.md](CHANGELOG.md).