Changelog 28

Author: matklad

generated_assists.adoc

@@ -337,35 +337,6 @@ fn main() {
 ```
 
 
-[discrete]
-=== `change_lifetime_anon_to_named`
-**Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ra_assists/src/handlers/change_lifetime_anon_to_named.rs#L9[change_lifetime_anon_to_named.rs]
-
-Change an anonymous lifetime to a named lifetime.
-
-.Before
-```rust
-impl Cursor<'_┃> {
-    fn node(self) -> &SyntaxNode {
-        match self {
-            Cursor::Replace(node) | Cursor::Before(node) => node,
-        }
-    }
-}
-```
-
-.After
-```rust
-impl<'a> Cursor<'a> {
-    fn node(self) -> &SyntaxNode {
-        match self {
-            Cursor::Replace(node) | Cursor::Before(node) => node,
-        }
-    }
-}
-```
-
-
 [discrete]
 === `change_return_type_to_result`
 **Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ra_assists/src/handlers/change_return_type_to_result.rs#L8[change_return_type_to_result.rs]
@@ -566,6 +537,35 @@ fn main() {
 ```
 
 
+[discrete]
+=== `introduce_named_lifetime`
+**Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ra_assists/src/handlers/introduce_named_lifetime.rs#L12[introduce_named_lifetime.rs]
+
+Change an anonymous lifetime to a named lifetime.
+
+.Before
+```rust
+impl Cursor<'_┃> {
+    fn node(self) -> &SyntaxNode {
+        match self {
+            Cursor::Replace(node) | Cursor::Before(node) => node,
+        }
+    }
+}
+```
+
+.After
+```rust
+impl<'a> Cursor<'a> {
+    fn node(self) -> &SyntaxNode {
+        match self {
+            Cursor::Replace(node) | Cursor::Before(node) => node,
+        }
+    }
+}
+```
+
+
 [discrete]
 === `introduce_variable`
 **Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ra_assists/src/handlers/introduce_variable.rs#L14[introduce_variable.rs]

generated_features.adoc

@@ -76,7 +76,7 @@ Navigates to the type of an identifier.
 
 
 === Hover
-**Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ra_ide/src/hover.rs#L63[hover.rs]
+**Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ra_ide/src/hover.rs#L97[hover.rs]
 
 Shows additional information, like type of an expression or documentation for definition when "focusing" code.
 Focusing is usually hovering with a mouse, but can also be triggered with a shortcut.

manual.adoc

@@ -269,6 +269,57 @@ Gnome Builder currently has support for RLS, and there's no way to configure the
 1. Rename, symlink or copy the `rust-analyzer` binary to `rls` and place it somewhere Builder can find (in `PATH`, or under `~/.cargo/bin`).
 2. Enable the Rust Builder plugin.
 
+== Non-Cargo Based Projects
+
+rust-analyzer does not require Cargo.
+However, if you use some other build system, you'll have to describe the structure of your project for rust-analyzer in the `rust-project.json` format:
+
+[source,TypeScript]
+----
+interface JsonProject {
+   /// The set of paths containing the crates for this project.
+   /// Any `Crate` must be nested inside some `root`.
+   roots: string[];
+   /// The set of crates comprising the current project.
+   /// Must include all transitive dependencies as well as sysroot crate (libstd, libcore and such).
+   crates: Crate[];
+}
+
+interface Crate {
+    /// Path to the root module of the crate.
+    root_module: string;
+    /// Edition of the crate.
+    edition: "2015" | "2018";
+    /// Dependencies
+    deps: Dep[];
+    /// The set of cfgs activated for a given crate, like `["unix", "feature=foo", "feature=bar"]`.
+    cfg: string[];
+
+    /// value of the OUT_DIR env variable.
+    out_dir?: string;
+    /// For proc-macro crates, path to compiles proc-macro (.so file).
+    proc_macro_dylib_path?: string;
+}
+
+interface Dep {
+    /// Index of a crate in the `crates` array.
+    crate: number,
+    /// Name as should appear in the (implicit) `extern crate name` declaration.
+    name: string,
+}
+----
+
+This format is provisional and subject to change.
+Specifically, the `roots` setup will be different eventually.
+
+There are tree ways to feed `rust-project.json` to rust-analyzer:
+
+* Place `rust-project.json` file at the root of the project, and rust-anlayzer will discover it.
+* Specify `"rust-analyzer.linkedProjects": [ "path/to/rust-project.json" ]` in the settings (and make sure that your LSP client sends settings as a part of initialize request).
+* Specify `"rust-analyzer.linkedProjects": [ { "roots": [...], "crates": [...] }]` inline.
+
+See https://github.com/rust-analyzer/rust-project.json-example for a small example.
+
 == Features
 
 include::./generated_features.adoc[]

thisweek/_posts/2020-06-08-changelog-28.adoc

@@ -0,0 +1,66 @@
+= Changelog #28
+:sectanchors:
+:page-layout: post
+
+Commit: commit:d6967762dd1fff3cfb65d481ba5a169143205c0e[] +
+Release: release:2020-06-08[]
+
+== New Features
+
+* pr:4711[] don't pass `--all-features` by default, use Cargo's default features instead.
+* pr:4720[] highlight unsafe operations inside unsafe blocks. In VS Code, you can use `editor.semanticTokenColorCustomizations` to customize the actual coloring
++
+[source,json]
+----
+"editor.semanticTokenColorCustomizations": {
+    "[Theme Name]": {
+        "rules": {
+            "operator.unsafe": "#f00",
+            "function.unsafe": "#f00"
+        },
+    }
+}
+----
++
+image::https://user-images.githubusercontent.com/1711539/84034187-48d1fb00-a99a-11ea-960b-e6b3f73e7db1.png[]
+* pr:4382[] allow specifying key-value cfg options in JsonProject.
+* pr:4726[] allow to override build-in project discovery with explicit list of `Cargo.toml`s to import:
++
+[source,json]
+----
+{ "rust-analyzer.linkedProjects": ["/home/projects/rust-analyzer/Cargo.toml"] }
+----
+* pr:4730[] document `rust-project.json` file format, which can be used with non-Cargo based build systems.
+  Docs: https://rust-analyzer.github.io/manual.html#non-cargo-based-projects[#non-cargo-based-projects].
+* pr:4660[] enable hover and autocomplete docs on macro generated items.
+* pr:4748[] implement hover actions, as an alternative UI for code lenses.
++
+image::https://user-images.githubusercontent.com/1711539/84036613-b6cbf180-a99d-11ea-81e3-f3ecd9142937.gif[]
+* pr:4689[] implement return position impl trait.
+
+
+== Fixes
+
+* pr:4750[] fix **Introduce Named Lifetime** assist to work in more cases.
++
+image::https://user-images.githubusercontent.com/1711539/84036167-22fa2580-a99d-11ea-8fec-493520297c3d.gif[]
+* pr:4580[] invoke correct cargo for `run` action in VS Code.
+* pr:4658[] fix lexing of format strings.
+* pr:4721[] use correct modifier for unused code.
+* pr:4502[] mark fixes from diagnostics as quick fixes.
+* pr:4737[] parse default unsafe & default const.
+* pr:4765[] fix type parameter defaults.
+
+== Internal Improvements
+
+* pr:4761[] use Chalk from crates.io.
+* pr:4748[] build specialized index to improve auto-import performance.
+* pr:4717[] compute assists text edits lazily.
+* pr:4703[] document review process and contribution guidelines.
+* pr:4772[] document certain high-level internal architecture invariants.
+* pr:4688[] document initilizationOptions used by rust-analyzer.
+* pr:4710[] make LSP extension for running tests & binaries less rust-specific.
+* pr:4723[] derive local roots from workspace configuration.
+* pr:4724[] rename WorldState -> GlobalState.
+* pr:4758[] actually test `include!(concant!(env!()))` pattern.
+* pr:4760[] preliminary refactorings in preparation for new VFS.