feat: add man page support to pixi global

src/cli/global/install.rs

@@ -248,6 +248,12 @@ async fn setup_environment(
     // Sync completions
     state_changes |= project.sync_completions(env_name).await?;
 
+    // Sync man pages
+    #[cfg(unix)]
+    {
+        state_changes |= project.sync_man_pages(env_name).await?;
+    }
+
     project.manifest.save().await?;
     Ok(state_changes)
 }

src/cli/global/sync.rs

@@ -27,6 +27,10 @@ pub async fn execute(args: Args) -> miette::Result<()> {
         // Prune broken completions
         let completions_dir = crate::global::completions::CompletionsDir::from_env().await?;
         completions_dir.prune_old_completions()?;
+
+        // Prune broken man pages
+        let man_dir = crate::global::man_pages::ManDir::from_env().await?;
+        man_dir.prune_old_man_pages()?;
     }
 
     if state_change.has_changed() {

src/cli/global/update.rs

@@ -76,6 +76,12 @@ pub async fn execute(args: Args) -> miette::Result<()> {
         // Sync completions
         state_changes |= project.sync_completions(env_name).await?;
 
+        // Sync man pages
+        #[cfg(unix)]
+        {
+            state_changes |= project.sync_man_pages(env_name).await?;
+        }
+
         Ok(state_changes)
     }
 
@@ -90,6 +96,9 @@ pub async fn execute(args: Args) -> miette::Result<()> {
             {
                 let completions_dir = global::completions::CompletionsDir::from_env().await?;
                 completions_dir.prune_old_completions()?;
+
+                let man_dir = global::man_pages::ManDir::from_env().await?;
+                man_dir.prune_old_man_pages()?;
             }
             project_original.environments().keys().cloned().collect()
         }

src/global/common.rs

@@ -358,6 +358,8 @@ pub(crate) enum StateChange {
     AddedCompletion(String),
     #[allow(dead_code)] // This variant is not used on Windows
     RemovedCompletion(String),
+    AddedManPage(String),
+    RemovedManPage(String),
 }
 
 #[must_use]
@@ -713,6 +715,66 @@ impl StateChanges {
                             }
                         }
                     }
+                    StateChange::AddedManPage(name) => {
+                        let mut installed_items = StateChanges::accumulate_changes(
+                            &mut iter,
+                            |next| match next {
+                                Some(StateChange::AddedManPage(name)) => Some(name.clone()),
+                                _ => None,
+                            },
+                            Some(name.clone()),
+                        );
+
+                        installed_items.sort();
+
+                        if installed_items.len() == 1 {
+                            eprintln!(
+                                "{}Exposed man page {} of environment {}.",
+                                console::style(console::Emoji("✔ ", "")).green(),
+                                installed_items[0],
+                                env_name.fancy_display()
+                            );
+                        } else {
+                            eprintln!(
+                                "{}Exposed man pages of environment {}:",
+                                console::style(console::Emoji("✔ ", "")).green(),
+                                env_name.fancy_display()
+                            );
+                            for installed_item in installed_items {
+                                eprintln!("   - {}", installed_item);
+                            }
+                        }
+                    }
+                    StateChange::RemovedManPage(name) => {
+                        let mut uninstalled_items = StateChanges::accumulate_changes(
+                            &mut iter,
+                            |next| match next {
+                                Some(StateChange::RemovedManPage(name)) => Some(name.clone()),
+                                _ => None,
+                            },
+                            Some(name.clone()),
+                        );
+
+                        uninstalled_items.sort();
+
+                        if uninstalled_items.len() == 1 {
+                            eprintln!(
+                                "{}Removed man page {} of environment {}.",
+                                console::style(console::Emoji("✔ ", "")).green(),
+                                uninstalled_items[0],
+                                env_name.fancy_display()
+                            );
+                        } else {
+                            eprintln!(
+                                "{}Removed man pages of environment {}:",
+                                console::style(console::Emoji("✔ ", "")).green(),
+                                env_name.fancy_display()
+                            );
+                            for uninstalled_item in uninstalled_items {
+                                eprintln!("   - {}", uninstalled_item);
+                            }
+                        }
+                    }
                 }
             }
         }