Update man pages

completions/bash/brew

@@ -1507,6 +1507,7 @@ _brew_pr_upload() {
   case "$cur" in
     -*)
       __brewcomp "
+      --archive-item
       --bintray-org
       --debug
       --dry-run

completions/fish/brew.fish

@@ -1077,6 +1077,7 @@ __fish_brew_complete_arg 'pr-pull' -l workflows -d 'Retrieve artifacts from the
 
 
 __fish_brew_complete_cmd 'pr-upload' 'Apply the bottle commit and publish bottles to Bintray or GitHub Releases'
+__fish_brew_complete_arg 'pr-upload' -l archive-item -d 'Upload to the specified Archive item (default: `homebrew`)'
 __fish_brew_complete_arg 'pr-upload' -l bintray-org -d 'Upload to the specified Bintray organisation (default: `homebrew`)'
 __fish_brew_complete_arg 'pr-upload' -l debug -d 'Display any debugging information'
 __fish_brew_complete_arg 'pr-upload' -l dry-run -d 'Print what would be done rather than doing it'

completions/zsh/_brew

@@ -1255,6 +1255,7 @@ _brew_pr_pull() {
 # brew pr-upload
 _brew_pr_upload() {
   _arguments \
+    '--archive-item[Upload to the specified Archive item (default: `homebrew`)]' \
     '--bintray-org[Upload to the specified Bintray organisation (default: `homebrew`)]' \
     '--debug[Display any debugging information]' \
     '--dry-run[Print what would be done rather than doing it]' \

docs/Manpage.md

@@ -1208,6 +1208,8 @@ Apply the bottle commit and publish bottles to Bintray or GitHub Releases.
   Do not generate a new commit before uploading.
 * `--warn-on-upload-failure`:
   Warn instead of raising an error if the bottle upload fails. Useful for repairing bottle uploads that previously failed.
+* `--archive-item`:
+  Upload to the specified Archive item (default: `homebrew`).
 * `--bintray-org`:
   Upload to the specified Bintray organisation (default: `homebrew`).
 * `--root-url`:
@@ -1698,6 +1700,9 @@ example, run `export HOMEBREW_NO_INSECURE_REDIRECT=1` rather than just
 
   *Default:* `native`.
 
+- `HOMEBREW_ARCHIVE_KEY`
+  <br>Use this API key when accessing the Archive.org API (where bottles are stored). The format is access:secret. See https://archive.org/account/s3.php
+
 - `HOMEBREW_ARTIFACT_DOMAIN`
   <br>Prefix all download URLs, including those for bottles, with this value. For example, `HOMEBREW_ARTIFACT_DOMAIN=http://localhost:8080` will cause a formula with the URL `https://example.com/foo.tar.gz` to instead download from `http://localhost:8080/example.com/foo.tar.gz`.
 

manpages/brew.1

@@ -1692,6 +1692,10 @@ Do not generate a new commit before uploading\.
 Warn instead of raising an error if the bottle upload fails\. Useful for repairing bottle uploads that previously failed\.
 .
 .TP
+\fB\-\-archive\-item\fR
+Upload to the specified Archive item (default: \fBhomebrew\fR)\.
+.
+.TP
 \fB\-\-bintray\-org\fR
 Upload to the specified Bintray organisation (default: \fBhomebrew\fR)\.
 .
@@ -2353,6 +2357,12 @@ Linux only: Pass this value to a type name representing the compiler\'s \fB\-mar
 \fIDefault:\fR \fBnative\fR\.
 .
 .TP
+\fBHOMEBREW_ARCHIVE_KEY\fR
+.
+.br
+Use this API key when accessing the Archive\.org API (where bottles are stored)\. The format is access:secret\. See https://archive\.org/account/s3\.php
+.
+.TP
 \fBHOMEBREW_ARTIFACT_DOMAIN\fR
 .
 .br