feat(init): create install-man-pages subcommand

This is primarily intended for package managers to generate and install man-pages, but it could also be used by individuals who installed from source.

Author: arxanas

git-branchless-init/src/lib.rs

@@ -22,7 +22,7 @@ use lib::util::ExitCode;
 use path_slash::PathExt;
 use tracing::{instrument, warn};
 
-use git_branchless_opts::{write_man_pages, InitArgs};
+use git_branchless_opts::{write_man_pages, InitArgs, InstallManPagesArgs};
 use lib::core::config::{get_default_branch_name, get_default_hooks_dir, get_hooks_dir};
 use lib::core::dag::Dag;
 use lib::core::effects::Effects;
@@ -684,6 +684,17 @@ pub fn command_main(ctx: CommandContext, args: InitArgs) -> eyre::Result<ExitCod
     }
 }
 
+/// Install the man-pages for `git-branchless` to the provided path.
+#[instrument]
+pub fn command_install_man_pages(
+    ctx: CommandContext,
+    args: InstallManPagesArgs,
+) -> eyre::Result<ExitCode> {
+    let InstallManPagesArgs { path } = args;
+    write_man_pages(&path)?;
+    Ok(ExitCode(0))
+}
+
 #[cfg(test)]
 mod tests {
     use super::{update_between_lines, ALL_ALIASES, UPDATE_MARKER_END, UPDATE_MARKER_START};

git-branchless-opts/src/lib.rs

@@ -265,6 +265,14 @@ pub struct InitArgs {
     pub main_branch_name: Option<String>,
 }
 
+/// Install git-branchless's man-pages to the given path.
+#[derive(Debug, Parser)]
+pub struct InstallManPagesArgs {
+    /// The path to install to. An example path might be `/usr/share/man`. The
+    /// provded path will be appended with `man1`, etc., as appropriate.
+    pub path: PathBuf,
+}
+
 /// Query the commit graph using the "revset" language and print matching
 /// commits.
 ///
@@ -425,6 +433,9 @@ pub enum Command {
     /// Initialize the branchless workflow for this repository.
     Init(InitArgs),
 
+    /// Install git-branchless's man-pages to the given path.
+    InstallManPages(InstallManPagesArgs),
+
     /// Move a subtree of commits from one location to another.
     ///
     /// By default, `git move` tries to move the entire current stack if you

git-branchless/src/commands/mod.rs

@@ -70,6 +70,10 @@ fn command_main(ctx: CommandContext, opts: Opts) -> eyre::Result<ExitCode> {
 
         Command::Init(args) => git_branchless_init::command_main(ctx, args)?,
 
+        Command::InstallManPages(args) => {
+            git_branchless_init::command_install_man_pages(ctx, args)?
+        }
+
         Command::Move {
             source,
             dest,