<p>Benjamin Keith Ford <strong>uploaded patch set #3</strong> to this change.</p><p><a href="https://gerrit.asterisk.org/c/repotools/+/10941">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">build: Improve handling of CHANGES and UPGRADE.txt for releases.<br><br>The release script now handles the merging of the CHANGES and<br>UPGRADE.txt files for us! When a release is being done, the script will<br>go through the staging changes in the Asterisk working directory<br>(<asterisk-home>/doc/<file>-staging) and add each change to the<br>corresponding file. A separate script (process-staging-changes) has also<br>been added that can be used when creating a new version from master. It<br>takes 3 arguments: -l/--local-root, which is optional,<br>-s/--start-version, and -e/--end-version. You can use -h for more<br>information on each option. Another script has been added that should be<br>run after process-staging-changes. This script is called<br>commit-staging-changes. It will go through all unstaged changes, add<br>them, and then commit them to the local repository. Then it will push<br>these changes to the remote. These scripts should be used for master or<br>if we need to do things manually (for some reason).<br><br>This means that there's a new way to document our major changes. All<br>changes for CHANGES will go into doc/CHANGES-staging and all changes for<br>UPGRADE.txt will go into doc/UPGRADE-staging. Each of these files should<br>have a meaningful name related to what the change is. For example, if<br>you made a change to something in pjsip, your file might be called<br>"res_pjsip_relative_title", where "relative_title" will be something a<br>little more descriptive than that. Inside of each file, you will have a<br>subject line followed by a blank line, with the description of the<br>change following that. You can have multiple subject lines in one file.<br>For example, it may look something like this:<br><br>   Subject: res_pjsip<br><br>   This is a detailed description of what I changed.<br><br>   You can have new lines in between as well, spacing is handled by the<br>   release script!<br><br>   Subject: res_pjsip<br><br>   You can have another subject as well!<br><br>   Subject: Core<br><br>   The subjects don't have to be the same either!<br><br>The header lines (Subject:) are case sensative. One thing to note is<br>that master is different. Since changes that are master-only will only<br>go into the master branch, we add another special tag (Master-Only) that<br>will go underneath the "Subject:" header. There should be no space<br>between these.<br><br>Fore more information, check out the wiki page:<br>https://wiki.asterisk.org/wiki/display/AST/CHANGES+and+UPGRADE.txt<br><br>First step for ASTERISK_28111. The directories will need to be added,<br>and all changes will need to be refactored into these directories. Also,<br>the UPGRADE.txt file will no longer branch off into different files for<br>each release of a new major version, so these should be merged together<br>as well to reduce clutter.<br><br>Change-Id: I6dc084afedaeecaf36aaec66c3cf6a5a8ed4ef3c<br>---<br>A commit-staging-changes<br>M digium_git.py<br>M mkrelease.py<br>A process-staging-changes<br>A staging_changes.py<br>5 files changed, 366 insertions(+), 6 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.asterisk.org:29418/repotools refs/changes/41/10941/3</pre><p>To view, visit <a href="https://gerrit.asterisk.org/c/repotools/+/10941">change 10941</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.asterisk.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.asterisk.org/c/repotools/+/10941"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: repotools </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: I6dc084afedaeecaf36aaec66c3cf6a5a8ed4ef3c </div>
<div style="display:none"> Gerrit-Change-Number: 10941 </div>
<div style="display:none"> Gerrit-PatchSet: 3 </div>
<div style="display:none"> Gerrit-Owner: Benjamin Keith Ford <bford@digium.com> </div>
<div style="display:none"> Gerrit-Reviewer: Benjamin Keith Ford <bford@digium.com> </div>
<div style="display:none"> Gerrit-MessageType: newpatchset </div>