uefi-macros: Update unsafe_protocol docstring

Author: nicholasbishop

uefi-macros/src/lib.rs

@@ -25,12 +25,14 @@ macro_rules! err {
 
 /// Attribute macro for marking structs as UEFI protocols.
 ///
-/// The macro takes one argument, either a GUID string or the path to a `Guid`
-/// constant.
+/// The macro can only be applied to a struct, and takes one argument, either a
+/// GUID string or the path to a `Guid` constant.
 ///
-/// The macro can only be applied to a struct. It implements the
-/// [`Protocol`] trait and the `unsafe` [`Identify`] trait for the
-/// struct.
+/// The macro implements the [`Protocol`] trait and the `unsafe` [`Identify`]
+/// trait for the struct. This allows a protocol to be opened with
+/// [`boot::open_protocol`] or [`boot::open_protocol_exclusive`]. Note that this
+/// trait does not automatically install a protocol. To install a protocol, call
+/// [`boot::install_protocol_interface`].
 ///
 /// # Safety
 ///
@@ -55,9 +57,12 @@ macro_rules! err {
 /// assert_eq!(ExampleProtocol2::GUID, PROTO_GUID);
 /// ```
 ///
-/// [`Identify`]: https://docs.rs/uefi/latest/uefi/trait.Identify.html
+/// [`Identify`]: https://docs.rs/uefi/latest/uefi/data_types/trait.Identify.html
 /// [`Protocol`]: https://docs.rs/uefi/latest/uefi/proto/trait.Protocol.html
 /// [send-and-sync]: https://doc.rust-lang.org/nomicon/send-and-sync.html
+/// [`boot::open_protocol`]: https://docs.rs/uefi/latest/uefi/boot/fn.open_protocol.html
+/// [`boot::open_protocol_exclusive`]: https://docs.rs/uefi/latest/uefi/boot/fn.open_protocol_exclusive.html
+/// [`boot::install_protocol_interface`]: https://docs.rs/uefi/latest/uefi/boot/fn.install_protocol_interface.html
 #[proc_macro_attribute]
 pub fn unsafe_protocol(args: TokenStream, input: TokenStream) -> TokenStream {
     let expr = parse_macro_input!(args as Expr);