X-Git-Url: http://www.git.stargrave.org/?a=blobdiff_plain;f=Documentation%2Fpublic-inbox-clone.pod;h=53acf35698fd78c97710d461614eed01e9495dcf;hb=6416cd67c9e52111d37d12452a3f8046fd5f8e1e;hp=9288b175a29abd1eea0e37957c75767d3b3ed85f;hpb=559c0b5f0180ccf5588cb3f021e3a302f7776d63;p=public-inbox.git diff --git a/Documentation/public-inbox-clone.pod b/Documentation/public-inbox-clone.pod index 9288b175..53acf356 100644 --- a/Documentation/public-inbox-clone.pod +++ b/Documentation/public-inbox-clone.pod @@ -89,9 +89,9 @@ for testing. Enables space savings when the remote C includes C entries as generated by grokmirror 2.x. -If C is not an absolute path, it is relative to the -C directory. If only C<--objstore=> is specified -where C is an empty string (C<"">), then C +If C does not start with C, C<./>, or C<../>, it is treated +as relative to the C directory. If only C<--objstore=> +is specified where C is an empty string (C<"">), then C (C<$DESTINATION/objstore>) is the implied value of C. =item --manifest=FILE @@ -99,11 +99,49 @@ 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. -If C is not an absolute path, it is relative to the -C directory. If only C<--manifest => is specified -where C is an empty string (C<"">), then C +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 + +Pass the C<--prune> and C<--prune-tags> flags to L +calls on incremental clones. + +=item -k + +=item --keep-going + +Continue as much as possible after an error. + =item -n =item --dry-run