From ad257079568746d71d913c6fca96852da6fe3bd6 Mon Sep 17 00:00:00 2001
From: Boris Kolpackov <boris@codesynthesis.com>
Date: Mon, 11 Jan 2016 10:04:02 +0200
Subject: Reorganize .cli files, add man/xhtml page generation (via script for
 now)

---
 bpkg/pkg-fetch.cli | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 bpkg/pkg-fetch.cli

(limited to 'bpkg/pkg-fetch.cli')

diff --git a/bpkg/pkg-fetch.cli b/bpkg/pkg-fetch.cli
new file mode 100644
index 0000000..ba1d5d9
--- /dev/null
+++ b/bpkg/pkg-fetch.cli
@@ -0,0 +1,54 @@
+// file      : bpkg/pkg-fetch.cli
+// copyright : Copyright (c) 2014-2016 Code Synthesis Ltd
+// license   : MIT; see accompanying LICENSE file
+
+include <bpkg/configuration.cli>;
+
+"\section=1"
+"\name=bpkg-pkg-fetch"
+"\summary=fetch package archive"
+
+/*
+"\h{SYNOPSIS}
+
+bpkg pkg-fetch [<options>] (<pkg>/<ver>)|(-e <file>)"
+
+"\h{DESCRIPTION}
+
+The \cb{pkg-fetch} command fetches the archive for the specified package
+name and version from one of the configuration's repositories. If the
+\cb{-r|--replace} option is specified, then \cb{pkg-fetch} will replace the
+archive of a package that is already in the \cb{fetched} or \cb{unpacked}
+state. Otherwise, \cb{pkg-fetch} expects the package to not exist in the
+configuration's database.
+
+If the \cb{-e|--existing} option is used, then instead of the name and
+version argument, \cb{pkg-fetch} expects a local path to the existing
+package archive. In this case, \cb{bpkg} will use the archive in place,
+without copying it to the configuration or package cache directories.
+Also, unless the \cb{-p|--purge} option is specified, \cb{bpkg} will
+not attempt to remove the archive when the package is purged with the
+\cb{pkg-purge} command."
+*/
+
+namespace bpkg
+{
+  class pkg_fetch_options: configuration_options
+  {
+    bool --replace|-r
+    {
+      "Replace the archive if the package is already fetched or unpacked."
+    }
+
+    bool --existing|-e
+    {
+      "Treat the argument as an existing package archive path rather than
+       package name/version to fetch."
+    }
+
+    bool --purge|-p
+    {
+      "Remove the existing package archive when the package is purged."
+    }
+  };
+}
-- 
cgit v1.1