From f6b0d18e24d49e5ecdcd18393c9c3109441a83e9 Mon Sep 17 00:00:00 2001
From: Henrik Tjäder <henrik@tjaders.com>
Date: Sun, 22 Jan 2023 00:26:09 +0100
Subject: Improve RTIC doc handling

Enable use of

```
 #![deny(missing_docs)]
```
---
 macros/src/codegen/init.rs | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

(limited to 'macros/src/codegen/init.rs')

diff --git a/macros/src/codegen/init.rs b/macros/src/codegen/init.rs
index eaf7f612..e8a9c8b9 100644
--- a/macros/src/codegen/init.rs
+++ b/macros/src/codegen/init.rs
@@ -65,22 +65,27 @@ pub fn codegen(app: &App, analysis: &Analysis, extra: &Extra) -> CodegenResult {
             )
         })
         .collect();
+
+    let shared_resources_doc = &format!(" RTIC shared resource struct");
+    let local_resources_doc = &format!(" RTIC local resource struct");
     root_init.push(quote! {
+        #[doc = #shared_resources_doc]
         struct #shared {
             #(#shared_resources)*
         }
 
+        #[doc = #local_resources_doc]
         struct #local {
             #(#local_resources)*
         }
     });
 
-    // let locals_pat = locals_pat.iter();
-
     let user_init_return = quote! {#shared, #local, #name::Monotonics};
+    let user_init_doc = &format!(" User provided init function");
 
     let user_init = quote!(
         #(#attrs)*
+        #[doc = #user_init_doc]
         #[inline(always)]
         #[allow(non_snake_case)]
         fn #name(#context: #name::Context) -> (#user_init_return) {
@@ -100,7 +105,6 @@ pub fn codegen(app: &App, analysis: &Analysis, extra: &Extra) -> CodegenResult {
         mod_app = Some(constructor);
     }
 
-    // let locals_new = locals_new.iter();
     let call_init = quote! {
         let (shared_resources, local_resources, mut monotonics) = #name(#name::Context::new(core.into()));
     };
-- 
cgit v1.2.3


From 3f74f3b8459fdd451707511954a6ea3d128aabe3 Mon Sep 17 00:00:00 2001
From: Henrik Tjäder <henrik@tjaders.com>
Date: Sun, 22 Jan 2023 00:35:03 +0100
Subject: Make clippy happy

---
 macros/src/codegen/idle.rs | 2 +-
 macros/src/codegen/init.rs | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

(limited to 'macros/src/codegen/init.rs')

diff --git a/macros/src/codegen/idle.rs b/macros/src/codegen/idle.rs
index 55b7e623..77a7f9fe 100644
--- a/macros/src/codegen/idle.rs
+++ b/macros/src/codegen/idle.rs
@@ -59,7 +59,7 @@ pub fn codegen(
             analysis,
             extra,
         ));
-        let idle_doc = &format!(" User provided idle function");
+        let idle_doc = " User provided idle function".to_string();
 
         let attrs = &idle.attrs;
         let context = &idle.context;
diff --git a/macros/src/codegen/init.rs b/macros/src/codegen/init.rs
index e8a9c8b9..34f86f27 100644
--- a/macros/src/codegen/init.rs
+++ b/macros/src/codegen/init.rs
@@ -66,8 +66,8 @@ pub fn codegen(app: &App, analysis: &Analysis, extra: &Extra) -> CodegenResult {
         })
         .collect();
 
-    let shared_resources_doc = &format!(" RTIC shared resource struct");
-    let local_resources_doc = &format!(" RTIC local resource struct");
+    let shared_resources_doc = " RTIC shared resource struct".to_string();
+    let local_resources_doc = " RTIC local resource struct".to_string();
     root_init.push(quote! {
         #[doc = #shared_resources_doc]
         struct #shared {
@@ -81,7 +81,7 @@ pub fn codegen(app: &App, analysis: &Analysis, extra: &Extra) -> CodegenResult {
     });
 
     let user_init_return = quote! {#shared, #local, #name::Monotonics};
-    let user_init_doc = &format!(" User provided init function");
+    let user_init_doc = " User provided init function".to_string();
 
     let user_init = quote!(
         #(#attrs)*
-- 
cgit v1.2.3