<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="X-UA-Compatible" content="IE=Edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Using pbr — pbr documentation</title>
<link rel="stylesheet" href="../_static/classic.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script type="text/javascript" src="../_static/language_data.js"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Features" href="features.html" />
<link rel="prev" title="pbr - Python Build Reasonableness" href="../index.html" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="features.html" title="Features"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="../index.html" title="pbr - Python Build Reasonableness"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">pbr documentation</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="using-pbr">
<h1>Using pbr<a class="headerlink" href="#using-pbr" title="Permalink to this headline">¶</a></h1>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="features.html">Features</a><ul>
<li class="toctree-l2"><a class="reference internal" href="features.html#setup-cfg">setup.cfg</a></li>
<li class="toctree-l2"><a class="reference internal" href="features.html#package-metadata">Package Metadata</a><ul>
<li class="toctree-l3"><a class="reference internal" href="features.html#version">Version</a></li>
<li class="toctree-l3"><a class="reference internal" href="features.html#long-description">Long Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="features.html#requirements">Requirements</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="features.html#automatic-file-generation">Automatic File Generation</a><ul>
<li class="toctree-l3"><a class="reference internal" href="features.html#authors-changelog">AUTHORS, ChangeLog</a></li>
<li class="toctree-l3"><a class="reference internal" href="features.html#manifest">Manifest</a></li>
<li class="toctree-l3"><a class="reference internal" href="features.html#release-notes">Release Notes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="features.html#setup-commands">Setup Commands</a><ul>
<li class="toctree-l3"><a class="reference internal" href="features.html#build-sphinx"><code class="docutils literal notranslate"><span class="pre">build_sphinx</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="features.html#test"><code class="docutils literal notranslate"><span class="pre">test</span></code></a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="features.html#sphinx-extension">Sphinx Extension</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="using.html">Usage</a><ul>
<li class="toctree-l2"><a class="reference internal" href="using.html#setup-py"><code class="docutils literal notranslate"><span class="pre">setup.py</span></code></a></li>
<li class="toctree-l2"><a class="reference internal" href="using.html#setup-cfg"><code class="docutils literal notranslate"><span class="pre">setup.cfg</span></code></a><ul>
<li class="toctree-l3"><a class="reference internal" href="using.html#files"><code class="docutils literal notranslate"><span class="pre">files</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="using.html#entry-points"><code class="docutils literal notranslate"><span class="pre">entry_points</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="using.html#backwards-compat"><code class="docutils literal notranslate"><span class="pre">backwards_compat</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="using.html#pbr"><code class="docutils literal notranslate"><span class="pre">pbr</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="using.html#metadata"><code class="docutils literal notranslate"><span class="pre">metadata</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="using.html#build-sphinx"><code class="docutils literal notranslate"><span class="pre">build_sphinx</span></code></a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="using.html#requirements">Requirements</a><ul>
<li class="toctree-l3"><a class="reference internal" href="using.html#extra-requirements">Extra requirements</a></li>
<li class="toctree-l3"><a class="reference internal" href="using.html#environment-markers">Environment markers</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="using.html#testing">Testing</a></li>
<li class="toctree-l2"><a class="reference internal" href="using.html#sphinx-conf-py">Sphinx <code class="docutils literal notranslate"><span class="pre">conf.py</span></code></a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="packagers.html">Notes for Package maintainers</a><ul>
<li class="toctree-l2"><a class="reference internal" href="packagers.html#versioning">Versioning</a></li>
<li class="toctree-l2"><a class="reference internal" href="packagers.html#distribution-version-numbers">Distribution version numbers</a></li>
<li class="toctree-l2"><a class="reference internal" href="packagers.html#dependencies">Dependencies</a></li>
<li class="toctree-l2"><a class="reference internal" href="packagers.html#tarballs">Tarballs</a></li>
<li class="toctree-l2"><a class="reference internal" href="packagers.html#authors-and-changelog">AUTHORS and ChangeLog</a></li>
<li class="toctree-l2"><a class="reference internal" href="packagers.html#release-notes">Release Notes</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="semver.html">Linux/Python Compatible Semantic Versioning 3.0.0</a><ul>
<li class="toctree-l2"><a class="reference internal" href="semver.html#changes-vs-semver-2-0">Changes vs SemVer 2.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="semver.html#summary">Summary</a></li>
<li class="toctree-l2"><a class="reference internal" href="semver.html#introduction">Introduction</a></li>
<li class="toctree-l2"><a class="reference internal" href="semver.html#semantic-versioning-specification-semver">Semantic Versioning Specification (SemVer)</a></li>
<li class="toctree-l2"><a class="reference internal" href="semver.html#why-use-semantic-versioning">Why Use Semantic Versioning?</a></li>
<li class="toctree-l2"><a class="reference internal" href="semver.html#faq">FAQ</a><ul>
<li class="toctree-l3"><a class="reference internal" href="semver.html#how-should-i-deal-with-revisions-in-the-0-y-z-initial-development-phase">How should I deal with revisions in the 0.y.z initial development phase?</a></li>
<li class="toctree-l3"><a class="reference internal" href="semver.html#how-do-i-know-when-to-release-1-0-0">How do I know when to release 1.0.0?</a></li>
<li class="toctree-l3"><a class="reference internal" href="semver.html#doesn-t-this-discourage-rapid-development-and-fast-iteration">Doesn’t this discourage rapid development and fast iteration?</a></li>
<li class="toctree-l3"><a class="reference internal" href="semver.html#if-even-the-tiniest-backwards-incompatible-changes-to-the-public-api-require-a-major-version-bump-won-t-i-end-up-at-version-42-0-0-very-rapidly">If even the tiniest backwards incompatible changes to the public API require a major version bump, won’t I end up at version 42.0.0 very rapidly?</a></li>
<li class="toctree-l3"><a class="reference internal" href="semver.html#documenting-the-entire-public-api-is-too-much-work">Documenting the entire public API is too much work!</a></li>
<li class="toctree-l3"><a class="reference internal" href="semver.html#what-do-i-do-if-i-accidentally-release-a-backwards-incompatible-change-as-a-minor-version">What do I do if I accidentally release a backwards incompatible change as a minor version?</a></li>
<li class="toctree-l3"><a class="reference internal" href="semver.html#what-should-i-do-if-i-update-my-own-dependencies-without-changing-the-public-api">What should I do if I update my own dependencies without changing the public API?</a></li>
<li class="toctree-l3"><a class="reference internal" href="semver.html#what-if-i-inadvertently-alter-the-public-api-in-a-way-that-is-not-compliant-with-the-version-number-change-i-e-the-code-incorrectly-introduces-a-major-breaking-change-in-a-patch-release">What if I inadvertently alter the public API in a way that is not compliant with the version number change (i.e. the code incorrectly introduces a major breaking change in a patch release)</a></li>
<li class="toctree-l3"><a class="reference internal" href="semver.html#how-should-i-handle-deprecating-functionality">How should I handle deprecating functionality?</a></li>
<li class="toctree-l3"><a class="reference internal" href="semver.html#does-semver-have-a-size-limit-on-the-version-string">Does SemVer have a size limit on the version string?</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="semver.html#about">About</a></li>
<li class="toctree-l2"><a class="reference internal" href="semver.html#license">License</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="compatibility.html">Compatibility Notes</a><ul>
<li class="toctree-l2"><a class="reference internal" href="compatibility.html#setuptools">setuptools</a><ul>
<li class="toctree-l3"><a class="reference internal" href="compatibility.html#evaluate-marker">evaluate_marker</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="compatibility.html#pip">pip</a><ul>
<li class="toctree-l3"><a class="reference internal" href="compatibility.html#markers">markers</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="compatibility.html#recommended-setup-py">Recommended setup.py</a></li>
<li class="toctree-l2"><a class="reference internal" href="compatibility.html#sphinx">Sphinx</a><ul>
<li class="toctree-l3"><a class="reference internal" href="compatibility.html#version-1-5-0">Version 1.5.0+</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="history.html">Release History</a><ul>
<li class="toctree-l2"><a class="reference internal" href="history.html#changes">CHANGES</a><ul>
<li class="toctree-l3"><a class="reference internal" href="history.html#id1">5.1.3</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id2">5.1.2</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id3">5.1.1</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id4">5.1.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id5">5.0.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id6">4.3.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id7">4.2.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id8">4.1.1</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id9">4.1.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id10">4.0.4</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id11">4.0.3</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id12">4.0.2</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id13">4.0.1</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id14">4.0.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id15">3.1.1</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id16">3.1.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id17">3.0.1</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id18">3.0.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id19">2.1.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id20">2.0.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id21">1.10.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id22">1.9.1</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id23">1.9.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id24">1.8.1</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id25">1.8.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id26">1.7.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id27">1.6.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id28">1.5.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id29">1.4.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id30">1.3.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id31">1.2.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id32">1.1.1</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id33">1.1.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id34">1.0.1</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id35">1.0.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id36">0.11.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id37">0.10.7</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id38">0.10.6</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id39">0.10.5</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id40">0.10.4</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id41">0.10.3</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id42">0.10.1</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id43">0.10.2</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id44">0.9.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id45">0.8.2</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id46">0.8.1</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id47">0.8.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id48">0.7.0</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id49">0.6</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id50">0.5.23</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id51">0.5.22</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id52">0.5.21</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id53">0.5.20</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id54">0.5.19</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id55">0.5.18</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id56">0.5.17</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id57">0.5.16</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id58">0.5.15</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id59">0.5.14</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id60">0.5.12</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id61">0.5.11</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id62">0.5.10</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id63">0.5.8</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id64">0.5.6</a></li>
<li class="toctree-l3"><a class="reference internal" href="history.html#id65">0.5.0</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h4>Previous topic</h4>
<p class="topless"><a href="../index.html"
title="previous chapter">pbr - Python Build Reasonableness</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="features.html"
title="next chapter">Features</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/user/index.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="features.html" title="Features"
>next</a> |</li>
<li class="right" >
<a href="../index.html" title="pbr - Python Build Reasonableness"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../index.html">pbr documentation</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2013, OpenStack Foundation.
Last updated on 2019-04-20 06:58.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.8.4.
</div>
</body>
</html>
distrib
>
Mageia
>
7
>
armv7hl
>
media
>
core-release
>
by-pkgid
>
3c443fe242219304a28324562b3cad80
>
files
>
226
