Skip to content

Commit 50075f9

Browse files
author
Doctr (Travis CI)
committed
Update docs after building Travis build 816 of
drdoctr/doctr The docs were built from the branch 'temp-dir' against the commit 1a3e6a1. The Travis build that generated this commit is at https://travis-ci.org/drdoctr/doctr/jobs/253941287. The doctr command that was run is /home/travis/build/drdoctr/doctr/doctr/__main__.py deploy --sync --no-require-master --built-docs docs/_build/html docs-temp-dir
1 parent 029a0fc commit 50075f9

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

45 files changed

+18315
-0
lines changed

docs-temp-dir/.doctr-files

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
docs-temp-dir/_modules/doctr/local.html
2+
docs-temp-dir/_modules/doctr/travis.html
3+
docs-temp-dir/_modules/index.html
4+
docs-temp-dir/_sources/api.rst.txt
5+
docs-temp-dir/_sources/changelog.rst.txt
6+
docs-temp-dir/_sources/commandline.rst.txt
7+
docs-temp-dir/_sources/index.rst.txt
8+
docs-temp-dir/_sources/recipes.rst.txt
9+
docs-temp-dir/_sources/releasing.rst.txt
10+
docs-temp-dir/_sources/tests.rst.txt
11+
docs-temp-dir/_static/ajax-loader.gif
12+
docs-temp-dir/_static/alabaster.css
13+
docs-temp-dir/_static/basic.css
14+
docs-temp-dir/_static/comment-bright.png
15+
docs-temp-dir/_static/comment-close.png
16+
docs-temp-dir/_static/comment.png
17+
docs-temp-dir/_static/custom.css
18+
docs-temp-dir/_static/doctools.js
19+
docs-temp-dir/_static/down-pressed.png
20+
docs-temp-dir/_static/down.png
21+
docs-temp-dir/_static/file.png
22+
docs-temp-dir/_static/jquery-3.1.0.js
23+
docs-temp-dir/_static/jquery.js
24+
docs-temp-dir/_static/minus.png
25+
docs-temp-dir/_static/plus.png
26+
docs-temp-dir/_static/pygments.css
27+
docs-temp-dir/_static/searchtools.js
28+
docs-temp-dir/_static/underscore-1.3.1.js
29+
docs-temp-dir/_static/underscore.js
30+
docs-temp-dir/_static/up-pressed.png
31+
docs-temp-dir/_static/up.png
32+
docs-temp-dir/_static/websupport.js
33+
docs-temp-dir/api.html
34+
docs-temp-dir/changelog.html
35+
docs-temp-dir/commandline.html
36+
docs-temp-dir/genindex.html
37+
docs-temp-dir/index.html
38+
docs-temp-dir/objects.inv
39+
docs-temp-dir/py-modindex.html
40+
docs-temp-dir/recipes.html
41+
docs-temp-dir/releasing.html
42+
docs-temp-dir/search.html
43+
docs-temp-dir/searchindex.js
44+
docs-temp-dir/tests.html

docs-temp-dir/_modules/doctr/local.html

Lines changed: 344 additions & 0 deletions
Large diffs are not rendered by default.

docs-temp-dir/_modules/doctr/travis.html

Lines changed: 536 additions & 0 deletions
Large diffs are not rendered by default.

docs-temp-dir/_modules/index.html

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
2+
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4+
5+
<html xmlns="http://www.w3.org/1999/xhtml">
6+
<head>
7+
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
8+
<title>Overview: module code &#8212; Doctr 1.5.3+29.g1a3e6a1 documentation</title>
9+
<link rel="stylesheet" href="../_static/alabaster.css" type="text/css" />
10+
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
11+
<script type="text/javascript">
12+
var DOCUMENTATION_OPTIONS = {
13+
URL_ROOT: '../',
14+
VERSION: '1.5.3+29.g1a3e6a1',
15+
COLLAPSE_INDEX: false,
16+
FILE_SUFFIX: '.html',
17+
HAS_SOURCE: true,
18+
SOURCELINK_SUFFIX: '.txt'
19+
};
20+
</script>
21+
<script type="text/javascript" src="../_static/jquery.js"></script>
22+
<script type="text/javascript" src="../_static/underscore.js"></script>
23+
<script type="text/javascript" src="../_static/doctools.js"></script>
24+
<link rel="index" title="Index" href="../genindex.html" />
25+
<link rel="search" title="Search" href="../search.html" />
26+
27+
<link rel="stylesheet" href="../_static/custom.css" type="text/css" />
28+
29+
30+
<meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
31+
32+
</head>
33+
<body>
34+
35+
36+
<div class="document">
37+
<div class="documentwrapper">
38+
<div class="bodywrapper">
39+
<div class="body" role="main">
40+
41+
<h1>All modules for which code is available</h1>
42+
<ul><li><a href="doctr/local.html">doctr.local</a></li>
43+
<li><a href="doctr/travis.html">doctr.travis</a></li>
44+
</ul>
45+
46+
</div>
47+
</div>
48+
</div>
49+
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
50+
<div class="sphinxsidebarwrapper"><div class="relations">
51+
<h3>Related Topics</h3>
52+
<ul>
53+
<li><a href="../index.html">Documentation overview</a><ul>
54+
</ul></li>
55+
</ul>
56+
</div>
57+
<div id="searchbox" style="display: none" role="search">
58+
<h3>Quick search</h3>
59+
<form class="search" action="../search.html" method="get">
60+
<div><input type="text" name="q" /></div>
61+
<div><input type="submit" value="Go" /></div>
62+
<input type="hidden" name="check_keywords" value="yes" />
63+
<input type="hidden" name="area" value="default" />
64+
</form>
65+
</div>
66+
<script type="text/javascript">$('#searchbox').show(0);</script>
67+
</div>
68+
</div>
69+
<div class="clearer"></div>
70+
</div>
71+
<div class="footer">
72+
&copy;2016, Aaron Meurer and Gil Forsyth.
73+
74+
|
75+
Powered by <a href="http://sphinx-doc.org/">Sphinx 1.6.3</a>
76+
&amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.10</a>
77+
78+
</div>
79+
80+
81+
<a href="https://github.com/drdoctr/doctr" class="github">
82+
<img style="position: absolute; top: 0; right: 0; border: 0;" src="https://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub" class="github"/>
83+
</a>
84+
85+
86+
87+
</body>
88+
</html>

docs-temp-dir/_sources/api.rst.txt

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
=====
2+
API
3+
=====
4+
5+
This is the Python API. We recommend that most users use doctr from the
6+
command line.
7+
8+
Local
9+
=====
10+
11+
.. automodule:: doctr.local
12+
:members:
13+
14+
Travis
15+
======
16+
17+
.. automodule:: doctr.travis
18+
:members:
Lines changed: 183 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,183 @@
1+
=================
2+
Doctr Changelog
3+
=================
4+
5+
Current
6+
=======
7+
- Invalid input won't kill ``doctr`` but will instead prompt again for valid
8+
input. Prevents users from having to go through the whole login rigamarole
9+
again. (:issue:`181`)
10+
11+
1.5.3 (2017-04-07)
12+
==================
13+
- Fix for ``doctr configure`` crashing (:issue:`179`)
14+
15+
1.5.2 (2017-03-29)
16+
==================
17+
- Fix for bug that prevented deploying using ``no-require-master``
18+
19+
1.5.1 (2017-03-17)
20+
==================
21+
- Fix for critical bug that allowed pushing docs from any branch. (:issue:`160`)
22+
23+
1.5.0 (2017-03-15)
24+
==================
25+
- The ``--gh-pages-docs`` flag of ``doctr deploy`` has been deprecated.
26+
Specify the deploy directory like ``doctr deploy .`` or ``doctr deploy docs``.
27+
There is also no longer a default deploy directory. (:issue:`128`)
28+
- ``setup_GitHub_push`` now takes a ``branch_whitelist`` parameter instead of
29+
of a ``require_master``
30+
- ``.travis.yml`` can be used to store some of doctr configuration in addition
31+
to the command line flags. Write doctr configuration under the ``doctr`` key.
32+
(:issue:`137`)
33+
- All boolean command line flags now have a counterpart that can overwrite
34+
the config values set in ``.travis.yml``
35+
- ``doctr`` can now deploy to organization accounts (``github.io``)
36+
(:issue:`25`)
37+
- Added ``--deploy-branch-name`` flag to specify which branch docs will be
38+
deployed to
39+
40+
1.4.1 (2017-01-11)
41+
==================
42+
- Fix Travis API endpoint when checking if a repo exists. (:issue:`143`)
43+
- Add warnings about needing ``set -e`` in ``.travis.yml``. (:issue:`146`)
44+
- Explicitly pull from ``doctr_remote`` on Travis. (:issue:`147`)
45+
- Don't attempt to push ``gh-pages`` to the remote when pushing is disallowed
46+
(e.g., on a pull request). (:issue:`150`)
47+
- ``doctr configure`` now deletes the public key automatically. (:issue:`151`)
48+
49+
1.4.0 (2016-11-11)
50+
==================
51+
52+
- Set the git ``user.email`` configuration option. This is now required by the
53+
latest versions of git. (:issue:`138`, :issue:`139`)
54+
- Add more information to the automated commit messages. (:issue:`134`)
55+
- Run doctr tests on Travis with a personal access token, avoiding rate
56+
limiting errors. (:issue:`133`)
57+
- Run all doctr steps except for the push on every build. Add ``--no-push``
58+
option. Thanks @Carreau. (:issue:`125`, :issue:`126`, :issue:`132`)
59+
- Clarify in docs that doctr is not just for Sphinx. (:issue:`129`,
60+
:issue:`130`)
61+
- Use the latest version of sphinxcontrib.autoprogram to build the doctr docs.
62+
(:issue:`127`)
63+
- Check that the build repo exists on Travis. (:issue:`114`, :issue:`123`)
64+
65+
1.3.3 (2016-09-20)
66+
==================
67+
68+
- Add support for private GitHub repositories using travis-ci.com (thanks
69+
@dan-blanchard). (:issue:`121`)
70+
- Add a list of projects using doctr to the docs. (:issue:`116`)
71+
- Use the sphinx-issues extension in the changelog. (:issue:`99`)
72+
- Swap "description" and "long_description" in setup.py. (:issue:`120`)
73+
74+
1.3.2 (2016-09-01)
75+
==================
76+
77+
Major Changes
78+
-------------
79+
80+
- Fix the --built-docs option. (:issue:`111`)
81+
82+
Minor Changes
83+
-------------
84+
85+
- Get the setup.py description from the README. (:issue:`103`)
86+
- Add link to GitHub docs for branch protection (thanks @willingc). (:issue:`100`)
87+
88+
1.3.1 (2016-08-31)
89+
==================
90+
91+
Major Changes
92+
-------------
93+
94+
- Fix a bug that would cause doctr to fail if run on a pull request from a
95+
fork. (:issue:`101`)
96+
97+
1.3 (2016-08-30)
98+
================
99+
100+
Major Changes
101+
-------------
102+
103+
- Remove the ``--tmp-dir`` flag from the command line (doctr now always
104+
deploys using a log file). (:issue:`92`)
105+
- Python API: Change ``commit_docs`` to actually commit the docs (previously,
106+
it was done in ``push_docs``). (:issue:`92`)
107+
- Python API: Don't sync files or get the build dir in ``commit_docs``. This
108+
is done separately in ``__main__.py``. The Python API for ``commit_docs`` is
109+
now ``commit_docs(*, added, removed)``. (:issue:`92`)
110+
- Python API: ``sync_from_log`` automatically includes the log file in the list of added
111+
files. (:issue:`92`)
112+
- Support running doctr multiple times in the same build. (:issue:`93`, :issue:`95`)
113+
- Add ``doctr deploy --command`` to allow running a command before committing
114+
and deploying. (:issue:`97`)
115+
- Add ``doctr deploy --no-sync`` to allow disabling syncing (useful with
116+
``doctr deploy --command``). (:issue:`97`)
117+
118+
Minor Changes
119+
-------------
120+
121+
- Correctly commit the log file. (:issue:`92`)
122+
- Fix sync_from_log to create dst if it doesn't exist, and add tests for this. (:issue:`92`)
123+
- Don't assume that doctr is being run from master when creating gh-pages. (:issue:`93`)
124+
- Return to the previous branch after deploying. (:issue:`93`)
125+
- Remove extra space before options in configure help text. (:issue:`90`)
126+
127+
1.2 (2016-08-29)
128+
================
129+
130+
Major Changes
131+
-------------
132+
- Allow ``--gh-pages-docs .`` (deploying to the root directory of the
133+
``gh-pages`` branch). (:issue:`73`)
134+
- Allow deploying to a separate repo (via ``doctr deploy --deploy-repo <repo>``). (:issue:`63`)
135+
- Automatically detect Sphinx build directory. (:issue:`6`)
136+
- Add ``--no-require-master`` flag to allow pushing from branches other than master. (:issue:`70`)
137+
138+
Minor Changes
139+
-------------
140+
- Add a GitHub banner to the docs. (:issue:`64`)
141+
- Move to the GitHub organization `drdoctr <https://github.com/drdoctr>`_. (:issue:`67`)
142+
- Check if user/org and repo are valid before generating ssh keys or pinging Travis. (:issue:`87`)
143+
- Various improvements to documentation.
144+
- Various improvements to error checking.
145+
146+
1.1.1 (2016-08-09)
147+
==================
148+
149+
Minor Changes
150+
-------------
151+
152+
- Add installation instructions to the documentation. (:issue:`60`)
153+
- Fix some lingering "Travis docs builder" -> "Doctr", including in the git
154+
attributes on Travis. (:issue:`60`)
155+
- Better error message when the repo doesn't exist in doctr configure. (:issue:`59`)
156+
- Indicate that repo should be org/reponame in doctr configure. (:issue:`59`)
157+
158+
1.1 (2016-08-09)
159+
================
160+
161+
Major Changes
162+
-------------
163+
164+
- Add a real command line interface with argparse. (:issue:`23`)
165+
- Split the command line into ``doctr configure`` and ``doctr deploy``. (:issue:`28`)
166+
- Add support for using GitHub deploy keys (now the default) (:issue:`30`)
167+
168+
Minor Changes
169+
-------------
170+
171+
- Add flags to ``doctr deploy`` to change the build and deploy locations of
172+
the docs. (:issue:`52`)
173+
- Print more helpful instructions from ``doctr configure``. (:issue:`46`)
174+
- Add more documentation. (:issue:`47`)
175+
176+
1.0 (2016-07-22)
177+
================
178+
179+
Major Changes
180+
-------------
181+
182+
- First release. Basic support for configuring doctr to push to Travis (using
183+
a token) and deploying to gh-pages from Travis.
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
=========================
2+
Doctr Command Line Help
3+
=========================
4+
5+
.. autoprogram:: doctr.__main__:get_parser()
6+
:prog: doctr
7+
8+
9+
Configuration
10+
-------------
11+
12+
In addition to command line arguments you can configure ``doctr`` using the
13+
``.travis.yml`` files. Command line arguments take precedence over the value
14+
present in the configuration file.
15+
16+
The configuration parameters available from the ``.travis.yml`` file mirror
17+
their command line siblings except doubledashes ``--`` and ``--no-`` prefix are
18+
dropped.
19+
20+
Use a ``doctr`` section in your ``travis.yml`` file to store your doctr
21+
configuration:
22+
23+
.. code:: yaml
24+
25+
- language: python
26+
- script:
27+
- set -e
28+
- py.test
29+
- cd docs
30+
- make html
31+
- cd ..
32+
- doctr deploy .
33+
- doctr:
34+
- key-path : 'path/to/key/from/repo/root/path.key'
35+
- deploy-repo : 'myorg/myrepo'
36+
37+
38+
The following options are available from the configuration file and not from
39+
the command line:
40+
41+
``branches``:
42+
A list of regular expression that matches branches on which ``doctr`` should
43+
still deploy the documentation. For example ``.*\.x`` will deploy all
44+
branches like ``3.x``, ``4.x`` ...
45+

0 commit comments

Comments
 (0)