summaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
authorAdam J. Stewart <ajstewart426@gmail.com>2019-11-17 15:30:08 -0700
committerTodd Gamblin <tgamblin@llnl.gov>2019-11-17 15:30:08 -0700
commiteb22abc5211a2600f62d72ca9fb6f013cec9a3f6 (patch)
treed221f445e18a44df0107cb08234d0c1318c10d1f /lib
parentaa83c483f7dde76e590f53b69992e1afa84476db (diff)
downloadspack-eb22abc5211a2600f62d72ca9fb6f013cec9a3f6.tar.gz
spack-eb22abc5211a2600f62d72ca9fb6f013cec9a3f6.tar.bz2
spack-eb22abc5211a2600f62d72ca9fb6f013cec9a3f6.tar.xz
spack-eb22abc5211a2600f62d72ca9fb6f013cec9a3f6.zip
Document use of the maintainers field (#13748)
Diffstat (limited to 'lib')
-rw-r--r--lib/spack/docs/packaging_guide.rst15
-rw-r--r--lib/spack/spack/cmd/create.py4
2 files changed, 19 insertions, 0 deletions
diff --git a/lib/spack/docs/packaging_guide.rst b/lib/spack/docs/packaging_guide.rst
index 767a744baa..7fc9d09e2d 100644
--- a/lib/spack/docs/packaging_guide.rst
+++ b/lib/spack/docs/packaging_guide.rst
@@ -136,6 +136,10 @@ generates a boilerplate template for your package, and opens up the new
homepage = "http://www.example.com"
url = "https://gmplib.org/download/gmp/gmp-6.1.2.tar.bz2"
+ # FIXME: Add a list of GitHub accounts to
+ # notify when the package is updated.
+ # maintainers = ['github_user1', 'github_user2']
+
version('6.1.2', '8ddbb26dc3bd4e2302984debba1406a5')
version('6.1.1', '4c175f86e11eb32d8bf9872ca3a8e11d')
version('6.1.0', '86ee6e54ebfc4a90b643a65e402c4048')
@@ -184,6 +188,17 @@ The rest of the tasks you need to do are as follows:
The ``homepage`` is displayed when users run ``spack info`` so
that they can learn more about your package.
+#. Add a comma-separated list of maintainers.
+
+ The ``maintainers`` field is a list of GitHub accounts of people
+ who want to be notified any time the package is modified. When a
+ pull request is submitted that updates the package, these people
+ will be requested to review the PR. This is useful for developers
+ who maintain a Spack package for their own software, as well as
+ users who rely on a piece of software and want to ensure that the
+ package doesn't break. It also gives users a list of people to
+ contact for help when someone reports a build error with the package.
+
#. Add ``depends_on()`` calls for the package's dependencies.
``depends_on`` tells Spack that other packages need to be built
diff --git a/lib/spack/spack/cmd/create.py b/lib/spack/spack/cmd/create.py
index 6c68617acd..ee0fb3a347 100644
--- a/lib/spack/spack/cmd/create.py
+++ b/lib/spack/spack/cmd/create.py
@@ -60,6 +60,10 @@ class {class_name}({base_class_name}):
homepage = "https://www.example.com"
{url_def}
+ # FIXME: Add a list of GitHub accounts to
+ # notify when the package is updated.
+ # maintainers = ['github_user1', 'github_user2']
+
{versions}
{dependencies}