From: Côme ALLART Date: Mon, 6 Dec 2021 18:04:44 +0000 (+0100) Subject: fix: format assist doc for sourcegen_assists_docs X-Git-Url: https://git.lizzy.rs/?a=commitdiff_plain;h=d55d3b63cb5276e3aa4681ca256565b64037d80d;p=rust.git fix: format assist doc for sourcegen_assists_docs --- diff --git a/crates/ide_assists/src/handlers/generate_documentation_template.rs b/crates/ide_assists/src/handlers/generate_documentation_template.rs index 3abdddbb8cb..8500a4d254c 100644 --- a/crates/ide_assists/src/handlers/generate_documentation_template.rs +++ b/crates/ide_assists/src/handlers/generate_documentation_template.rs @@ -7,35 +7,34 @@ use crate::assist_context::{AssistContext, Assists}; -/// Assist: generate_documentation_template -/// -/// Adds a documentation template above a function definition / declaration -/// -/// ``` -/// fn my_func(a: i32, b: i32) -> Result<(), std::io::Error> { -/// unimplemented!() -/// } -/// ``` -/// -> -/// ``` -/// /// . -/// /// -/// /// # Examples -/// /// -/// /// ```rust -/// /// use my_crate::my_func; -/// /// -/// /// let result = my_func(a, b); -/// /// assert_eq!(result, ); -/// /// ``` -/// /// -/// /// # Errors -/// /// -/// /// This function will return an error if . -/// fn my_func(a: i32, b: i32) -> Result<(), std::io::Error> { -/// unimplemented!() -/// } -/// ``` +// Assist: generate_documentation_template +// +// Adds a documentation template above a function definition / declaration. +// +// ``` +// fn my_$0func(a: i32, b: i32) -> Result<(), std::io::Error> { +// unimplemented!() +// } +// ``` +// -> +// ``` +// /// . +// /// +// /// # Examples +// /// +// /// ``` +// /// use test::my_func; +// /// +// /// assert_eq!(my_func(a, b), ); +// /// ``` +// /// +// /// # Errors +// /// +// /// This function will return an error if . +// fn my_func(a: i32, b: i32) -> Result<(), std::io::Error> { +// unimplemented!() +// } +// ``` pub(crate) fn generate_documentation_template( acc: &mut Assists, ctx: &AssistContext, diff --git a/crates/ide_assists/src/tests/generated.rs b/crates/ide_assists/src/tests/generated.rs index e30f98bcd13..653e51c8372 100644 --- a/crates/ide_assists/src/tests/generated.rs +++ b/crates/ide_assists/src/tests/generated.rs @@ -839,6 +839,36 @@ struct Point { ) } +#[test] +fn doctest_generate_documentation_template() { + check_doc_test( + "generate_documentation_template", + r#####" +fn my_$0func(a: i32, b: i32) -> Result<(), std::io::Error> { + unimplemented!() +} +"#####, + r#####" +/// . +/// +/// # Examples +/// +/// ``` +/// use test::my_func; +/// +/// assert_eq!(my_func(a, b), ); +/// ``` +/// +/// # Errors +/// +/// This function will return an error if . +fn my_func(a: i32, b: i32) -> Result<(), std::io::Error> { + unimplemented!() +} +"#####, + ) +} + #[test] fn doctest_generate_enum_as_method() { check_doc_test(