fix guide build

guide/src/function/signature.md

@@ -97,10 +97,10 @@ num=-1
 > Note: for keywords like `struct`, to use it as a function argument, use "raw ident" syntax `r#struct` in both the signature and the function definition:
 >
 > ```rust
-> # !#[allow(unused_code)]
+> # #![allow(dead_code)]
 > # use pyo3::prelude::*;
 > #[pyfunction(signature = (r#struct = "foo"))]
-> fn method_with_keyword<'a>(&self, r#struct: &'a str) {
+> fn function_with_keyword(r#struct: &str) {
 > #     let _ = r#struct;
 >     /* ... */
 > }

pyo3-macros-backend/src/attributes.rs

@@ -43,7 +43,7 @@ pub struct KeywordAttribute<K, V> {
 }
 
 /// A helper type which parses the inner type via a literal string
-/// e.g. LitStrValue<Path> -> parses "some::path" in quotes.
+/// e.g. `LitStrValue<Path>` -> parses "some::path" in quotes.
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct LitStrValue<T>(pub T);
 

pyo3-macros-backend/src/utils.rs

@@ -44,7 +44,7 @@ pub fn is_python(ty: &syn::Type) -> bool {
     }
 }
 
-/// If `ty` is Option<T>, return `Some(T)`, else None.
+/// If `ty` is `Option<T>`, return `Some(T)`, else `None`.
 pub fn option_type_argument(ty: &syn::Type) -> Option<&syn::Type> {
     if let syn::Type::Path(syn::TypePath { path, .. }) = ty {
         let seg = path.segments.last().filter(|s| s.ident == "Option")?;

pyo3-macros/src/lib.rs

@@ -88,7 +88,7 @@ pub fn pyclass(attr: TokenStream, input: TokenStream) -> TokenStream {
 /// | [`#[classmethod]`][7]  | Defines the method as a classmethod, like Python's `@classmethod` decorator.|
 /// | [`#[classattr]`][9]  | Defines a class variable. |
 /// | [`#[args]`][10]  | Deprecated way to define a method's default arguments and allows the function to receive `*args` and `**kwargs`. Use `#[pyo3(signature = (...))]` instead. |
-/// | <nobr>[`#[pyo3(<option> = <value>)`][pyo3-method-options]<nobr> | Any of the `#[pyo3]` options supported on [`macro@pyfunction`]. |
+/// | <nobr>[`#[pyo3(<option> = <value>)`][pyo3-method-options]</nobr> | Any of the `#[pyo3]` options supported on [`macro@pyfunction`]. |
 ///
 /// For more on creating class methods,
 /// see the [class section of the guide][1].