http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog History/revisions of FreeSource/AltLinux/Policy/Drafts/RPMChangelog en-us http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog/show?time=2008-06-11+21%3A59%3A04 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a name=".altlinux.policy.drafts.rpmchangelog" href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Policy&nbsp;/&nbsp;Drafts&nbsp;/&nbsp;RPM&nbsp;Changelog</a> за <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-06-11+21%3A59%3A04">2008-06-11 21:59:04</a> и <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog">2008-07-17 15:09:14</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><div class="action" style="float:right; width:250px"><div class="action-content">Эта&nbsp;страница была перенесена на&nbsp;<a href="http://altlinux.org/Drafts/RPMChangelog" target="_blank" title="" class="outerlink">altlinux.org</a>. Текст на&nbsp;freesource.info заморожен.</div></div><br /> [ Andrey Rahmatullin ]<br /> [ Vladislav Primerov ]<br /> [ Alexander Sluchainyi ]<br /> &ndash; specfile cleanup<br /> Здесь всё, что&nbsp;относится к&nbsp;сборке 4.6.2-alt7.pre1, будем называть <em>записью</em>, имя&nbsp;в&nbsp;квадратных скобках &ndash; группой, текст, начинающийся с&nbsp;дефиса (&laquo;&ndash; make visible_tabs and&nbsp;visible_tws mcedit options configurable through config file (Debian)&raquo;) &ndash; <em>пунктом</em>, текст, начинающийся с&nbsp;плюса (&laquo;+ recognize man&nbsp;pages with additional suffixes other than 'x', such as&nbsp;write.3p (Debian)&raquo;) &ndash; <em>подпунктом</em>, одну строку файла спека (&laquo;&ndash; make visible_tabs and&nbsp;visible_tws mcedit options configurable through config&raquo;) &ndash; <em>строкой</em>.<br /> <ul><li> Группы состоят из&nbsp;имени в&nbsp;квадратных скобках и&nbsp;начинаются с&nbsp;первой позиции строки. </li><li> Если в&nbsp;сборке версии существенно принимало участие более одного человека, то&nbsp;изменения, вносимые разными людьми, собираются в&nbsp;группы по&nbsp;авторам.</li></ul></div><br /> <b>Удалено:</b><br /> <div class="deletions">Здесь всё, что&nbsp;относится к&nbsp;сборке 4.6.2-alt7.pre1, будем называть <em>записью</em>, текст, начинающийся с&nbsp;дефиса (&laquo;&ndash; make visible_tabs and&nbsp;visible_tws mcedit options configurable through config file (Debian)&raquo;) &ndash; <em>пунктом</em>, текст, начинающийся с&nbsp;плюса (&laquo;+ recognize man&nbsp;pages with additional suffixes other than 'x', such as&nbsp;write.3p (Debian)&raquo;) &ndash; <em>подпунктом</em>, одну строку файла спека (&laquo;&ndash; make visible_tabs and&nbsp;visible_tws mcedit options configurable through config&raquo;) &ndash; <em>строкой</em>.</div></div> http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog/show?time=2008-05-29+02%3A38%3A36 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Policy&nbsp;/&nbsp;Drafts&nbsp;/&nbsp;RPM&nbsp;Changelog</a> за <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-05-29+02%3A38%3A36">2008-05-29 02:38:36</a> и <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-06-11+21%3A59%3A04">2008-06-11 21:59:04</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">||Пушер(ы)|//никто за&nbsp;пропихивание в&nbsp;жизнь не&nbsp;взялся//||<br /> ||Контрибутор(ы)|Андрей Рахматуллин (wrar@), Михаил Гусаров (dottedmag@)||</div><br /> <b>Удалено:</b><br /> <div class="deletions">||Автор(ы)|Андрей Рахматуллин (wrar@)||<br /> ||Контрибутор(ы)|Михаил Гусаров (dottedmag@)||</div></div> http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog/show?time=2008-05-26+21%3A36%3A44 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Policy&nbsp;/&nbsp;Drafts&nbsp;/&nbsp;RPM&nbsp;Changelog</a> за <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-05-26+21%3A36%3A44">2008-05-26 21:36:44</a> и <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-05-29+02%3A38%3A36">2008-05-29 02:38:36</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">Здесь всё, что&nbsp;относится к&nbsp;сборке 4.6.2-alt7.pre1, будем называть <em>записью</em>, текст, начинающийся с&nbsp;дефиса (&laquo;&ndash; make visible_tabs and&nbsp;visible_tws mcedit options configurable through config file (Debian)&raquo;) &ndash; <em>пунктом</em>, текст, начинающийся с&nbsp;плюса (&laquo;+ recognize man&nbsp;pages with additional suffixes other than 'x', such as&nbsp;write.3p (Debian)&raquo;) &ndash; <em>подпунктом</em>, одну строку файла спека (&laquo;&ndash; make visible_tabs and&nbsp;visible_tws mcedit options configurable through config&raquo;) &ndash; <em>строкой</em>.</div><br /> <b>Удалено:</b><br /> <div class="deletions">Здесь всё, что&nbsp;относится к&nbsp;сборке 4.6.2-alt7.pre1, будем называть <em>записью</em>, текст, начинающийся с&nbsp;дефиса (&laquo;&ndash; make visible_tabs and&nbsp;visible_tws mcedit options configurable through config file (Debian)") &ndash; <em>пунктом</em>, текст, начинающийся с&nbsp;плюса ("+ recognize man&nbsp;pages with additional suffixes other than 'x', such as&nbsp;write.3p (Debian)") &ndash; <em>подпунктом</em>, одну строку файла спека (&laquo;&ndash; make visible_tabs and&nbsp;visible_tws mcedit options configurable through config&raquo;) &ndash; <em>строкой</em>.</div></div> http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog/show?time=2008-05-21+14%3A03%3A22 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Policy&nbsp;/&nbsp;Drafts&nbsp;/&nbsp;RPM&nbsp;Changelog</a> за <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-05-21+14%3A03%3A22">2008-05-21 14:03:22</a> и <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-05-26+21%3A36%3A44">2008-05-26 21:36:44</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">||Автор(ы)|Андрей Рахматуллин (wrar@)||<br /> ||Контрибутор(ы)|Михаил Гусаров (dottedmag@)||</div><br /> <b>Удалено:</b><br /> <div class="deletions">||Автор(ы)|Андрей Рахматуллин (wrar@), Михаил Гусаров (dottedmag@)||</div></div> http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog/show?time=2008-05-18+22%3A21%3A37 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Policy&nbsp;/&nbsp;Drafts&nbsp;/&nbsp;RPM&nbsp;Changelog</a> за <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-05-18+22%3A21%3A37">2008-05-18 22:21:37</a> и <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-05-21+14%3A03%3A22">2008-05-21 14:03:22</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><ul><li> Специальный синтаксис (Closes: #12345, #6789) закрывает (точнее, будет закрывать после введения в&nbsp;строй соответствующей инфраструктуры) все&nbsp;упомянутые в&nbsp;скобках баги в&nbsp;багтракере при&nbsp;прохождении пакета в&nbsp;Сизиф. </li><li> Номера багов в&nbsp;скобках разделяются запятыми.</li></ul></div><br /> <b>Удалено:</b><br /> <div class="deletions"><ul><li> Специальный синтаксис (Closes: #12345, #6789) закрывает (точнее, будет закрывать после введения в&nbsp;строй соответствующей инфраструктуры) все&nbsp;упомянутые в&nbsp;скобках баги в&nbsp;багтракере при&nbsp;прохождении пакета в&nbsp;Сизиф. </li></ul></div></div> http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog/show?time=2008-05-18+22%3A02%3A36 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Policy&nbsp;/&nbsp;Drafts&nbsp;/&nbsp;RPM&nbsp;Changelog</a> за <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-05-18+22%3A02%3A36">2008-05-18 22:02:36</a> и <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-05-18+22%3A21%3A37">2008-05-18 22:21:37</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><ul><li> При&nbsp;сборке новой upstream-версии это&nbsp;указывается первым пунктом. <ul><li> При&nbsp;сборке из&nbsp;снэпшота системы контроля версий необходимо указать информацию, позволяющую идентифицировать это&nbsp;снэпшот (дата и&nbsp;время для&nbsp;CVS, ревизия SVN, 8 первых символов идентификатора коммита для&nbsp;git, mtn, bzr, hg, либо вывод git-describe для&nbsp;git). </li></ul></li><li> Если changelog пакета оформлен единообразно, не&nbsp;нарушайте это&nbsp;единообразие (если оно&nbsp;не&nbsp;противоречит этому policy). Если же&nbsp;changelog хаотичен или&nbsp;противоречит нормативной части этого policy, то&nbsp;оставленный перед changelog комментарий о&nbsp;стиле ведения changelog с&nbsp;текущей версии поможет избежать продолжения хаоса в&nbsp;будущем. </li><li> Единообразно оформляйте предложения changelog'а: либо начинайте, либо не&nbsp;начинайте их&nbsp;все с&nbsp;большой буквы; либо заканчивайте, либо не&nbsp;заканчивайте их&nbsp;точкой.</li></ul></div><br /> <b>Удалено:</b><br /> <div class="deletions"><a name="h8494-1"></a><h1> Оформление </h1> <ul><li> Все&nbsp;пункты начинаются со&nbsp;строчной буквы и&nbsp;не заканчиваются точкой. </li><li> При&nbsp;сборке новой upstream-версии это&nbsp;указывается первым пунктом. <tt>Возможные варианты: &#8220;new version&#8221;, &#8220;0.0.1&#8221;, "[0.0.1]", &laquo;new version [0.0.1]" и&nbsp;т.д. Желательно зафиксировать. Особенно случаи сборки VCS-снапшота.</tt></li></ul></div></div> http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog/show?time=2008-05-18+00%3A11%3A04 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Policy&nbsp;/&nbsp;Drafts&nbsp;/&nbsp;RPM&nbsp;Changelog</a> за <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-05-18+00%3A11%3A04">2008-05-18 00:11:04</a> и <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-05-18+22%3A02%3A36">2008-05-18 22:02:36</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">||Автор(ы)|Андрей Рахматуллин (wrar@), Михаил Гусаров (dottedmag@)||<a name="h8494-1"></a><h1> Синтаксис чейнджлога </h1> <ul><li> Исправления, необходимые для&nbsp;успешной сборки, соответствия требованиям ALT&nbsp;Linux и&nbsp;т.д., не&nbsp;указываются, если они&nbsp;были сопряжены с&nbsp;упаковкой новой версии и&nbsp;для старой версии были не&nbsp;нужны (эти исправления &ndash; адаптация новой версии, т.е. часть процесса её упаковки). Если же&nbsp;они были вызваны изменением требований либо окружения, желательно это&nbsp;указать (пример: &#8220;fix building with new&nbsp;autotools&#8221;). </li><li> Если изменение связано с&nbsp;багом в&nbsp;багзилле ALT&nbsp;Linux, номер бага указывается в&nbsp;скобках в&nbsp;соответствующем пункте. Это&nbsp;может быть совмещено с&nbsp;предыдущим требованием. Синтаксис такого рода помещает (точнее, будет помещать после введения в&nbsp;строй соответствующей инфраструктуры) в&nbsp;указанный баг&nbsp;оповещение о&nbsp;том, что&nbsp;такой пакет вышел. </li><li> Специальный синтаксис (Closes: #12345, #6789) закрывает (точнее, будет закрывать после введения в&nbsp;строй соответствующей инфраструктуры) все&nbsp;упомянутые в&nbsp;скобках баги в&nbsp;багтракере при&nbsp;прохождении пакета в&nbsp;Сизиф. </li></ul><a name="h8494-2"></a><h1> Best practices оформления changelog </h1> <span class="cite">Эта секция не&nbsp;является нормативной</span><br /> <ul><li> Старайтесь, чтобы все&nbsp;предложения в&nbsp;changelog были в&nbsp;одной форме (&laquo;fix memory leaks&raquo;, &#8220;fixed memory leaks&#8221;, &#8220;memory leaks fixed&#8221;, но&nbsp;не смесь разных форм в&nbsp;одной записи), в&nbsp;таком виде их&nbsp;гораздо удобнее читать. </li><li> Группировка сходных пунктов в&nbsp;подпункты позволяет уменьшить размер changelog'а и&nbsp;улучшить его&nbsp;читаемость.</li></ul></div><br /> <b>Удалено:</b><br /> <div class="deletions">||Автор(ы)|Андрей Рахматуллин (wrar@)||<br /> <ul><li> Желательно, чтобы все&nbsp;предложения были в&nbsp;одной форме (&laquo;fix memory leaks&raquo;, &#8220;fixed memory leaks&#8221;, &#8220;memory leaks fixed&#8221;, но&nbsp;не смесь разных форм в&nbsp;одной записи). <tt>можно в&nbsp;принципе попробовать выбрать и&nbsp;зафиксировать одну форму</tt> </li><li> Все&nbsp;пункты, являющиеся фразами, оформляются как&nbsp;предложения (с прописной буквы, заканчиваются точкой).</li></ul> <tt>либо</tt><br /> <ul><li> Сходные пункты желательно группировать, используя подпункты. </li><li> Исправления, необходимые для&nbsp;успешной сборки, соответствия требованиям ALT&nbsp;Linux и&nbsp;т.д., не&nbsp;указываются, если они&nbsp;были сопряжены с&nbsp;упаковкой новой версии и&nbsp;для старой версии были не&nbsp;нужны (обоснование: эти&nbsp;исправления &ndash; адаптация новой версии, т.е. часть процесса её упаковки). Если же&nbsp;они были вызваны изменением требований либо окружения, желательно это&nbsp;указать (пример: &#8220;fix building with new&nbsp;autotools&#8221;). </li><li> Если изменение связано с&nbsp;багом в&nbsp;багзилле ALT&nbsp;Linux, номер бага указывается в&nbsp;скобках в&nbsp;соответствующем пункте. Это&nbsp;может быть совмещено с&nbsp;предыдущим требованием. В&nbsp;дальнейшем эта&nbsp;информация может быть автоматически передана в&nbsp;указанный баг. </li><li> Если изменение не&nbsp;просто связано с&nbsp;багом, но&nbsp;закрывает его&nbsp;&ndash; это&nbsp;желательно указать в&nbsp;форме "(closes: #12345)". В&nbsp;дальнейшем на&nbsp;основании такой записи указанный баг&nbsp;может быть автоматически закрыт.</li></ul></div></div> http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog/show?time=2008-05-16+09%3A41%3A16 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Policy&nbsp;/&nbsp;Drafts&nbsp;/&nbsp;RPM&nbsp;Changelog</a> за <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-05-16+09%3A41%3A16">2008-05-16 09:41:16</a> и <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-05-18+00%3A11%3A04">2008-05-18 00:11:04</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">||Обязательно в|4.1 и&nbsp;выше||<br /> <ul><li> При&nbsp;сборке новой upstream-версии это&nbsp;указывается первым пунктом. <tt>Возможные варианты: &#8220;new version&#8221;, &#8220;0.0.1&#8221;, "[0.0.1]", &laquo;new version [0.0.1]" и&nbsp;т.д. Желательно зафиксировать. Особенно случаи сборки VCS-снапшота.</tt> </li><li> Исправления, необходимые для&nbsp;успешной сборки, соответствия требованиям ALT&nbsp;Linux и&nbsp;т.д., не&nbsp;указываются, если они&nbsp;были сопряжены с&nbsp;упаковкой новой версии и&nbsp;для старой версии были не&nbsp;нужны (обоснование: эти&nbsp;исправления &ndash; адаптация новой версии, т.е. часть процесса её упаковки). Если же&nbsp;они были вызваны изменением требований либо окружения, желательно это&nbsp;указать (пример: &#8220;fix building with new&nbsp;autotools&#8221;). </li><li> Если изменение связано с&nbsp;багом в&nbsp;багзилле ALT&nbsp;Linux, номер бага указывается в&nbsp;скобках в&nbsp;соответствующем пункте. Это&nbsp;может быть совмещено с&nbsp;предыдущим требованием. В&nbsp;дальнейшем эта&nbsp;информация может быть автоматически передана в&nbsp;указанный баг. </li><li> Если изменение не&nbsp;просто связано с&nbsp;багом, но&nbsp;закрывает его&nbsp;&ndash; это&nbsp;желательно указать в&nbsp;форме "(closes: #12345)". В&nbsp;дальнейшем на&nbsp;основании такой записи указанный баг&nbsp;может быть автоматически закрыт.</li></ul></div><br /> <b>Удалено:</b><br /> <div class="deletions">||Обязательно в|не применимо||<br /> <ul><li> При&nbsp;сборке новой версии это&nbsp;указывается первым пунктом. <tt>Возможные варианты: &#8220;new version&#8221;, &#8220;0.0.1&#8221;, "[0.0.1]", &laquo;new version [0.0.1]" и&nbsp;т.д. Можно зафиксировать.</tt> </li><li> Исправления, необходимые для&nbsp;успешной сборки, соответствия требованиям ALT&nbsp;Linux и&nbsp;т.д., не&nbsp;указываются, если они&nbsp;были сопряжены с&nbsp;упаковкой новой версии (обоснование: эти&nbsp;исправления &ndash; адаптация новой версии, т.е. часть процесса её упаковки). Если же&nbsp;они были вызваны изменением требований либо окружения, желательно это&nbsp;указать (пример: &#8220;fix building with new&nbsp;autotools&#8221;). </li><li> Если изменение связано с&nbsp;багом в&nbsp;багзилле ALT&nbsp;Linux, номер бага указывается в&nbsp;скобках в&nbsp;соответствующем пункте. Это&nbsp;может быть совмещено с&nbsp;предыдущим требованием.</li></ul></div></div> http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog/show?time=2008-05-15+21%3A36%3A11 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Policy&nbsp;/&nbsp;Drafts&nbsp;/&nbsp;RPM&nbsp;Changelog</a> за <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-05-15+21%3A36%3A11">2008-05-15 21:36:11</a> и <a href="http://freesource.info/wiki/AltLinux/Policy/Drafts/RPMChangelog?time=2008-05-16+09%3A41%3A16">2008-05-16 09:41:16</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">||Статус|Черновик, ((http://lists.altlinux.org/pipermail/devel/2008-May/074100.html обсуждение))||</div><br /> <b>Удалено:</b><br /> <div class="deletions">||Статус|Черновик, обсуждение не&nbsp;начато||</div></div>