/usr/share/doc/html/merge-faq.html is in python-setuptools-doc 3.3-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 | <!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="Content-Type" content="text/html; charset=utf-8" />
<title>Setuptools/Distribute Merge FAQ — Setuptools documentation</title>
<link rel="stylesheet" href="_static/nature.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '3.3',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</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>
<link rel="top" title="Setuptools documentation" href="index.html" />
<link rel="up" title="Merge with Distribute" href="merge.html" />
<link rel="prev" title="Merge with Distribute" href="merge.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="merge.html" title="Merge with Distribute"
accesskey="P">previous</a></li>
<li><a href="index.html">Setuptools</a> »</li>
<li><a href="merge.html" accesskey="U">Merge with Distribute</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="setuptools-distribute-merge-faq">
<h1>Setuptools/Distribute Merge FAQ<a class="headerlink" href="#setuptools-distribute-merge-faq" title="Permalink to this headline">¶</a></h1>
<div class="section" id="how-do-i-upgrade-from-distribute">
<h2>How do I upgrade from Distribute?<a class="headerlink" href="#how-do-i-upgrade-from-distribute" title="Permalink to this headline">¶</a></h2>
<p>Distribute specifically prohibits installation of Setuptools 0.7 from Distribute 0.6. There are then two options for upgrading.</p>
<p>Note that after upgrading using either technique, the only option to downgrade to either version is to completely uninstall Distribute and Setuptools 0.7 versions before reinstalling an 0.6 release.</p>
<div class="section" id="use-distribute-0-7">
<h3>Use Distribute 0.7<a class="headerlink" href="#use-distribute-0-7" title="Permalink to this headline">¶</a></h3>
<p>The PYPA has put together a compatibility wrapper, a new release of Distribute version 0.7. This package will install over Distribute 0.6.x installations and will replace Distribute with a simple wrapper that requires Setuptools 0.7 or later. This technique is experimental, but initial results indicate this technique is the easiest upgrade path.</p>
</div>
<div class="section" id="uninstall">
<h3>Uninstall<a class="headerlink" href="#uninstall" title="Permalink to this headline">¶</a></h3>
<p>First, completely uninstall Distribute. Since Distribute does not have an automated installation routine, this process is manual. Follow the instructions in the README for uninstalling.</p>
</div>
</div>
<div class="section" id="how-do-i-upgrade-from-setuptools-0-6">
<h2>How do I upgrade from Setuptools 0.6?<a class="headerlink" href="#how-do-i-upgrade-from-setuptools-0-6" title="Permalink to this headline">¶</a></h2>
<p>There are no special instructions for upgrading over older versions of Setuptools. Simply use <cite>easy_install -U</cite> or run the latest <cite>ez_setup.py</cite>.</p>
</div>
<div class="section" id="where-does-the-merge-occur">
<h2>Where does the merge occur?<a class="headerlink" href="#where-does-the-merge-occur" title="Permalink to this headline">¶</a></h2>
<p>The merge is occurring between the heads of the default branch of Distribute and the setuptools-0.6 branch of Setuptools. The Setuptools SVN repo has been converted to a Mercurial repo hosted on Bitbucket. The work is still underway, so the exact changesets included may change, although the anticipated merge targets are Setuptools at 0.6c12 and Distribute at 0.6.35.</p>
</div>
<div class="section" id="what-happens-to-other-branches">
<h2>What happens to other branches?<a class="headerlink" href="#what-happens-to-other-branches" title="Permalink to this headline">¶</a></h2>
<p>Distribute 0.7 was abandoned long ago and won’t be included in the resulting code tree, but may be retained for posterity in the original repo.</p>
<p>Setuptools default branch (also 0.7 development) may also be abandoned or may be incorporated into the new merged line if desirable (and as resources allow).</p>
</div>
<div class="section" id="what-history-is-lost-changed">
<h2>What history is lost/changed?<a class="headerlink" href="#what-history-is-lost-changed" title="Permalink to this headline">¶</a></h2>
<p>As setuptools was not on Mercurial when the fork occurred and as Distribute did not include the full setuptools history (prior to the creation of the setuptools-0.6 branch), the two source trees were not compatible. In order to most effectively communicate the code history, the Distribute code was grafted onto the (originally private) setuptools Mercurial repo. Although this grafting maintained the full code history with names, dates, and changes, it did lose the original hashes of those changes. Therefore, references to changes by hash (including tags) are lost.</p>
<p>Additionally, any heads that were not actively merged into the Distribute 0.6.35 release were also omitted. As a result, the changesets included in the merge repo are those from the original setuptools repo and all changesets ancestral to the Distribute 0.6.35 release.</p>
</div>
<div class="section" id="what-features-will-be-in-the-merged-code-base">
<h2>What features will be in the merged code base?<a class="headerlink" href="#what-features-will-be-in-the-merged-code-base" title="Permalink to this headline">¶</a></h2>
<p>In general, all “features” added in distribute will be included in setuptools. Where there exist conflicts or undesirable features, we will be explicit about what these limitations are. Changes that are backward-incompatible from setuptools 0.6 to distribute will likely be removed, and these also will be well documented.</p>
<p>Bootstrapping scripts (ez_setup/distribute_setup) and docs, as with distribute, will be maintained in the repository and built as part of the release process. Documentation and bootstrapping scripts will be hosted at python.org, as they are with distribute now. Documentation at telecommunity will be updated to refer or redirect to the new, merged docs.</p>
<p>On the whole, the merged setuptools should be largely compatible with the latest releases of both setuptools and distribute and will be an easy transition for users of either library.</p>
</div>
<div class="section" id="who-is-invited-to-contribute-who-is-excluded">
<h2>Who is invited to contribute? Who is excluded?<a class="headerlink" href="#who-is-invited-to-contribute-who-is-excluded" title="Permalink to this headline">¶</a></h2>
<p>While we’ve worked privately to initiate this merge due to the potential sensitivity of the topic, no one is excluded from this effort. We invite all members of the community, especially those most familiar with Python packaging and its challenges to join us in the effort.</p>
<p>We have lots of ideas for how we’d like to improve the codebase, release process, everything. Like distribute, the post-merge setuptools will have its source hosted on bitbucket. (So if you’re currently a distribute contributor, about the only thing that’s going to change is the URL of the repository you follow.) Also like distribute, it’ll support Python 3, and hopefully we’ll soon merge Vinay Sajip’s patches to make it run on Python 3 without needing 2to3 to be run on the code first.</p>
<p>While we’ve worked privately to initiate this merge due to the potential sensitivity of the topic, no one is excluded from this effort. We invite all members of the community, especially those most familiar with Python packaging and its challenges to join us in the effort.</p>
</div>
<div class="section" id="why-setuptools-and-not-distribute-or-another-name">
<h2>Why Setuptools and not Distribute or another name?<a class="headerlink" href="#why-setuptools-and-not-distribute-or-another-name" title="Permalink to this headline">¶</a></h2>
<p>We do, however, understand that this announcement might be unsettling for some. The setuptools name has been subjected to a lot of deprecation in recent years, so the idea that it will now be the preferred name instead of distribute might be somewhat difficult or disorienting for some. We considered use of another name (Distribute or an entirely new name), but that would serve to only complicate matters further. Instead, our goal is to simplify the packaging landscape but without losing any hard-won advancements. We hope that the people who worked to spread the first message will be equally enthusiastic about spreading the new one, and we especially look forward to seeing the new posters and slogans celebrating setuptools.</p>
</div>
<div class="section" id="what-is-the-timeframe-of-release">
<h2>What is the timeframe of release?<a class="headerlink" href="#what-is-the-timeframe-of-release" title="Permalink to this headline">¶</a></h2>
<p>There are no hard timeframes for any of this effort, although progress is underway and a draft merge is underway and being tested privately. As an unfunded volunteer effort, our time to put in on it is limited, and we’ve both had some recent health and other challenges that have made working on this difficult, which in part explains why we haven’t met our original deadline of a completed merge before PyCon.</p>
<p>The final Setuptools 0.7 was cut on June 1, 2013 and will be released to PyPI shortly thereafter.</p>
</div>
<div class="section" id="what-version-number-can-i-expect-for-the-new-release">
<h2>What version number can I expect for the new release?<a class="headerlink" href="#what-version-number-can-i-expect-for-the-new-release" title="Permalink to this headline">¶</a></h2>
<p>The new release will roughly follow the previous trend for setuptools and release the new release as 0.7. This number is somewhat arbitrary, but we wanted something other than 0.6 to distinguish it from its ancestor forks but not 1.0 to avoid putting too much emphasis on the release itself and to focus on merging the functionality. In the future, the project will likely adopt a versioning scheme similar to semver to convey semantic meaning about the release in the version number.</p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Setuptools/Distribute Merge FAQ</a><ul>
<li><a class="reference internal" href="#how-do-i-upgrade-from-distribute">How do I upgrade from Distribute?</a><ul>
<li><a class="reference internal" href="#use-distribute-0-7">Use Distribute 0.7</a></li>
<li><a class="reference internal" href="#uninstall">Uninstall</a></li>
</ul>
</li>
<li><a class="reference internal" href="#how-do-i-upgrade-from-setuptools-0-6">How do I upgrade from Setuptools 0.6?</a></li>
<li><a class="reference internal" href="#where-does-the-merge-occur">Where does the merge occur?</a></li>
<li><a class="reference internal" href="#what-happens-to-other-branches">What happens to other branches?</a></li>
<li><a class="reference internal" href="#what-history-is-lost-changed">What history is lost/changed?</a></li>
<li><a class="reference internal" href="#what-features-will-be-in-the-merged-code-base">What features will be in the merged code base?</a></li>
<li><a class="reference internal" href="#who-is-invited-to-contribute-who-is-excluded">Who is invited to contribute? Who is excluded?</a></li>
<li><a class="reference internal" href="#why-setuptools-and-not-distribute-or-another-name">Why Setuptools and not Distribute or another name?</a></li>
<li><a class="reference internal" href="#what-is-the-timeframe-of-release">What is the timeframe of release?</a></li>
<li><a class="reference internal" href="#what-version-number-can-i-expect-for-the-new-release">What version number can I expect for the new release?</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="merge.html"
title="previous chapter">Merge with Distribute</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/merge-faq.txt"
rel="nofollow">Show Source</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<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>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="merge.html" title="Merge with Distribute"
>previous</a></li>
<li><a href="index.html">Setuptools</a> »</li>
<li><a href="merge.html" >Merge with Distribute</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2009-2013, The fellowship of the packaging.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2.
</div>
</body>
</html>
|