Added test for check doc strings in crates.

#1856

crates/ra_hir/src/code_model.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 pub(crate) mod src;
 pub(crate) mod docs;
 

crates/ra_hir/src/code_model/docs.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use std::sync::Arc;
 
 use ra_syntax::ast;

crates/ra_hir/src/code_model/src.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use ra_syntax::{
     ast::{self, AstNode},
     SyntaxNode,

crates/ra_hir/src/db.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use std::sync::Arc;
 
 use ra_db::{salsa, SourceDatabase};

crates/ra_hir/src/diagnostics.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use std::{any::Any, fmt};
 
 use ra_syntax::{ast, AstNode, AstPtr, SyntaxNode, SyntaxNodePtr, TextRange};

crates/ra_hir/src/either.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 #[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
 pub enum Either<A, B> {
     A(A),

crates/ra_hir/src/expr.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 pub(crate) mod lower;
 pub(crate) mod scope;
 pub(crate) mod validation;

crates/ra_hir/src/expr/lower.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use ra_arena::Arena;
 use ra_syntax::{
     ast::{

crates/ra_hir/src/expr/scope.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use std::sync::Arc;
 
 use ra_arena::{impl_arena_id, Arena, RawId};

crates/ra_hir/src/expr/validation.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use std::sync::Arc;
 
 use ra_syntax::ast;

crates/ra_hir/src/from_source.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use ra_db::{FileId, FilePosition};
 use ra_syntax::{
     algo::find_node_at_offset,

crates/ra_hir/src/ids.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use std::{
     hash::{Hash, Hasher},
     sync::Arc,

crates/ra_hir/src/impl_block.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use rustc_hash::FxHashMap;
 use std::sync::Arc;
 

crates/ra_hir/src/lang_item.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use rustc_hash::FxHashMap;
 use std::sync::Arc;
 

crates/ra_hir/src/lib.rs

@@ -1,5 +1,3 @@
-#![recursion_limit = "512"]
-
 //! HIR (previously known as descriptors) provides a high-level object oriented
 //! access to Rust code.
 //!
@@ -7,6 +5,8 @@
 //! to a particular crate instance. That is, it has cfg flags and features
 //! applied. So, the relation between syntax and HIR is many-to-one.
 
+#![recursion_limit = "512"]
+
 macro_rules! impl_froms {
     ($e:ident: $($v:ident $(($($sv:ident),*))?),*) => {
         $(

crates/ra_hir/src/marks.rs

@@ -1,3 +1,5 @@
+//! See test_utils/src/marks.rs
+
 test_utils::marks!(
     bogus_paths
     name_res_works_for_broken_modules

crates/ra_hir/src/mock.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use std::{panic, sync::Arc};
 
 use parking_lot::Mutex;

crates/ra_hir/src/name.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use std::fmt;
 
 use ra_syntax::{ast, SmolStr};

crates/ra_hir/src/nameres/collector.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use ra_db::FileId;
 use ra_syntax::{ast, SmolStr};
 use rustc_hash::FxHashMap;

crates/ra_hir/src/nameres/per_ns.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use crate::{MacroDef, ModuleDef};
 
 #[derive(Clone, Copy, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]

crates/ra_hir/src/nameres/raw.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use std::{ops::Index, sync::Arc};
 
 use ra_arena::{impl_arena_id, map::ArenaMap, Arena, RawId};

crates/ra_hir/src/path.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use std::{iter, sync::Arc};
 
 use ra_syntax::{

crates/ra_hir/src/source_binder.rs

@@ -1,10 +1,10 @@
-/// Lookup hir elements using positions in the source code. This is a lossy
-/// transformation: in general, a single source might correspond to several
-/// modules, functions, etc, due to macros, cfgs and `#[path=]` attributes on
-/// modules.
-///
-/// So, this modules should not be used during hir construction, it exists
-/// purely for "IDE needs".
+//! Lookup hir elements using positions in the source code. This is a lossy
+//! transformation: in general, a single source might correspond to several
+//! modules, functions, etc, due to macros, cfgs and `#[path=]` attributes on
+//! modules.
+//!
+//! So, this modules should not be used during hir construction, it exists
+//! purely for "IDE needs".
 use std::sync::Arc;
 
 use ra_db::FileId;

crates/ra_hir/src/source_id.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use std::{
     hash::{Hash, Hasher},
     marker::PhantomData,

crates/ra_hir/src/ty/display.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use std::fmt;
 
 use crate::db::HirDatabase;

crates/ra_hir/src/ty/op.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use super::{InferTy, Ty, TypeCtor};
 use crate::{
     expr::{BinaryOp, CmpOp},

crates/ra_hir/src/ty/primitive.rs

@@ -1,3 +1,5 @@
+//! FIXME: write short doc here
+
 use std::fmt;
 
 #[derive(Debug, Copy, Clone, Eq, PartialEq, Hash)]