Changelog #13

Author: matklad

manual.adoc

@@ -6,10 +6,10 @@
 
 // Master copy of this document lives in the https://github.com/rust-analyzer/rust-analyzer repository
 
-At it's core, rust-analyzer is a *library* for semantic analysis of the Rust code as it changes over time.
+At its core, rust-analyzer is a *library* for semantic analysis of Rust code as it changes over time.
 This manual focuses on a specific usage of the library -- the implementation of
 https://microsoft.github.io/language-server-protocol/[Language Server Protocol].
-LSP allows various code editors, like VS Code, Emacs or Vim, to implement semantic feature like completion or goto definition by talking to an external language server process.
+LSP allows various code editors, like VS Code, Emacs or Vim, to implement semantic features like completion or goto definition by talking to an external language server process.
 
 To improve this document, send a pull request against
 https://github.com/rust-analyzer/rust-analyzer/blob/master/docs/user/readme.adoc[this file].
@@ -20,7 +20,9 @@ In theory, one should be able to just install the server binary and have it auto
 We are not there yet, so some editor specific setup is required.
 
 Additionally, rust-analyzer needs sources of the standard library.
-This commands adds them:
+If the source code is not present, rust-analyzer will attempt to install it automatically.
+
+To add the sources manually, run the following command:
 
 ```bash
 $ rustup component add rust-src
@@ -34,10 +36,9 @@ https://github.com/rust-analyzer/rust-analyzer/tree/master/editors/code[in tree]
 
 You can install the latest release of the plugin from
 https://marketplace.visualstudio.com/items?itemName=matklad.rust-analyzer[the marketplace].
-By default, the plugin will download the matching version of the server as well.
+By default, the plugin will prompt you to download the matching version of the server as well:
 
-// FIXME: update the image (its text has changed)
-image::https://user-images.githubusercontent.com/36276403/74103174-a40df100-4b52-11ea-81f4-372c70797924.png[]
+image::https://user-images.githubusercontent.com/9021944/75067008-17502500-54ba-11ea-835a-f92aac50e866.png[]
 
 The server binary is stored in `~/.config/Code/User/globalStorage/matklad.rust-analyzer`.
 
@@ -58,20 +59,20 @@ $ cargo xtask install
 ----
 
 You'll need Cargo, nodejs and npm for this.
-To make VS Code use the freshly build server, add this to the settings:
+To make VS Code use the freshly built server, add this to the settings:
 
 [source,json]
 ----
-{ "rust-analyzer.raLspServerPath": "ra_lsp_server" }
+{ "rust-analyzer.serverPath": "rust-analyzer" }
 ----
 
 Note that installing via `xtask install` does not work for VS Code Remote, instead you'll need to install the `.vsix` manually.
 
 === Language Server Binary
 
-Other editors generally require `ra_lsp_server` binary to be in `$PATH`.
-You can download pre-build binary from
-https://github.com/rust-analyzer/rust-analyzer/releases[relases]
+Other editors generally require `rust-analyzer` binary to be in `$PATH`.
+You can download the pre-built binary from
+https://github.com/rust-analyzer/rust-analyzer/releases[releases]
 page, or you can install it from source using the following command:
 
 [source,bash]
@@ -83,7 +84,7 @@ $ cargo xtask install --server
 
 Emacs support is maintained https://github.com/emacs-lsp/lsp-mode/blob/master/lsp-rust.el[upstream].
 
-1. Install recent version of `emacs-lsp` package by following the instructions https://github.com/emacs-lsp/lsp-mode[here].
+1. Install the most recent version of `emacs-lsp` package by following the instructions https://github.com/emacs-lsp/lsp-mode[here].
 2. Set `lsp-rust-server` to `'rust-analyzer`.
 3. Run `lsp` in a Rust buffer.
 4. (Optionally) bind commands like `lsp-rust-analyzer-join-lines`, `lsp-extend-selection` and `lsp-rust-analyzer-expand-macro` to keys.
@@ -100,7 +101,7 @@ The are several LSP client implementations for vim:
 2. Run `:CocInstall coc-rust-analyzer` to install
    https://github.com/fannheyward/coc-rust-analyzer[coc-rust-analyzer],
    this extension implements _most_ of the features supported in the VSCode extension:
-   * same configurations as VSCode extension, `rust-analyzer.raLspServerPath`, `rust-analyzer.enableCargoWatchOnStartup` etc.
+   * same configurations as VSCode extension, `rust-analyzer.serverPath`, `rust-analyzer.enableCargoWatchOnStartup` etc.
    * same commands too, `rust-analyzer.analyzerStatus`, `rust-analyzer.startCargoWatch` etc.
    * highlighting and inlay_hints are not implemented yet
 
@@ -110,18 +111,18 @@ The are several LSP client implementations for vim:
    https://github.com/autozimu/LanguageClient-neovim[here]
    * The github project wiki has extra tips on configuration
 
-2. Configure by adding this to your vim/neovim config file (replacing the existing rust specific line if it exists):
+2. Configure by adding this to your vim/neovim config file (replacing the existing Rust-specific line if it exists):
 +
 [source,vim]
 ----
 let g:LanguageClient_serverCommands = {
-\ 'rust': ['ra_lsp_server'],
+\ 'rust': ['rust-analyzer'],
 \ }
 ----
 
 ==== nvim-lsp
 
-NeoVim 0.5 (not yet released) has built in language server support.
+NeoVim 0.5 (not yet released) has built-in language server support.
 For a quick start configuration of rust-analyzer, use https://github.com/neovim/nvim-lsp#rust_analyzer[neovim/nvim-lsp].
 Once `neovim/nvim-lsp` is installed, use `lua require'nvim_lsp'.rust_analyzer.setup({})` in your `init.vim`.
 
@@ -140,7 +141,7 @@ Installation:
 [source,json]
 ----
 "rust-analyzer": {
-    "command": ["ra_lsp_server"],
+    "command": ["rust-analyzer"],
     "languageId": "rust",
     "scopes": ["source.rust"],
     "syntaxes": [

thisweek/_posts/2020-02-24-changelog-13.adoc

@@ -0,0 +1,55 @@
+= Changelog #13
+:sectanchors:
+:page-layout: post
+
+Commit: commit:cba3c991c8188e87363bbff190e9528606140808[] +
+Release: release:2020-02-24[]
+
+== New Features
+
+* pr:3216[] language server binary is renamed from `ra_lsp_server` to `rust-analyzer`.
+  Additionally, `rust-analyzer.lspServerPath` config is renamed to `rust-analyzer.serverPath`
+
+* pr:3199[], pr:3200[] merge `ra_cli` batch processing utils with the main `rust-analyzer` binary.
+  Now you can, eg, run `rust-analyzer analysis-stats path/to/my/project` to type check all functions in batch.
+  This is intended to help with debugging rust-analyzer itself.
+
+* pr:3206[] automatically install `rust-src` component.
+* pr:3231[] add **Remove mut** assist.
+* pr:3252[] for syntax highlighting, take token color customization into account.
+* pr:3269[] document inlay hints.
+* pr:3278[], pr:3279[] show inlay hints in more cases.
+* pr:3275[] document structural search and replace.
+
+== Fixes
+
+* pr:3229[] fix a crash with non-ascii whitespace in doc-comments.
+* pr:3228[] fix hover for for code inside macro calls.
+* pr:3233[] extend selection correctly handles commas in tuple patterns
+* pr:3239[] remove dependency on libbacktrace.
+* pr:3241[] **Fill missing fields** fix works with enum variants as well.
+* pr:3215[] exclude methods from non-parameter types introduced by generic constraints
+* pr:3248[] fix custom `onEnter` not triggering at the start of a doc comment
+* pr:3251[], pr:3282[] better error messages when workspace loading fails.
+* pr:3259[] fix handing of associated type.
+* pr:3244[] renaming a module now renames both the file and the references to the module.
+* pr:3262[] correctly distinguish between const patterns and bindings.
+* pr:3260[] fix name resolution rules for build-in types.
+* pr:3230[] fix macro expansion for invalid tokens.
+* pr:3277[] gracefully handle cancellation errors in VS Code plugin.
+* pr:3289[], pr:3290[] don't break the kbd:[Enter] key if rust-analyzer returns an error.
+
+
+== Internal Improvements
+
+* pr:3195[] remove dependency on `proptest` property based testing library to
+  improve compile times.
+* pr:3209[], pr:3205[], pr:3258[] switch TypeScript extension linter to eslint.
+* pr:3214[] document all modules in the language server crate.
+* pr:3026[] simplify internal representation of syntax errors.
+* pr:3234[], pr:3235[], pr:3236[] refactor handing of symbols/defs in IDE.
+* pr:3242[] make sure that, by default, rust-analyzer does not depend on C code.
+* pr:3247[] make `rust-analyzer --version` more useful and reliable.
+* pr:3263[] use chalk for unsizing coercions.
+* pr:3274[] refactor navigation-related code to use hir instead of AST.
+* pr:3261[] setup client-side logging infrastructure.