From b0f59484d33b260eb5bb23304ded069884c1886b Mon Sep 17 00:00:00 2001 From: Tamara Dahlgren <35777542+tldahlgren@users.noreply.github.com> Date: Fri, 6 Dec 2019 07:26:59 -0800 Subject: docs: Minimal BundlePackage build system doc (#13992) * Minimal BundlePackage build system doc * Add link to new bundlepackage file * Fixed link bug and added create command example --- lib/spack/docs/build_systems.rst | 1 + lib/spack/docs/build_systems/bundlepackage.rst | 52 ++++++++++++++++++++++++++ 2 files changed, 53 insertions(+) create mode 100644 lib/spack/docs/build_systems/bundlepackage.rst diff --git a/lib/spack/docs/build_systems.rst b/lib/spack/docs/build_systems.rst index 93b8e5c7a8..cdb12a8d91 100644 --- a/lib/spack/docs/build_systems.rst +++ b/lib/spack/docs/build_systems.rst @@ -56,6 +56,7 @@ on these ideas for each distinct build system that Spack supports: :maxdepth: 1 :caption: Other + build_systems/bundlepackage build_systems/cudapackage build_systems/intelpackage build_systems/custompackage diff --git a/lib/spack/docs/build_systems/bundlepackage.rst b/lib/spack/docs/build_systems/bundlepackage.rst new file mode 100644 index 0000000000..5f61b71351 --- /dev/null +++ b/lib/spack/docs/build_systems/bundlepackage.rst @@ -0,0 +1,52 @@ +.. Copyright 2013-2019 Lawrence Livermore National Security, LLC and other + Spack Project Developers. See the top-level COPYRIGHT file for details. + + SPDX-License-Identifier: (Apache-2.0 OR MIT) + +.. _bundlepackage: + +------------- +BundlePackage +------------- + +``BundlePackage`` represents a set of packages that are expected to work well +together, such as a collection of commonly used software libraries. The +associated software is specified as bundle dependencies. + + +^^^^^^^^ +Creation +^^^^^^^^ + +Be sure to specify the ``bundle`` template if you are using ``spack create`` +to generate a package from the template. For example, use the following +command to create a bundle package whose class name will be ``Mybundle``: + +.. code-block:: console + + $ spack create --template bundle --name mybundle + + + +^^^^^^ +Phases +^^^^^^ + +The ``BundlePackage`` base class does not provide any phases by default +since the bundle does not represent a build system. + + +^^^ +URL +^^^ + +The ``url`` property does not have meaning since there is no package-specific +code to fetch. + + +^^^^^^^ +Version +^^^^^^^ + +At least one ``version`` must be specified in order for the package to +build. -- cgit v1.2.3-70-g09d2