X-Git-Url: http://www.git.stargrave.org/?a=blobdiff_plain;f=Documentation%2Fpublic-inbox-clone.pod;h=7498aed9f46ad93c48279e45c8d4626300579794;hb=143d2aecda3649bca538b77dca63972e7a28949e;hp=9bcb9967a38e9079295f739bdf227223d64605ec;hpb=464c28e42bbbe54fc1d13629258eff31ecfc1689;p=public-inbox.git diff --git a/Documentation/public-inbox-clone.pod b/Documentation/public-inbox-clone.pod index 9bcb9967..7498aed9 100644 --- a/Documentation/public-inbox-clone.pod +++ b/Documentation/public-inbox-clone.pod @@ -99,11 +99,36 @@ is specified where C is an empty string (C<"">), then C When incrementally updating an existing mirror, load the given manifest (typically C) to speed up updates. +By default, public-inbox writes the retrieved manifest to +C<$DESTINATION/manifest.js.gz>, this directive also +changes the destination to the specified C + If C does not start with C, C<./>, or C<../>, it is treated as relative to the C directory. If only C<--manifest=> is specified where C is an empty string (C<"">), then C (C<$DESTINATION/manifest.js.gz>) is the implied value of C. +=item --project-list=FILE + +When cloning code repos from a manifest, generate a cgit-compatible +project list. + +If C does not start with C, C<./>, or C<../>, it is treated +as relative to the C directory. If only C<--project-list=> +is specified where C is an empty string (C<"">), then C +(C<$DESTINATION/projects.list>) is the implied value of C. + +=item --post-update-hook=COMMAND + +Hooks to run after a repository is cloned or updated, C will +have the bare git repository destination given as its first and only +argument. + +For v2 inboxes, this operates on a per-epoch basis. + +May be specified multiple times to run multiple commands in the +order specified on the command-line. + =item -p =item --prune @@ -111,6 +136,12 @@ is specified where C is an empty string (C<"">), then C Pass the C<--prune> and C<--prune-tags> flags to L calls on incremental clones. +=item --exit-code + +Exit with C<127> if no updates are done when relying on a manifest. +Updates include fingerprint mismatches in the manifest, new symlinks, +new repositories, and removed repositories from the L<--project-list> + =item -k =item --keep-going