Place aliases support behind an unstable feature flag

Cargo.toml

@@ -69,6 +69,7 @@ default = ["cli"]
 cli-common = ["dialoguer", "dirs", "gumdrop", "log"]
 cli = ["cli-common", "chrono", "console", "env_logger", "minreq"]
 mount = ["cli-common", "env_logger", "fuse_mt", "libc", "tar", "time", "zip"]
+unstable = []
 
 [[bin]]
 name = "rage-mount"

examples/generate-docs.rs

@@ -3,7 +3,7 @@ use std::fs::File;
 use std::io::prelude::*;
 
 fn rage_page() {
-    let page = Manual::new("rage")
+    let builder = Manual::new("rage")
         .about("A simple, secure, and modern encryption tool")
         .author(Author::new("Jack Grigg").email("thestr4d@gmail.com"))
         .flag(
@@ -48,11 +48,6 @@ fn rage_page() {
                 .long("--output")
                 .help("The file path to write output to (defaults to stdout)"),
         )
-        .option(
-            Opt::new("aliases")
-                .long("--aliases")
-                .help("The list of aliases to load (defaults to ~/.config/age/aliases.txt)"),
-        )
         .arg(Arg::new("[INPUT_FILE (defaults to stdin)]"))
         .example(Example::new().text("Encryption to a public key").command(
             "echo \"_o/\" | rage -o hello.age -r pubkey:98W5ph53zfPGOzEOH-fMojQ4jUY7VLEmtmozREqnw4I",
@@ -92,11 +87,6 @@ fn rage_page() {
                 )
                 .command("echo \"_o/\" | rage -r github:str4d | nc 192.0.2.0 1234"),
         )
-        .example(
-            Example::new()
-                .text("Encryption to an alias")
-                .command("tar cv ~/xxx | rage -r alias:str4d > xxx.tar.age"),
-        )
         .example(
             Example::new()
                 .text("Decryption with keys at ~/.config/age/keys.txt")
@@ -107,8 +97,20 @@ fn rage_page() {
             Example::new()
                 .text("Decryption with custom keys")
                 .command("rage -d -o hello -i keyA.txt -i keyB.txt hello.age"),
+        );
+    #[cfg(feature = "unstable")]
+    let builder = builder
+        .option(
+            Opt::new("aliases")
+                .long("--aliases")
+                .help("The list of aliases to load (defaults to ~/.config/age/aliases.txt)"),
         )
-        .render();
+        .example(
+            Example::new()
+                .text("Encryption to an alias")
+                .command("tar cv ~/xxx | rage -r alias:str4d > xxx.tar.age"),
+        );
+    let page = builder.render();
 
     let mut file =
         File::create("./target/rage.1").expect("Should be able to open file in target directory");

src/bin/rage/main.rs

@@ -174,6 +174,7 @@ struct AgeOptions {
     #[options(help = "output to OUTPUT (default stdout)")]
     output: Option<String>,
 
+    #[cfg(feature = "unstable")]
     #[options(help = "load the aliases list from ALIASES", no_short)]
     aliases: Option<String>,
 }
@@ -207,7 +208,13 @@ fn encrypt(opts: AgeOptions) {
             return;
         }
 
-        match read_recipients(opts.recipient, opts.aliases) {
+        #[cfg(feature = "unstable")]
+        let aliases = opts.aliases;
+
+        #[cfg(not(feature = "unstable"))]
+        let aliases = None;
+
+        match read_recipients(opts.recipient, aliases) {
             Ok(recipients) => age::Encryptor::Keys(recipients),
             Err(e) => {
                 error!("Error while reading recipients: {}", e);