{"action":"created","comment":{"url":"https://api.github.com/repos/pulp/pulp/pulls/comments/26014304","id":26014304,"diff_hunk":"@@ -260,59 +226,50 @@ stream you are building.\n    follow the\n    `Fedora Package Versioning Scheme <http://fedoraproject.org/wiki/Packaging:NamingGuidelines#Package_Versioning>`_.\n \n-Beta, Testing, and Release Candidate Tagging\n-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n-These streams can make use of the tagging bash script, ``tag.sh``. The script will ask you to edit\n-the changelog entries, tag the git repositories, and push the tags to GitHub.\n-\n-For example, to tag 2.4.2-0.3.beta you can do this::\n+Checking the versions that will be built\n+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n+You can use the ``build-all.py`` script to validate versions that will be built/downloaded.\n+This can be used to double check to ensure that the correct versions have been set in the spec\n+files. This command will exit immediately after displaying the versions.::\n \n-    $ ./pulp/tag.sh -v 2.4.2-0.3.beta\n-\n-Release Tagging\n-^^^^^^^^^^^^^^^\n-For a release you will need to raise the versions of the setup.py, conf.py, and spec files. Each\n-Python package in each Pulp repository has a setup.py. Find each of these, and set its version\n-appropriately. Do the same for the conf.py in the ``docs/`` folder for each repository.\n-\n-.. note::\n+    $ ./build-all.py 2.6-testing --show-versions\n \n-   We do not include the release field in the setup.py or conf.py files, so this is only necessary\n-   when introducing a new x.y.z version.\n+If one of the versions is not what you expect updated it using the ``update-version.py`` script\n+and push the change to github.\n \n-Edit the spec file and raise the version and release fields to the desired values. Be sure to add an\n-entry to the changelog as well, including any bug fixes that you find in the git log since the last\n-build. We do not want to carry lots of old pre-release changelog entries around, so please find the\n-changelog entries for the last build in your release stream and group them into the current version\n-you are building. This way we can avoid lots of entries for ``0.1.beta``, ``0.2.beta``, etc. that\n-all have a bug or two (or none) each. If you are making a release, there should be no changelog\n-entries for the pre-release builds included at all. Once you have done this, you can use tito to tag\n-the repository for building. You will need to use tito in each of the directories that contain a\n-spec file.::\n+Updating Versions\n+^^^^^^^^^^^^^^^^^\n+The ``update-version.py`` script will scan a directory and set the versions inside according to\n+your specifications.  For example, to if you have been working in the ``/tmp/pulp_build`` directory\n+the following command can be used to update pulp_docker from the release candidate to the release\n+build version.::\n \n-    $ tito tag --keep-version --no-auto-changelog\n-\n-Pay attention to the instructions from tito, as you will need to push your changes to the upstream Pulp\n-repository, as well as the tags that tito generated.\n+   $ cd /tmp/pulp_build/pulp_packaging/ci/\n+   $ ./build-all.py 2.6-testing --show-versions\n+   .. Versions displayed ..\n+   $ ./update-version.py --update-type stage /tmp/pulp_build/pulp_packaging\n \n+At this point you can inspect the files to ensure the versions are as you expect. The changes\n+will still need to be committed & pushed to github before they can be used to build. You can\n+rerun the ``build-all.py`` script to check the versions again after your changes have been\n+pushed to github.","path":"docs/dev-guide/contributing/building.rst","position":269,"original_position":269,"commit_id":"927e220fad79195dae4ff9d7dcb045a064009ee2","original_commit_id":"927e220fad79195dae4ff9d7dcb045a064009ee2","user":{"login":"rbarlow","id":354506,"avatar_url":"https://avatars.githubusercontent.com/u/354506?v=3","gravatar_id":"","url":"https://api.github.com/users/rbarlow","html_url":"https://github.com/rbarlow","followers_url":"https://api.github.com/users/rbarlow/followers","following_url":"https://api.github.com/users/rbarlow/following{/other_user}","gists_url":"https://api.github.com/users/rbarlow/gists{/gist_id}","starred_url":"https://api.github.com/users/rbarlow/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rbarlow/subscriptions","organizations_url":"https://api.github.com/users/rbarlow/orgs","repos_url":"https://api.github.com/users/rbarlow/repos","events_url":"https://api.github.com/users/rbarlow/events{/privacy}","received_events_url":"https://api.github.com/users/rbarlow/received_events","type":"User","site_admin":false},"body":"We should probably use \"GitHub\" instead of \"github\" throughout this document.","created_at":"2015-03-09T03:49:09Z","updated_at":"2015-03-09T03:49:09Z","html_url":"https://github.com/pulp/pulp/pull/1682#discussion_r26014304","pull_request_url":"https://api.github.com/repos/pulp/pulp/pulls/1682","_links":{"self":{"href":"https://api.github.com/repos/pulp/pulp/pulls/comments/26014304"},"html":{"href":"https://github.com/pulp/pulp/pull/1682#discussion_r26014304"},"pull_request":{"href":"https://api.github.com/repos/pulp/pulp/pulls/1682"}}},"pull_request":{"url":"https://api.github.com/repos/pulp/pulp/pulls/1682","id":30285124,"html_url":"https://github.com/pulp/pulp/pull/1682","diff_url":"https://github.com/pulp/pulp/pull/1682.diff","patch_url":"https://github.com/pulp/pulp/pull/1682.patch","issue_url":"https://api.github.com/repos/pulp/pulp/issues/1682","number":1682,"state":"open","locked":false,"title":"Update the build instructions for the changes to the build tooling in or...","user":{"login":"barnabycourt","id":5054204,"avatar_url":"https://avatars.githubusercontent.com/u/5054204?v=3","gravatar_id":"","url":"https://api.github.com/users/barnabycourt","html_url":"https://github.com/barnabycourt","followers_url":"https://api.github.com/users/barnabycourt/followers","following_url":"https://api.github.com/users/barnabycourt/following{/other_user}","gists_url":"https://api.github.com/users/barnabycourt/gists{/gist_id}","starred_url":"https://api.github.com/users/barnabycourt/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/barnabycourt/subscriptions","organizations_url":"https://api.github.com/users/barnabycourt/orgs","repos_url":"https://api.github.com/users/barnabycourt/repos","events_url":"https://api.github.com/users/barnabycourt/events{/privacy}","received_events_url":"https://api.github.com/users/barnabycourt/received_events","type":"User","site_admin":false},"body":"...der to independent plugin versioning","created_at":"2015-03-02T14:04:08Z","updated_at":"2015-03-09T03:49:09Z","closed_at":null,"merged_at":null,"merge_commit_sha":"214ca93c1002197e0a442cf7a51f114c21d5d9a0","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/pulp/pulp/pulls/1682/commits","review_comments_url":"https://api.github.com/repos/pulp/pulp/pulls/1682/comments","review_comment_url":"https://api.github.com/repos/pulp/pulp/pulls/comments{/number}","comments_url":"https://api.github.com/repos/pulp/pulp/issues/1682/comments","statuses_url":"https://api.github.com/repos/pulp/pulp/statuses/927e220fad79195dae4ff9d7dcb045a064009ee2","head":{"label":"barnabycourt:doc-build-changes","ref":"doc-build-changes","sha":"927e220fad79195dae4ff9d7dcb045a064009ee2","user":{"login":"barnabycourt","id":5054204,"avatar_url":"https://avatars.githubusercontent.com/u/5054204?v=3","gravatar_id":"","url":"https://api.github.com/users/barnabycourt","html_url":"https://github.com/barnabycourt","followers_url":"https://api.github.com/users/barnabycourt/followers","following_url":"https://api.github.com/users/barnabycourt/following{/other_user}","gists_url":"https://api.github.com/users/barnabycourt/gists{/gist_id}","starred_url":"https://api.github.com/users/barnabycourt/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/barnabycourt/subscriptions","organizations_url":"https://api.github.com/users/barnabycourt/orgs","repos_url":"https://api.github.com/users/barnabycourt/repos","events_url":"https://api.github.com/users/barnabycourt/events{/privacy}","received_events_url":"https://api.github.com/users/barnabycourt/received_events","type":"User","site_admin":false},"repo":{"id":25038093,"name":"pulp","full_name":"barnabycourt/pulp","owner":{"login":"barnabycourt","id":5054204,"avatar_url":"https://avatars.githubusercontent.com/u/5054204?v=3","gravatar_id":"","url":"https://api.github.com/users/barnabycourt","html_url":"https://github.com/barnabycourt","followers_url":"https://api.github.com/users/barnabycourt/followers","following_url":"https://api.github.com/users/barnabycourt/following{/other_user}","gists_url":"https://api.github.com/users/barnabycourt/gists{/gist_id}","starred_url":"https://api.github.com/users/barnabycourt/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/barnabycourt/subscriptions","organizations_url":"https://api.github.com/users/barnabycourt/orgs","repos_url":"https://api.github.com/users/barnabycourt/repos","events_url":"https://api.github.com/users/barnabycourt/events{/privacy}","received_events_url":"https://api.github.com/users/barnabycourt/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/barnabycourt/pulp","description":"Repository for Pulp platform code, including the server and base admin and consumer clients","fork":true,"url":"https://api.github.com/repos/barnabycourt/pulp","forks_url":"https://api.github.com/repos/barnabycourt/pulp/forks","keys_url":"https://api.github.com/repos/barnabycourt/pulp/keys{/key_id}","collaborators_url":"https://api.github.com/repos/barnabycourt/pulp/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/barnabycourt/pulp/teams","hooks_url":"https://api.github.com/repos/barnabycourt/pulp/hooks","issue_events_url":"https://api.github.com/repos/barnabycourt/pulp/issues/events{/number}","events_url":"https://api.github.com/repos/barnabycourt/pulp/events","assignees_url":"https://api.github.com/repos/barnabycourt/pulp/assignees{/user}","branches_url":"https://api.github.com/repos/barnabycourt/pulp/branches{/branch}","tags_url":"https://api.github.com/repos/barnabycourt/pulp/tags","blobs_url":"https://api.github.com/repos/barnabycourt/pulp/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/barnabycourt/pulp/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/barnabycourt/pulp/git/refs{/sha}","trees_url":"https://api.github.com/repos/barnabycourt/pulp/git/trees{/sha}","statuses_url":"https://api.github.com/repos/barnabycourt/pulp/statuses/{sha}","languages_url":"https://api.github.com/repos/barnabycourt/pulp/languages","stargazers_url":"https://api.github.com/repos/barnabycourt/pulp/stargazers","contributors_url":"https://api.github.com/repos/barnabycourt/pulp/contributors","subscribers_url":"https://api.github.com/repos/barnabycourt/pulp/subscribers","subscription_url":"https://api.github.com/repos/barnabycourt/pulp/subscription","commits_url":"https://api.github.com/repos/barnabycourt/pulp/commits{/sha}","git_commits_url":"https://api.github.com/repos/barnabycourt/pulp/git/commits{/sha}","comments_url":"https://api.github.com/repos/barnabycourt/pulp/comments{/number}","issue_comment_url":"https://api.github.com/repos/barnabycourt/pulp/issues/comments{/number}","contents_url":"https://api.github.com/repos/barnabycourt/pulp/contents/{+path}","compare_url":"https://api.github.com/repos/barnabycourt/pulp/compare/{base}...{head}","merges_url":"https://api.github.com/repos/barnabycourt/pulp/merges","archive_url":"https://api.github.com/repos/barnabycourt/pulp/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/barnabycourt/pulp/downloads","issues_url":"https://api.github.com/repos/barnabycourt/pulp/issues{/number}","pulls_url":"https://api.github.com/repos/barnabycourt/pulp/pulls{/number}","milestones_url":"https://api.github.com/repos/barnabycourt/pulp/milestones{/number}","notifications_url":"https://api.github.com/repos/barnabycourt/pulp/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/barnabycourt/pulp/labels{/name}","releases_url":"https://api.github.com/repos/barnabycourt/pulp/releases{/id}","created_at":"2014-10-10T14:04:33Z","updated_at":"2015-02-16T16:32:27Z","pushed_at":"2015-03-04T20:27:16Z","git_url":"git://github.com/barnabycourt/pulp.git","ssh_url":"git@github.com:barnabycourt/pulp.git","clone_url":"https://github.com/barnabycourt/pulp.git","svn_url":"https://github.com/barnabycourt/pulp","homepage":"","size":81323,"stargazers_count":0,"watchers_count":0,"language":"Python","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":1,"forks":0,"open_issues":1,"watchers":0,"default_branch":"master"}},"base":{"label":"pulp:2.6-dev","ref":"2.6-dev","sha":"84be883df43804622042abb03ccc979ba3710d60","user":{"login":"pulp","id":2103606,"avatar_url":"https://avatars.githubusercontent.com/u/2103606?v=3","gravatar_id":"","url":"https://api.github.com/users/pulp","html_url":"https://github.com/pulp","followers_url":"https://api.github.com/users/pulp/followers","following_url":"https://api.github.com/users/pulp/following{/other_user}","gists_url":"https://api.github.com/users/pulp/gists{/gist_id}","starred_url":"https://api.github.com/users/pulp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pulp/subscriptions","organizations_url":"https://api.github.com/users/pulp/orgs","repos_url":"https://api.github.com/users/pulp/repos","events_url":"https://api.github.com/users/pulp/events{/privacy}","received_events_url":"https://api.github.com/users/pulp/received_events","type":"Organization","site_admin":false},"repo":{"id":5314652,"name":"pulp","full_name":"pulp/pulp","owner":{"login":"pulp","id":2103606,"avatar_url":"https://avatars.githubusercontent.com/u/2103606?v=3","gravatar_id":"","url":"https://api.github.com/users/pulp","html_url":"https://github.com/pulp","followers_url":"https://api.github.com/users/pulp/followers","following_url":"https://api.github.com/users/pulp/following{/other_user}","gists_url":"https://api.github.com/users/pulp/gists{/gist_id}","starred_url":"https://api.github.com/users/pulp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pulp/subscriptions","organizations_url":"https://api.github.com/users/pulp/orgs","repos_url":"https://api.github.com/users/pulp/repos","events_url":"https://api.github.com/users/pulp/events{/privacy}","received_events_url":"https://api.github.com/users/pulp/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/pulp/pulp","description":"Repository for Pulp platform code, including the server and base admin and consumer clients","fork":false,"url":"https://api.github.com/repos/pulp/pulp","forks_url":"https://api.github.com/repos/pulp/pulp/forks","keys_url":"https://api.github.com/repos/pulp/pulp/keys{/key_id}","collaborators_url":"https://api.github.com/repos/pulp/pulp/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/pulp/pulp/teams","hooks_url":"https://api.github.com/repos/pulp/pulp/hooks","issue_events_url":"https://api.github.com/repos/pulp/pulp/issues/events{/number}","events_url":"https://api.github.com/repos/pulp/pulp/events","assignees_url":"https://api.github.com/repos/pulp/pulp/assignees{/user}","branches_url":"https://api.github.com/repos/pulp/pulp/branches{/branch}","tags_url":"https://api.github.com/repos/pulp/pulp/tags","blobs_url":"https://api.github.com/repos/pulp/pulp/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/pulp/pulp/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/pulp/pulp/git/refs{/sha}","trees_url":"https://api.github.com/repos/pulp/pulp/git/trees{/sha}","statuses_url":"https://api.github.com/repos/pulp/pulp/statuses/{sha}","languages_url":"https://api.github.com/repos/pulp/pulp/languages","stargazers_url":"https://api.github.com/repos/pulp/pulp/stargazers","contributors_url":"https://api.github.com/repos/pulp/pulp/contributors","subscribers_url":"https://api.github.com/repos/pulp/pulp/subscribers","subscription_url":"https://api.github.com/repos/pulp/pulp/subscription","commits_url":"https://api.github.com/repos/pulp/pulp/commits{/sha}","git_commits_url":"https://api.github.com/repos/pulp/pulp/git/commits{/sha}","comments_url":"https://api.github.com/repos/pulp/pulp/comments{/number}","issue_comment_url":"https://api.github.com/repos/pulp/pulp/issues/comments{/number}","contents_url":"https://api.github.com/repos/pulp/pulp/contents/{+path}","compare_url":"https://api.github.com/repos/pulp/pulp/compare/{base}...{head}","merges_url":"https://api.github.com/repos/pulp/pulp/merges","archive_url":"https://api.github.com/repos/pulp/pulp/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/pulp/pulp/downloads","issues_url":"https://api.github.com/repos/pulp/pulp/issues{/number}","pulls_url":"https://api.github.com/repos/pulp/pulp/pulls{/number}","milestones_url":"https://api.github.com/repos/pulp/pulp/milestones{/number}","notifications_url":"https://api.github.com/repos/pulp/pulp/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/pulp/pulp/labels{/name}","releases_url":"https://api.github.com/repos/pulp/pulp/releases{/id}","created_at":"2012-08-06T13:49:20Z","updated_at":"2015-03-09T03:36:23Z","pushed_at":"2015-03-09T03:36:23Z","git_url":"git://github.com/pulp/pulp.git","ssh_url":"git@github.com:pulp/pulp.git","clone_url":"https://github.com/pulp/pulp.git","svn_url":"https://github.com/pulp/pulp","homepage":"","size":204021,"stargazers_count":183,"watchers_count":183,"language":"Python","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":75,"mirror_url":null,"open_issues_count":16,"forks":75,"open_issues":16,"watchers":183,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/pulp/pulp/pulls/1682"},"html":{"href":"https://github.com/pulp/pulp/pull/1682"},"issue":{"href":"https://api.github.com/repos/pulp/pulp/issues/1682"},"comments":{"href":"https://api.github.com/repos/pulp/pulp/issues/1682/comments"},"review_comments":{"href":"https://api.github.com/repos/pulp/pulp/pulls/1682/comments"},"review_comment":{"href":"https://api.github.com/repos/pulp/pulp/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/pulp/pulp/pulls/1682/commits"},"statuses":{"href":"https://api.github.com/repos/pulp/pulp/statuses/927e220fad79195dae4ff9d7dcb045a064009ee2"}}}}