Undo changes to trailing triple quotes in docstring

lib/spack/spack/build_environment.py

@@ -494,7 +494,8 @@ def child_fun():
     If something goes wrong, the child process is expected to print
     the error and the parent process will exit with error as
     well. If things go well, the child exits and the parent
-    carries on."""
+    carries on.
+    """
 
     try:
         pid = os.fork()

lib/spack/spack/config.py

@@ -117,7 +117,8 @@
             ...
 
 Will make Spack take compilers *only* from the user configuration, and
-the site configuration will be ignored."""
+the site configuration will be ignored.
+"""
 
 import copy
 import os

lib/spack/spack/environment.py

@@ -266,7 +266,8 @@ def from_sourcing_files(*args, **kwargs):
         parameters
 
         :param \*args: list of files to be sourced
-        :rtype: instance of EnvironmentModifications"""
+        :rtype: instance of EnvironmentModifications
+        """
 
         env = EnvironmentModifications()
         # Check if the files are actually there

lib/spack/spack/mirror.py

@@ -141,8 +141,8 @@ def create(path, specs, **kwargs):
 
     This routine iterates through all known package versions, and
     it creates specs for those versions.  If the version satisfies any spec
-    in the specs list, it is downloaded and added to the mirror."""
-
+    in the specs list, it is downloaded and added to the mirror.
+    """
     # Make sure nothing is in the way.
     if os.path.isfile(path):
         raise MirrorError("%s already exists and is a file." % path)

lib/spack/spack/spec.py

@@ -2110,8 +2110,8 @@ def format(self, format_string='$_$@$%@+$+$=', **kwargs):
         *Example:*  ``$_$@$+`` translates to the name, version, and options
         of the package, but no dependencies, arch, or compiler.
 
-        TODO: allow, e.g., $6# to customize short hash length
-        TODO: allow, e.g., $## for full hash.
+        TODO: allow, e.g., ``$6#`` to customize short hash length
+        TODO: allow, e.g., ``$##`` for full hash.
         """
         color = kwargs.get('color', False)
         length = len(format_string)

lib/spack/spack/version.py

@@ -158,7 +158,8 @@ def satisfies(self, other):
         """A Version 'satisfies' another if it is at least as specific and has
         a common prefix.  e.g., we want gcc@4.7.3 to satisfy a request for
         gcc@4.7 so that when a user asks to build with gcc@4.7, we can find
-        a suitable compiler."""
+        a suitable compiler.
+        """
 
         nself = len(self.version)
         nother = len(other.version)

var/spack/repos/builtin/packages/adios/package.py

@@ -30,7 +30,8 @@ class Adios(Package):
     """The Adaptable IO System (ADIOS) provides a simple,
     flexible way for scientists to describe the
     data in their code that may need to be written,
-    read, or processed outside of the running simulation."""
+    read, or processed outside of the running simulation.
+    """
 
     homepage = "http://www.olcf.ornl.gov/center-projects/adios/"
     url      = "https://github.com/ornladios/ADIOS/archive/v1.10.0.tar.gz"

var/spack/repos/builtin/packages/arpack-ng/package.py

@@ -50,7 +50,8 @@ class ArpackNg(Package):
     forked it and implemented their own modifications, arpack-ng aims to tackle
     this by providing a common repository and maintained versions.
 
-    arpack-ng is replacing arpack almost everywhere."""
+    arpack-ng is replacing arpack almost everywhere.
+    """
 
     homepage = 'https://github.com/opencollab/arpack-ng'
     url = 'https://github.com/opencollab/arpack-ng/archive/3.3.0.tar.gz'

var/spack/repos/builtin/packages/astyle/package.py

@@ -27,7 +27,8 @@
 
 class Astyle(Package):
     """A Free, Fast, and Small Automatic Formatter for C, C++, C++/CLI,
-    Objective-C, C#, and Java Source Code."""
+    Objective-C, C#, and Java Source Code.
+    """
 
     homepage = "http://astyle.sourceforge.net/"
     url      = "http://downloads.sourceforge.net/project/astyle/astyle/astyle%202.04/astyle_2.04_linux.tar.gz"

var/spack/repos/builtin/packages/caliper/package.py

@@ -28,7 +28,8 @@
 class Caliper(Package):
     """Caliper is a generic context annotation system. It gives programmers the
     ability to provide arbitrary program context information to (performance)
-    tools at runtime."""
+    tools at runtime.
+    """
 
     homepage = "https://github.com/LLNL/Caliper"
     url      = ""

var/spack/repos/builtin/packages/cfitsio/package.py

@@ -27,7 +27,8 @@
 
 class Cfitsio(Package):
     """CFITSIO is a library of C and Fortran subroutines for reading and writing
-    data files in FITS (Flexible Image Transport System) data format."""
+    data files in FITS (Flexible Image Transport System) data format.
+    """
 
     homepage = 'http://heasarc.gsfc.nasa.gov/fitsio/'
 

var/spack/repos/builtin/packages/cube/package.py

@@ -30,7 +30,8 @@ class Cube(Package):
     multi-dimensional performance space consisting of the dimensions:
     - performance metric
     - call path
-    - system resource"""
+    - system resource
+    """
 
     homepage = "http://www.scalasca.org/software/cube-4.x/download.html"
     url = "http://apps.fz-juelich.de/scalasca/releases/cube/4.2/dist/cube-4.2.3.tar.gz"

var/spack/repos/builtin/packages/datamash/package.py

@@ -27,7 +27,8 @@
 
 class Datamash(Package):
     """GNU datamash is a command-line program which performs basic numeric,
-    textual and statistical operations on input textual data files."""
+    textual and statistical operations on input textual data files.
+    """
 
     homepage = "https://www.gnu.org/software/datamash/"
     url      = "http://ftp.gnu.org/gnu/datamash/datamash-1.0.5.tar.gz"

var/spack/repos/builtin/packages/eigen/package.py

@@ -27,7 +27,8 @@
 
 class Eigen(Package):
     """Eigen is a C++ template library for linear algebra matrices,
-    vectors, numerical solvers, and related algorithms."""
+    vectors, numerical solvers, and related algorithms.
+    """
 
     homepage = 'http://eigen.tuxfamily.org/'
     url = 'http://bitbucket.org/eigen/eigen/get/3.2.7.tar.bz2'

var/spack/repos/builtin/packages/espresso/package.py

@@ -30,7 +30,8 @@ class Espresso(Package):
     """QE is an integrated suite of Open-Source computer codes for
     electronic-structure calculations and materials modeling at
     the nanoscale. It is based on density-functional theory, plane
-    waves, and pseudopotentials."""
+    waves, and pseudopotentials.
+    """
 
     homepage = 'http://quantum-espresso.org'
     url = 'http://www.qe-forge.org/gf/download/frsrelease/204/912/espresso-5.3.0.tar.gz'

var/spack/repos/builtin/packages/gdal/package.py

@@ -32,7 +32,8 @@ class Gdal(Package):
     it presents a single raster abstract data model and vector
     abstract data model to the calling application for all supported
     formats. It also comes with a variety of useful command line
-    utilities for data translation and processing"""
+    utilities for data translation and processing.
+    """
 
     homepage   = "http://www.gdal.org/"
     url        = "http://download.osgeo.org/gdal/2.0.2/gdal-2.0.2.tar.gz"

var/spack/repos/builtin/packages/gdb/package.py

@@ -28,7 +28,8 @@
 class Gdb(Package):
     """GDB, the GNU Project debugger, allows you to see what is going on
     'inside' another program while it executes -- or what another
-    program was doing at the moment it crashed."""
+    program was doing at the moment it crashed.
+    """
 
     homepage = "https://www.gnu.org/software/gdb"
     url = "http://ftp.gnu.org/gnu/gdb/gdb-7.10.tar.gz"

var/spack/repos/builtin/packages/gmsh/package.py

@@ -32,7 +32,8 @@ class Gmsh(Package):
     capabilities. Gmsh is built around four modules: geometry, mesh, solver and
     post-processing. The specification of any input to these modules is done
     either interactively using the graphical user interface or in ASCII text
-    files using Gmsh's own scripting language."""
+    files using Gmsh's own scripting language.
+    """
 
     homepage = 'http://gmsh.info'
     url = 'http://gmsh.info/src/gmsh-2.11.0-source.tgz'

var/spack/repos/builtin/packages/lmod/package.py

@@ -32,7 +32,8 @@ class Lmod(Package):
     dynamically change the users' environment through modulefiles. This
     includes easily adding or removing directories to the PATH environment
     variable. Modulefiles for Library packages provide environment variables
-    that specify where the library and header files can be found."""
+    that specify where the library and header files can be found.
+    """
 
     homepage = 'https://www.tacc.utexas.edu/research-development/tacc-projects/lmod'
     url = 'https://github.com/TACC/Lmod/archive/6.4.1.tar.gz'

var/spack/repos/builtin/packages/lua-luafilesystem/package.py

@@ -32,7 +32,8 @@ class LuaLuafilesystem(Package):
     LuaFileSystem offers a portable way to access the underlying directory
     structure and file attributes.
 
-    LuaFileSystem is free software and uses the same license as Lua 5.1"""
+    LuaFileSystem is free software and uses the same license as Lua 5.1
+    """
 
     homepage = 'http://keplerproject.github.io/luafilesystem'
     url = 'https://github.com/keplerproject/luafilesystem/archive/v_1_6_3.tar.gz'

var/spack/repos/builtin/packages/mxml/package.py

@@ -28,7 +28,8 @@
 class Mxml(Package):
     """Mini-XML is a small XML library that you can use to read and write XML
     and XML-like data files in your application without requiring large
-    non-standard libraries."""
+    non-standard libraries.
+    """
 
     homepage = "http://www.msweet.org"
     url = "http://www.msweet.org/files/project3/mxml-2.9.tar.gz"

var/spack/repos/builtin/packages/ncdu/package.py

@@ -30,7 +30,8 @@ class Ncdu(Package):
     to find space hogs on a remote server where you don't have an entire
     gaphical setup available, but it is a useful tool even on regular desktop
     systems. Ncdu aims to be fast, simple and easy to use, and should be able
-    to run in any minimal POSIX-like environment with ncurses installed."""
+    to run in any minimal POSIX-like environment with ncurses installed.
+    """
 
     homepage = "http://dev.yorhel.nl/ncdu"
     url      = "http://dev.yorhel.nl/download/ncdu-1.11.tar.gz"

var/spack/repos/builtin/packages/opari2/package.py

@@ -33,7 +33,8 @@ class Opari2(Package):
     as well as the usage of pre-instrumented libraries. Furthermore, an
     efficient way of tracking parent-child relationships was added.
     Additionally, we extended OPARI2 to support instrumentation of OpenMP 3.0
-    tied tasks."""
+    tied tasks.
+    """
 
     homepage = "http://www.vi-hps.org/projects/score-p"
     url      = "http://www.vi-hps.org/upload/packages/opari2/opari2-1.1.2.tar.gz"

var/spack/repos/builtin/packages/openjpeg/package.py

@@ -31,7 +31,8 @@ class Openjpeg(Package):
     still-image compression standard from the Joint Photographic
     Experts Group (JPEG).
     Since April 2015, it is officially recognized by ISO/IEC and
-    ITU-T as a JPEG 2000 Reference Software."""
+    ITU-T as a JPEG 2000 Reference Software.
+    """
 
     homepage = "https://github.com/uclouvain/openjpeg"
     url      = "https://github.com/uclouvain/openjpeg/archive/version.2.1.tar.gz"

var/spack/repos/builtin/packages/parallel/package.py

@@ -28,7 +28,8 @@
 class Parallel(Package):
     """GNU parallel is a shell tool for executing jobs in parallel using
     one or more computers. A job can be a single command or a small
-    script that has to be run for each of the lines in the input."""
+    script that has to be run for each of the lines in the input.
+    """
 
     homepage = "http://www.gnu.org/software/parallel/"
     url      = "http://ftp.gnu.org/gnu/parallel/parallel-20160422.tar.bz2"

var/spack/repos/builtin/packages/petsc/package.py

@@ -29,7 +29,8 @@
 class Petsc(Package):
     """PETSc is a suite of data structures and routines for the scalable
     (parallel) solution of scientific applications modeled by partial
-    differential equations."""
+    differential equations.
+    """
 
     homepage = "http://www.mcs.anl.gov/petsc/index.html"
     url = "http://ftp.mcs.anl.gov/pub/petsc/release-snapshots/petsc-3.5.3.tar.gz"

var/spack/repos/builtin/packages/py-prettytable/package.py

@@ -28,7 +28,8 @@
 class PyPrettytable(Package):
     """PrettyTable is a simple Python library designed to make
     it quick and easy to represent tabular data in visually
-    appealing ASCII tables."""
+    appealing ASCII tables.
+    """
 
     homepage = "https://code.google.com/archive/p/prettytable/"
     url      = "https://pypi.python.org/packages/e0/a1/36203205f77ccf98f3c6cf17cf068c972e6458d7e58509ca66da949ca347/prettytable-0.7.2.tar.gz"

var/spack/repos/builtin/packages/py-tuiview/package.py

@@ -27,7 +27,8 @@
 
 class PyTuiview(Package):
     """TuiView is a lightweight raster GIS with powerful raster attribute
-    table manipulation abilities."""
+    table manipulation abilities.
+    """
 
     homepage = "https://bitbucket.org/chchrsc/tuiview"
     url      = "https://bitbucket.org/chchrsc/tuiview/get/tuiview-1.1.7.tar.gz"

var/spack/repos/builtin/packages/scorep/package.py

@@ -28,7 +28,8 @@
 class Scorep(Package):
     """The Score-P measurement infrastructure is a highly scalable and
     easy-to-use tool suite for profiling, event tracing, and online analysis
-    of HPC applications."""
+    of HPC applications.
+    """
 
     homepage = "http://www.vi-hps.org/projects/score-p"
     url      = "http://www.vi-hps.org/upload/packages/scorep/scorep-1.2.3.tar.gz"

var/spack/repos/builtin/packages/screen/package.py

@@ -27,7 +27,8 @@
 
 class Screen(Package):
     """Screen is a full-screen window manager that multiplexes a physical
-    terminal between several processes, typically interactive shells."""
+    terminal between several processes, typically interactive shells.
+    """
 
     homepage = "https://www.gnu.org/software/screen/"
     url      = "http://ftp.gnu.org/gnu/screen/screen-4.3.1.tar.gz"

var/spack/repos/builtin/packages/swiftsim/package.py

@@ -29,7 +29,8 @@
 class Swiftsim(Package):
     """SPH With Inter-dependent Fine-grained Tasking (SWIFT) provides
     astrophysicists with a state of the art framework to perform
-    particle based simulations."""
+    particle based simulations.
+    """
 
     homepage = 'http://icc.dur.ac.uk/swift/'
     url = 'http://gitlab.cosma.dur.ac.uk/swift/swiftsim/repository/archive.tar.gz?ref=v0.3.0'

var/spack/repos/builtin/packages/tau/package.py

@@ -31,7 +31,8 @@
 class Tau(Package):
     """A portable profiling and tracing toolkit for performance
     analysis of parallel programs written in Fortran, C, C++, UPC,
-    Java, Python."""
+    Java, Python.
+    """
 
     homepage = "http://www.cs.uoregon.edu/research/tau"
     url      = "https://www.cs.uoregon.edu/research/tau/tau_releases/tau-2.25.tar.gz"

var/spack/repos/builtin/packages/xerces-c/package.py

@@ -30,7 +30,8 @@ class XercesC(Package):
     C++. Xerces-C++ makes it easy to give your application the ability to read
     and write XML data. A shared library is provided for parsing, generating,
     manipulating, and validating XML documents using the DOM, SAX, and SAX2
-    APIs."""
+    APIs.
+    """
 
     homepage = "https://xerces.apache.org/xerces-c"
     url      = "https://www.apache.org/dist/xerces/c/3/sources/xerces-c-3.1.4.tar.bz2"

var/spack/repos/builtin/packages/zsh/package.py

@@ -28,7 +28,8 @@
 class Zsh(Package):
     """Zsh is a shell designed for interactive use, although it is also a
     powerful scripting language. Many of the useful features of bash, ksh, and
-    tcsh were incorporated into zsh; many original features were added."""
+    tcsh were incorporated into zsh; many original features were added.
+    """
 
     homepage = "http://www.zsh.org"
     url = "http://downloads.sourceforge.net/project/zsh/zsh/5.1.1/zsh-5.1.1.tar.gz"