diff --git a/proxmox-access-control/src/acl.rs b/proxmox-access-control/src/acl.rs index 5a676d3d..b8041688 100644 --- a/proxmox-access-control/src/acl.rs +++ b/proxmox-access-control/src/acl.rs @@ -39,8 +39,7 @@ pub struct AclTree { /// Node representing ACLs for a certain ACL path. #[derive(Default)] pub struct AclTreeNode { - /// [User](pbs_api_types::User) or - /// [Token](pbs_api_types::ApiToken) ACLs for this node. + /// `User` or `Token` ACLs for this node. pub users: HashMap>, /// `Group` ACLs for this node (not yet implemented) pub groups: HashMap>, @@ -60,8 +59,8 @@ impl AclTreeNode { /// Returns applicable role and their propagation status for a given [Authid]. /// - /// If the `Authid` is a [User](pbs_api_types::User) that has no specific `Roles` configured on - /// this node, applicable `Group` roles will be returned instead. + /// If the `Authid` is a `User` that has no specific `Roles` configured on this node, + /// applicable `Group` roles will be returned instead. /// /// If `leaf` is `false`, only those roles where the propagate flag in the ACL is set to `true` /// are returned. Otherwise, all roles will be returned. @@ -558,14 +557,14 @@ pub fn lock_config() -> Result { open_api_lockfile(acl_config_lock(), None, true) } -/// Reads the [`AclTree`] from the [default path](ACL_CFG_FILENAME). +/// Reads the [`AclTree`] from `acl.cfg` in the configuration directory. pub fn config() -> Result<(AclTree, ConfigDigest), Error> { let path = acl_config(); AclTree::load(&path) } -/// Returns a cached [`AclTree`] or fresh copy read directly from the [default -/// path](ACL_CFG_FILENAME) +/// Returns a cached [`AclTree`] or a fresh copy read directly from `acl.cfg` in the configuration +/// directory. /// /// Since the AclTree is used for every API request's permission check, this caching mechanism /// allows to skip reading and parsing the file again if it is unchanged. @@ -620,7 +619,7 @@ pub fn cached_config() -> Result, Error> { Ok(config) } -/// Saves an [`AclTree`] to the [default path](ACL_CFG_FILENAME), ensuring proper ownership and +/// Saves an [`AclTree`] to `acl.cfg` in the configuration directory, ensuring proper ownership and /// file permissions. pub fn save_config(acl: &AclTree) -> Result<(), Error> { let mut raw: Vec = Vec::new(); diff --git a/proxmox-acme/src/async_client.rs b/proxmox-acme/src/async_client.rs index ce5a6c79..6e38570f 100644 --- a/proxmox-acme/src/async_client.rs +++ b/proxmox-acme/src/async_client.rs @@ -342,7 +342,7 @@ impl AcmeClient { /// Get the directory URL without querying the `Directory` structure. /// - /// The difference to [`directory`](Client::directory()) is that this does not + /// The difference to [`directory`](AcmeClient::directory()) is that this does not /// attempt to fetch the directory data from the ACME server. pub fn directory_url(&self) -> &str { &self.directory_url diff --git a/proxmox-client/src/client.rs b/proxmox-client/src/client.rs index a1b4eee2..6f1c9ef1 100644 --- a/proxmox-client/src/client.rs +++ b/proxmox-client/src/client.rs @@ -62,7 +62,7 @@ impl TlsOptions { } } -/// A Proxmox API client base backed by a [`proxmox_http::Client`]. +/// A Proxmox API client base backed by a [`proxmox_http::client::Client`]. pub struct Client { api_url: Uri, auth: Mutex>>, diff --git a/proxmox-rest-server/src/api_config.rs b/proxmox-rest-server/src/api_config.rs index 7dbcad52..b20b2da0 100644 --- a/proxmox-rest-server/src/api_config.rs +++ b/proxmox-rest-server/src/api_config.rs @@ -47,7 +47,7 @@ impl ApiConfig { /// /// `get_index_fn` - callback to generate the root page /// (index). Please note that this functions gets a reference to - /// the [ApiConfig], so it can use [Handlebars] templates + /// the [ApiConfig], so it can use [handlebars::Handlebars] templates /// ([render_template](Self::render_template) to generate pages. pub fn new>(basedir: B, env_type: RpcEnvironmentType) -> Self { Self { @@ -175,7 +175,7 @@ impl ApiConfig { self.env_type } - /// Register a [Handlebars] template file + /// Register a [handlebars::Handlebars] template file /// /// Those templates cane be use with [render_template](Self::render_template) to generate pages. #[cfg(feature = "templates")] diff --git a/proxmox-rest-server/src/worker_task.rs b/proxmox-rest-server/src/worker_task.rs index 9351bbee..6368206c 100644 --- a/proxmox-rest-server/src/worker_task.rs +++ b/proxmox-rest-server/src/worker_task.rs @@ -38,9 +38,8 @@ pub async fn last_worker_future() { let _ = last_worker_listeners().subscribe().wait_for(|&v| v).await; } -/// This drives the [`last_worker_listener()`] futures: if a shutdown is requested and no workers -/// and no internal tasks are running, the [`last_worker_listener()`] futures are triggered to -/// finish. +/// This drives the worker listener futures: if a shutdown is requested and no workers and no +/// internal tasks are running, the last worker listener futures are triggered to finish. pub fn check_last_worker() { if proxmox_daemon::is_shutdown_requested() && WORKER_COUNT.load(Ordering::Acquire) == 0