Merge pull request #475 from gjsjohnmurray/prepare-1.0.5

CHANGELOG and README for 1.0.5

Author: gjsjohnmurray

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Change Log
 
+## [1.0.5] 5-Nov-2020
+- Defer to Language Server 1.0.5+ for folding range information (#473)
+- Add `objectscript.overwriteServerChanges` setting to permit unconditional import from local file (#464)
+- Fix authentication problem introduced in 1.0.2 (#458)
+- Handle Unicode characters in identifiers (#337)
+- Avoid inappropriate transfer of user-level `objectscript.conn` settings into workspace-level settings (#460)
+- Enhancements available only when proposed APIs are enabled:
+    - Improve format of results from Quick Open server-side file name search (#467)
+    - Add root folder label text to label of isfs file (#455)
+    - Add '(read-only)' suffix to label of non-editable file opened from ObjectScript Explorer (#471)
+
 ## [1.0.4] 30-Oct-2020
 - Wait for connection checks to complete during activation.
 - Display debugging values correctly when they contain characters above ASCII 127.

README.md

@@ -35,6 +35,26 @@ Or install from the ObjectScript extension page on [Visual Studio Marketplace](h
 
 ![installation](https://raw.githubusercontent.com/intersystems-community/vscode-objectscript/master/images/installation.gif)
 
+## Enable Proposed APIs
+
+This extension is able to to take advantage of some VS Code APIs that have not yet been finalized. To permit this:
+
+1. From [Command Palette](https://code.visualstudio.com/docs/getstarted/tips-and-tricks#_command-palette) choose `Preferences: Configure Runtime Arguments`.
+2. In the argv.json file that opens, add this line:
+```json
+"enable-proposed-api": ["intersystems-community.vscode-objectscript"]
+```
+3. Restart VS Code.
+4. Verify that the ObjectScript channel of the Output panel reports this:
+```
+intersystems-community.vscode-objectscript version X.X.X activating with proposed APIs available.
+```
+
+The enabled features (and the APIs used) are:
+- Server-side [searching across files](https://code.visualstudio.com/docs/editor/codebasics#_search-across-files) being accessed using isfs (TextSearchProvider)
+- [Quick Open](https://code.visualstudio.com/docs/getstarted/tips-and-tricks#_quick-open) of isfs files (FileSearchProvider).
+- Improved labels (tabs, file lists, tooltips) for server-side files (ResourceLabelFormatter)
+
 ## Configure Connection
 
 To be able to use many features you first need to configure the connection to your IRIS/Caché/Ensemble server(s) in your [VS Code settings](https://code.visualstudio.com/docs/getstarted/settings). If you are unfamiliar with how settings work and how they are edited, use that link.