Changelog #115

Author: lnicola

generated_assists.adoc

@@ -585,13 +585,14 @@ fn qux(bar: Bar, baz: Baz) {}
 === `extract_function`
 **Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ide_assists/src/handlers/extract_function.rs#L35[extract_function.rs]
 
-Extracts selected statements into new function.
+Extracts selected statements and comments into new function.
 
 .Before
 ```rust
 fn main() {
     let n = 1;
     ┃let m = n + 2;
+    // calculate
     let k = m + n;┃
     let g = 3;
 }
@@ -607,6 +608,7 @@ fn main() {
 
 fn ┃fun_name(n: i32) {
     let m = n + 2;
+    // calculate
     let k = m + n;
 }
 ```

manual.adoc

@@ -67,16 +67,16 @@ To disable this notification put the following to `settings.json`
 ----
 ====
 
-The server binary is stored in:
+The server binary is stored in the extension install directory, which starts with `matklad.rust-analyzer-` and is located under:
 
-* Linux: `~/.config/Code/User/globalStorage/matklad.rust-analyzer`
-* Linux (Remote, such as WSL): `~/.vscode-server/data/User/globalStorage/matklad.rust-analyzer`
-* macOS: `~/Library/Application\ Support/Code/User/globalStorage/matklad.rust-analyzer`
-* Windows: `%APPDATA%\Code\User\globalStorage\matklad.rust-analyzer`
+* Linux: `~/.vscode/extensions`
+* Linux (Remote, such as WSL): `~/.vscode-server/extensions`
+* macOS: `~/.vscode/extensions`
+* Windows: `%USERPROFILE%\.vscode\extensions`
 
-However, if you are using a version of the extension with a bundled server binary and you are not running NixOS, the server binary might be instead running from: `~/.vscode/extensions/matklad.rust-analyzer-VERSION`.
+As an exception, on NixOS, the extension makes a copy of the server and stores it under `~/.config/Code/User/globalStorage/matklad.rust-analyzer`.
 
-Note that we only support two most recent versions of VS Code.
+Note that we only support the two most recent versions of VS Code.
 
 ==== Updates
 
@@ -86,27 +86,12 @@ It will ask your permission to download the matching language server version bin
 ===== Nightly
 
 We ship nightly releases for VS Code.
+You can opt in to these by switching to the pre-release version in the Code extension page or settings.
 To help us out with testing the newest code and follow the bleeding edge of our `master`, please use the following config:
 
-[source,json]
-----
-{ "rust-analyzer.updates.channel": "nightly" }
-----
-
-You will be prompted to install the `nightly` extension version.
-Just click `Download now` and from that moment you will get automatic updates every 24 hours.
-
-If you don't want to be asked for `Download now` every day when the new nightly version is released add the following to your `settings.json`:
-[source,json]
-----
-{ "rust-analyzer.updates.askBeforeDownload": false }
-----
-
-NOTE: Nightly extension should **only** be installed via the `Download now` action from VS Code.
-
 ==== Manual installation
 
-Alternatively, procure both `rust-analyzer.vsix` and your platform's matching `rust-analyzer-{platform}`, for example from the
+Alternatively, download a VSIX corresponding to your platform from the
 https://github.com/rust-analyzer/rust-analyzer/releases[releases] page.
 
 Install the extension with the `Extensions: Install from VSIX` command within VS Code, or from the command line via:
@@ -115,23 +100,24 @@ Install the extension with the `Extensions: Install from VSIX` command within VS
 $ code --install-extension /path/to/rust-analyzer.vsix
 ----
 
-Copy the `rust-analyzer-{platform}` binary anywhere, then add the path to your settings.json, for example:
+If you are running an unsupported platform, you can install `rust-analyzer-no-server.vsix` and compile or obtain a server binary.
+Copy the server anywhere, then add the path to your settings.json, for example:
 [source,json]
 ----
 { "rust-analyzer.server.path": "~/.local/bin/rust-analyzer-linux" }
 ----
 
 ==== Building From Source
 
-Alternatively, both the server and the Code plugin can be installed from source:
+Both the server and the Code plugin can be installed from source:
 
 [source]
 ----
 $ git clone https://github.com/rust-analyzer/rust-analyzer.git && cd rust-analyzer
 $ cargo xtask install
 ----
 
-You'll need Cargo, nodejs and npm for this.
+You'll need Cargo, nodejs (matching a supported version of VS Code) and npm for this.
 
 Note that installing via `xtask install` does not work for VS Code Remote, instead you'll need to install the `.vsix` manually.
 

thisweek/_posts/2022-02-07-changelog-115.adoc

@@ -0,0 +1,46 @@
+= Changelog #115
+:sectanchors:
+:page-layout: post
+
+Commit: commit:ba330548023607717295f0dfd61b72eda41aa9dd[] +
+Release: release:2022-02-07[]
+
+== Sponsors
+
+**Become a sponsor:** On https://opencollective.com/rust-analyzer/[OpenCollective] or
+https://github.com/sponsors/rust-analyzer[GitHub Sponsors].
+
+== New Features
+
+* pr:11384[] complete local function and closure parameters from surrounding scopes:
++
+image::https://user-images.githubusercontent.com/3757771/152641087-78f8e4c4-275c-4259-a17e-9fe2cc698269.gif[]
+* pr:11401[] add ABI string completions:
++
+image::https://user-images.githubusercontent.com/3757771/152686208-4546f830-e6bd-47f0-ae48-4bb48b499a73.png[]
+* pr:11293[], pr:11395[] implement format string completion:
++
+video::https://user-images.githubusercontent.com/308347/152745371-f6b9a801-ddf1-41ae-afc1-c148f7bfddef.mp4[options=loop]
+* pr:11393[] complete functions and methods from block level impls.
+* pr:11394[] de-prioritize completions of private but editable definitions.
+
+== Fixes
+
+* pr:11182[] (first contribution) don't panic on seeing an unexpected offset.
+* pr:11412[] (first contribution) include `fn`/`type`/`const` keyword in trait impl completion item source ranges.
+* pr:11388[] fix proc-macro server not using the supplied span in `Ident::new`:
++
+image::https://user-images.githubusercontent.com/3757771/151827812-c03b8fc7-7ecf-4959-804a-2680d8e61e8b.png[]
+* pr:11390[] de-prioritize completions of qualified operator function completions.
+* pr:11322[] include comments in "Extract function".
+* pr:11399[] fix assoc type shorthand from method bounds.
+* pr:11402[] fix visibility restriction path completions always using the parent module.
+
+== Internal Improvements
+
+* pr:11416[] (first contribution) fix `eslint` LSP config.
+* pr:11418[] (first contribution) bump `pulldown-cmark-to-cmark` to fix link rendering bug.
+* pr:11291[] make range up-mapping more precise.
+* pr:11397[] refactor completion module split.
+* pr:11403[] shrink `mbe::ExpandError` and `mbe::ParseError`.
+* pr:11406[] update install notes for bundled servers.