home-manager: pass --refresh to nix (#3624)

This flag is useful to force Nix to re-fetch cached flakes. Without it,
you cannot deploy from a non-local flake in quick succession, since the
caching causes the flake to not be re-fetched.

docs/man-home-manager.xml

@@ -179,6 +179,10 @@
     --no-out-link
    </arg>
 
+   <arg>
+    --refresh
+   </arg>
+
    <arg>
     <group choice="req">
     <arg choice="plain">
@@ -611,6 +615,18 @@
      </para>
     </listitem>
    </varlistentry>
+   <varlistentry>
+    <term>
+     <option>--refresh</option>
+    </term>
+    <listitem>
+     <para>
+      Passed on to <citerefentry>
+      <refentrytitle>nix-build</refentrytitle>
+      <manvolnum>1</manvolnum> </citerefentry>
+     </para>
+    </listitem>
+   </varlistentry>
    <varlistentry>
     <term>
      <option>-v</option>

home-manager/completion.bash

@@ -296,7 +296,7 @@ _home-manager_completions ()
               "-L" "--print-build-logs" \
               "--show-trace" "--substitute" "--builders" "--version" \
               "--update-input" "--override-input" "--experimental-features" \
-              "--extra-experimental-features" )
+              "--extra-experimental-features" "--refresh")
 
     # ^ « home-manager »'s options.
 

home-manager/completion.fish

@@ -69,3 +69,4 @@ complete -c home-manager -f -l "update-input"
 complete -c home-manager -f -l "override-input"
 complete -c home-manager -f -l "experimental-features"
 complete -c home-manager -f -l "extra-experimental-features"
+complete -c home-manager -f -l "refresh" -d "Consider all previously downloaded files out-of-date"

home-manager/completion.zsh

@@ -63,6 +63,7 @@ case "$state" in
           '--show-trace[show trace]' \
           '--substitute[substitute]' \
           '--builders[builders]:SPEC:()' \
+          '--refresh[refresh]' \
           '--override-input[override flake input]:NAME VALUE:()' \
           '--update-input[update flake input]:NAME:()' \
           '--experimental-features[set experimental Nix features]:VALUE:()' \

home-manager/home-manager

@@ -556,6 +556,7 @@ function doHelp() {
     echo "  --no-out-link            Do not create a symlink to the output path"
     echo "  --no-write-lock-file"
     echo "  --builders VALUE"
+    echo "  --refresh                Consider all previously downloaded files out-of-date"
     echo
     echo "Commands"
     echo
@@ -628,7 +629,7 @@ while [[ $# -gt 0 ]]; do
             FLAKE_ARG="$1"
             shift
             ;;
-        --recreate-lock-file|--no-update-lock-file|--no-write-lock-file|--no-registries|--commit-lock-file)
+        --recreate-lock-file|--no-update-lock-file|--no-write-lock-file|--no-registries|--commit-lock-file|--refresh)
             PASSTHROUGH_OPTS+=("$opt")
             ;;
         --update-input)