Add docs to make tidy tests happy :')

Author: WaffleLapkin

crates/ide/src/inlay_hints/adjustment.rs

@@ -1,3 +1,8 @@
+//! Implementation of "adjustment" inlay hints:
+//! ```no_run
+//! let _: u32  = /* <never-to-any> */ loop {};
+//! let _: &u32 = /* &* */ &mut 0;
+//! ```
 use hir::{Adjust, AutoBorrow, Mutability, OverloadedDeref, PointerCast, Safety, Semantics};
 use ide_db::RootDatabase;
 

crates/ide/src/inlay_hints/bind_pat.rs

@@ -1,3 +1,8 @@
+//! Implementation of "type" inlay hints:
+//! ```no_run
+//! fn f(a: i32, b: i32) -> i32 { a + b }
+//! let _x /* i32 */= f(4, 4);
+//! ```
 use hir::{HirDisplay, Semantics, TypeInfo};
 use ide_db::{base_db::FileId, famous_defs::FamousDefs, RootDatabase};
 

crates/ide/src/inlay_hints/binding_mode.rs

@@ -1,3 +1,7 @@
+//! Implementation of "binding mode" inlay hints:
+//! ```no_run
+//! let /* & */ (/* ref */ x,) = &(0,);
+//! ```
 use hir::{Mutability, Semantics};
 use ide_db::RootDatabase;
 

crates/ide/src/inlay_hints/chaining.rs

@@ -1,3 +1,4 @@
+//! Implementation of "chaining" inlay hints.
 use hir::{HirDisplay, Semantics};
 use ide_db::{famous_defs::FamousDefs, RootDatabase};
 use syntax::{

crates/ide/src/inlay_hints/closing_brace.rs

@@ -1,3 +1,8 @@
+//! Implementation of "closing brace" inlay hints:
+//! ```no_run
+//! fn g() {
+//! } /* fn g */
+//! ```
 use hir::{HirDisplay, Semantics};
 use ide_db::{base_db::FileRange, RootDatabase};
 use syntax::{

crates/ide/src/inlay_hints/closure_ret.rs

@@ -1,3 +1,4 @@
+//! Implementation of "closure return type" inlay hints.
 use hir::{HirDisplay, Semantics};
 use ide_db::{base_db::FileId, famous_defs::FamousDefs, RootDatabase};
 use syntax::ast::{self, AstNode};

crates/ide/src/inlay_hints/fn_lifetime_fn.rs

@@ -1,3 +1,7 @@
+//! Implementation of "lifetime elision" inlay hints:
+//! ```no_run
+//! fn example/* <'0> */(a: &/* '0 */()) {}
+//! ```
 use ide_db::{syntax_helpers::node_ext::walk_ty, FxHashMap};
 use itertools::Itertools;
 use syntax::SmolStr;

crates/ide/src/inlay_hints/implicit_static.rs

@@ -1,3 +1,7 @@
+//! Implementation of "implicit static" inlay hints:
+//! ```no_run
+//! static S: &/* 'static */str = "";
+//! ```
 use either::Either;
 use syntax::{
     ast::{self, AstNode},

crates/ide/src/inlay_hints/param_name.rs

@@ -1,3 +1,8 @@
+//! Implementation of "param name" inlay hints:
+//! ```no_run
+//! fn max(x: i32, y: i32) -> i32 { x + y }
+//! _ = max(/*x*/4, /*y*/4);
+//! ```
 use either::Either;
 use hir::{Callable, Semantics};
 use ide_db::{base_db::FileRange, RootDatabase};