Remove @brief annotations from Rust API docs (backport #20769) (#20807)

* Remove @brief annotations from Rust API docs (#20769)

(cherry picked from commit d9b0fc0e3e)

# Conflicts:
#	programs/bpf/rust/invoke/src/instructions.rs
#	programs/bpf/rust/invoke/src/processor.rs
#	programs/bpf/rust/realloc/src/instructions.rs
#	programs/bpf/rust/realloc/src/lib.rs
#	programs/bpf/rust/realloc/src/processor.rs
#	programs/bpf/rust/realloc_invoke/src/instructions.rs
#	programs/bpf/rust/realloc_invoke/src/lib.rs
#	programs/bpf/rust/realloc_invoke/src/processor.rs
#	sdk/cargo-build-bpf/tests/crates/fail/src/lib.rs
#	sdk/src/precompiles.rs

* Fix conflicts

Co-authored-by: Brian Anderson <andersrb@gmail.com>
Co-authored-by: Tyera Eulberg <tyera@solana.com>

programs/bpf/rust/128bit/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program tests loop iteration
+//! Example Rust-based BPF program tests loop iteration
 
 extern crate solana_program;
 use solana_program::{custom_panic_default, entrypoint::SUCCESS};

programs/bpf/rust/128bit_dep/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Solana Rust-based BPF program utility functions and types
+//! Solana Rust-based BPF program utility functions and types
 
 extern crate solana_program;
 

programs/bpf/rust/alloc/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program that test dynamic memory allocation
+//! Example Rust-based BPF program that test dynamic memory allocation
 
 #[macro_use]
 extern crate alloc;

programs/bpf/rust/call_depth/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program that tests call depth and stack usage
+//! Example Rust-based BPF program that tests call depth and stack usage
 
 use solana_program::{custom_panic_default, entrypoint::SUCCESS, msg};
 

programs/bpf/rust/custom_heap/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF that tests out using a custom heap
+//! Example Rust-based BPF that tests out using a custom heap
 
 use solana_program::{
     account_info::AccountInfo,

programs/bpf/rust/dep_crate/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program tests dependent crates
+//! Example Rust-based BPF program tests dependent crates
 
 extern crate solana_program;
 use byteorder::{ByteOrder, LittleEndian};

programs/bpf/rust/deprecated_loader/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program that supports the deprecated loader
+//! Example Rust-based BPF program that supports the deprecated loader
 
 #![allow(unreachable_code)]
 

programs/bpf/rust/dup_accounts/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program that tests duplicate accounts passed via accounts
+//! Example Rust-based BPF program that tests duplicate accounts passed via accounts
 
 extern crate solana_program;
 use solana_program::{

programs/bpf/rust/error_handling/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program that exercises error handling
+//! Example Rust-based BPF program that exercises error handling
 
 extern crate solana_program;
 use num_derive::FromPrimitive;

programs/bpf/rust/external_spend/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program that moves a lamport from one account to another
+//! Example Rust-based BPF program that moves a lamport from one account to another
 
 extern crate solana_program;
 use solana_program::{

programs/bpf/rust/finalize/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF sanity program that finalizes a BPF program
+//! Example Rust-based BPF sanity program that finalizes a BPF program
 
 #![allow(unreachable_code)]
 

programs/bpf/rust/instruction_introspection/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program that exercises instruction introspection
+//! Example Rust-based BPF program that exercises instruction introspection
 
 extern crate solana_program;
 use solana_program::{

programs/bpf/rust/invoke/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program that issues a cross-program-invocation
+//! Example Rust-based BPF program that issues a cross-program-invocation
 
 #![allow(unreachable_code)]
 

programs/bpf/rust/invoke_and_error/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Invokes an instruction and returns an error, the instruction invoked
+//! Invokes an instruction and returns an error, the instruction invoked
 //! uses the instruction data provided and all the accounts
 
 use solana_program::{

programs/bpf/rust/invoke_and_ok/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Invokes an instruction and returns an error, the instruction invoked
+//! Invokes an instruction and returns an error, the instruction invoked
 //! uses the instruction data provided and all the accounts
 
 use solana_program::{

programs/bpf/rust/invoke_and_return/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Invokes an instruction and returns an error, the instruction invoked
+//! Invokes an instruction and returns an error, the instruction invoked
 //! uses the instruction data provided and all the accounts
 
 use solana_program::{

programs/bpf/rust/invoked/src/instruction.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program that issues a cross-program-invocation
+//! Example Rust-based BPF program that issues a cross-program-invocation
 
 use solana_program::{
     instruction::{AccountMeta, Instruction},

programs/bpf/rust/invoked/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program that issues a cross-program-invocation
+//! Example Rust-based BPF program that issues a cross-program-invocation
 
 pub mod instruction;
 pub mod processor;

programs/bpf/rust/invoked/src/processor.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program that issues a cross-program-invocation
+//! Example Rust-based BPF program that issues a cross-program-invocation
 
 #![cfg(feature = "program")]
 

programs/bpf/rust/iter/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program tests loop iteration
+//! Example Rust-based BPF program tests loop iteration
 
 extern crate solana_program;
 use solana_program::{custom_panic_default, entrypoint::SUCCESS, msg};

programs/bpf/rust/log_data/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program that uses sol_log_data syscall
+//! Example Rust-based BPF program that uses sol_log_data syscall
 
 #![cfg(feature = "program")]
 

programs/bpf/rust/many_args/src/helper.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program tests loop iteration
+//! Example Rust-based BPF program tests loop iteration
 
 extern crate solana_program;
 use solana_program::log::*;

programs/bpf/rust/many_args/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program tests loop iteration
+//! Example Rust-based BPF program tests loop iteration
 
 mod helper;
 extern crate solana_program;

programs/bpf/rust/many_args_dep/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Solana Rust-based BPF program utility functions and types
+//! Solana Rust-based BPF program utility functions and types
 
 extern crate solana_program;
 use solana_program::msg;

programs/bpf/rust/mem/src/entrypoint.rs

@@ -1,4 +1,4 @@
-//! @brief Test mem functions
+//! Test mem functions
 
 use crate::{run_mem_tests, MemOps};
 use solana_program::{

programs/bpf/rust/mem/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Test mem functions
+//! Test mem functions
 
 #[cfg(not(feature = "no-entrypoint"))]
 pub mod entrypoint;

programs/bpf/rust/membuiltins/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Test builtin mem functions
+//! Test builtin mem functions
 
 #![cfg(target_arch = "bpf")]
 #![feature(rustc_private)]

programs/bpf/rust/noop/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF noop program
+//! Example Rust-based BPF noop program
 
 extern crate solana_program;
 use solana_program::{

programs/bpf/rust/panic/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program that panics
+//! Example Rust-based BPF program that panics
 
 #[cfg(all(feature = "custom-panic", target_arch = "bpf"))]
 #[no_mangle]

programs/bpf/rust/param_passing/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program tests loop iteration
+//! Example Rust-based BPF program tests loop iteration
 
 extern crate solana_program;
 use solana_bpf_rust_param_passing_dep::{Data, TestDep};

programs/bpf/rust/param_passing_dep/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program tests loop iteration
+//! Example Rust-based BPF program tests loop iteration
 
 extern crate solana_program;
 

programs/bpf/rust/rand/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program that tests rand behavior
+//! Example Rust-based BPF program that tests rand behavior
 
 #![allow(unreachable_code)]
 

programs/bpf/rust/sanity/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF sanity program that prints out the parameters passed to it
+//! Example Rust-based BPF sanity program that prints out the parameters passed to it
 
 #![allow(unreachable_code)]
 

programs/bpf/rust/secp256k1_recover/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Secp256k1Recover Syscall test
+//! Secp256k1Recover Syscall test
 
 extern crate solana_program;
 use solana_program::{custom_panic_default, msg};

programs/bpf/rust/sha/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief SHA Syscall test
+//! SHA Syscall test
 
 extern crate solana_program;
 use solana_program::{custom_panic_default, msg};

programs/bpf/rust/sysvar/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program that tests sysvar use
+//! Example Rust-based BPF program that tests sysvar use
 
 extern crate solana_program;
 use solana_program::{

programs/bpf/rust/upgradeable/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF upgradeable program
+//! Example Rust-based BPF upgradeable program
 
 extern crate solana_program;
 use solana_program::{

programs/bpf/rust/upgraded/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF upgraded program
+//! Example Rust-based BPF upgraded program
 
 extern crate solana_program;
 use solana_program::{

sdk/cargo-build-bpf/tests/crates/noop/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF noop program
+//! Example Rust-based BPF noop program
 
 extern crate solana_program;
 use solana_program::{

sdk/program/src/bpf_loader.rs

@@ -1,4 +1,4 @@
-//! @brief The latest Solana BPF loader.
+//! The latest Solana BPF loader.
 //!
 //! The BPF loader is responsible for loading, finalizing, and executing BPF
 //! programs.  Not all networks may support the latest loader.  You can use the

sdk/program/src/bpf_loader_deprecated.rs

@@ -1,4 +1,4 @@
-//! @brief The original and now deprecated Solana BPF loader.
+//! The original and now deprecated Solana BPF loader.
 //!
 //! The BPF loader is responsible for loading, finalizing, and executing BPF
 //! programs.

sdk/program/src/bpf_loader_upgradeable.rs

@@ -1,4 +1,4 @@
-//! @brief An Upgradeable Solana BPF loader.
+//! An Upgradeable Solana BPF loader.
 //!
 //! The upgradeable BPF loader is responsible for deploying, upgrading, and
 //! executing BPF programs.  The upgradeable loader allows a program's authority

sdk/program/src/entrypoint.rs

@@ -1,4 +1,4 @@
-//! @brief Solana Rust-based BPF program entry point supported by the latest
+//! Solana Rust-based BPF program entry point supported by the latest
 //! BPFLoader.  For more information see './bpf_loader.rs'
 
 extern crate alloc;

sdk/program/src/entrypoint_deprecated.rs

@@ -1,5 +1,5 @@
 #![allow(clippy::integer_arithmetic)]
-//! @brief Solana Rust-based BPF program entry point supported by the original
+//! Solana Rust-based BPF program entry point supported by the original
 //!  and now deprecated BPFLoader.  For more information see
 //!  './bpf_loader_deprecated.rs'
 

sdk/program/src/log.rs

@@ -1,4 +1,4 @@
-//! @brief Solana Rust-based BPF program logging
+//! Solana Rust-based BPF program logging
 
 use crate::account_info::AccountInfo;
 

sdk/program/src/program_memory.rs

@@ -1,4 +1,4 @@
-//! @brief Solana Rust-based BPF memory operations
+//! Solana Rust-based BPF memory operations
 
 /// Memcpy
 ///

sdk/program/src/program_stubs.rs

@@ -1,4 +1,4 @@
-//! @brief Syscall stubs when building for programs for non-BPF targets
+//! Syscall stubs when building for programs for non-BPF targets
 
 #![cfg(not(target_arch = "bpf"))]
 

sdk/src/builtins.rs

@@ -1,4 +1,4 @@
-//! @brief Solana builtin helper macros
+//! Solana builtin helper macros
 
 #[rustversion::since(1.46.0)]
 #[macro_export]

sdk/src/entrypoint_native.rs

@@ -1,4 +1,4 @@
-//! @brief Solana Native program entry point
+//! Solana Native program entry point
 
 use crate::{instruction::InstructionError, keyed_account::KeyedAccount, pubkey::Pubkey};
 

web3.js/test/fixtures/noop-program/src/lib.rs

@@ -1,4 +1,4 @@
-//! @brief Example Rust-based BPF program that prints out the parameters passed to it
+//! Example Rust-based BPF program that prints out the parameters passed to it
 
 
 use solana_program::{