zhangyiss/spack
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Fix some documentation build warnings. (#1902)

Browse Source 
- Fix issue with package_list.py regeneration confusing Sphinx.
- Add -E option to avoid caching and make Sphinx happy.
This commit is contained in:
Todd Gamblin 2016-10-04 12:37:57 -07:00 committed by GitHub
parent 7806fded3e
commit 544fa3eddb
3 changed files with 13 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
lib/spack/docs/Makefile
View File

@ -2,7 +2,7 @@
# #
# You can set these variables from the command line. # You can set these variables from the command line.
SPHINXOPTS = SPHINXOPTS = -E
SPHINXBUILD = sphinx-build SPHINXBUILD = sphinx-build
PAPER = PAPER =
BUILDDIR = _build BUILDDIR = _build

3
lib/spack/docs/command_index.in
View File

@ -1,5 +1,4 @@
.. _command_index: =================
Command index Command index
================= =================

7
lib/spack/docs/conf.py
View File

@ -1,10 +1,7 @@
# flake8: noqa # flake8: noqa
############################################################################## ##############################################################################
# Copyright (c) 2013, Lawrence Livermore National Security, LLC.
# Produced at the Lawrence Livermore National Laboratory.
#
# This file is part of Spack. # This file is part of Spack.
# Written by Todd Gamblin, tgamblin@llnl.gov, All rights reserved. # Created by Todd Gamblin, tgamblin@llnl.gov.
# LLNL-CODE-647188 # LLNL-CODE-647188
# #
# For details, see https://github.com/llnl/spack # For details, see https://github.com/llnl/spack
@ -70,6 +67,7 @@
# #
# Generate package list using spack command # Generate package list using spack command
# #
if not os.path.exists('package_list.rst'):
with open('package_list.rst', 'w') as plist_file: with open('package_list.rst', 'w') as plist_file:
subprocess.Popen( subprocess.Popen(
[spack_root + '/bin/spack', 'package-list'], stdout=plist_file) [spack_root + '/bin/spack', 'package-list'], stdout=plist_file)
@ -85,6 +83,7 @@
if match: if match:
command_names.append(match.group(1).strip()) command_names.append(match.group(1).strip())
if not os.path.exists('command_index.rst'):
shutil.copy('command_index.in', 'command_index.rst') shutil.copy('command_index.in', 'command_index.rst')
with open('command_index.rst', 'a') as index: with open('command_index.rst', 'a') as index:
index.write('\n') index.write('\n')