/usr/share/doc/maint-guide-ru/html/update.ru.html is in maint-guide-ru 1.2.35.
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 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Глава 8. Обновление пакета</title>
<link rel="stylesheet" type="text/css" href="maint-guide.css"/>
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1"/>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<link rel="home" href="index.ru.html" title="Руководство начинающего разработчика Debian"/>
<link rel="up" href="index.ru.html" title="Руководство начинающего разработчика Debian"/>
<link rel="prev" href="checkit.ru.html" title="Глава 7. Проверка пакета на наличие ошибок"/>
<link rel="next" href="upload.ru.html" title="Глава 9. Отправка пакета"/>
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">Глава 8. Обновление пакета</th>
</tr>
<tr>
<td align="left"><a accesskey="p" href="checkit.ru.html"><img src="images/prev.png" alt="Пред."/></a> </td>
<th width="60%" align="center"> </th>
<td align="right"> <a accesskey="n" href="upload.ru.html"><img src="images/next.png" alt="След."/></a></td>
</tr>
</table>
<hr/>
</div>
<div class="chapter">
<div class="titlepage">
<div>
<div>
<h1 class="title"><a id="update"/>Глава 8. Обновление пакета</h1>
</div>
</div>
</div>
<div class="toc">
<p>
<strong>Содержание</strong>
</p>
<dl class="toc">
<dt>
<span class="section">
<a href="update.ru.html#newrevision">8.1. Новая редакция Debian</a>
</span>
</dt>
<dt>
<span class="section">
<a href="update.ru.html#inspectnewupstream">8.2. Изучение нового авторского выпуска</a>
</span>
</dt>
<dt>
<span class="section">
<a href="update.ru.html#newupstream">8.3. Новый авторский выпуск</a>
</span>
</dt>
<dt>
<span class="section">
<a href="update.ru.html#packagestyle">8.4. Обновление стиля пакетирования</a>
</span>
</dt>
<dt>
<span class="section">
<a href="update.ru.html#utf8">8.5. Преобразование в UTF-8</a>
</span>
</dt>
<dt>
<span class="section">
<a href="update.ru.html#reminders">8.6. Замечания по обновлению пакетов</a>
</span>
</dt>
</dl>
</div>
<p>
Вскоре после выпуска пакета, вам понадобится его обновить.
</p>
<div class="section">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="newrevision"/>8.1. Новая редакция Debian</h2>
</div>
</div>
</div>
<p>
Предположим, что в вашем пакете нашли ошибку (номер
<code class="literal">#654321</code>), и описываемую там проблему вы можете
решить. Для того, чтобы создать новую редакцию пакета, нужно:
</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
Если исправление должно быть записано в виде новой заплаты, сделайте
следующее:
</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
запустите <code class="literal">dquilt new
<em class="replaceable"><code>название-ошибки.patch</code></em></code> для присвоения
имени заплате;
</p>
</li>
<li class="listitem">
<p>
запустите <code class="literal">dquilt add
<em class="replaceable"><code>файл-с-ошибкой</code></em></code> для объявления файла,
который должен быть изменён;
</p>
</li>
<li class="listitem">
<p>
исправьте ошибку в пакете исходного кода;
</p>
</li>
<li class="listitem">
<p>
запустите <code class="literal">dquilt refresh</code> для записи исправления в файл
<code class="filename"><em class="replaceable"><code>название-ошибки.patch</code></em></code>;
</p>
</li>
<li class="listitem">
<p>
запустите <code class="literal">dquilt header -e</code> для добавления её описания;
</p>
</li>
</ul>
</div>
</li>
<li class="listitem">
<p>
Если для исправления требуется обновление существующей заплаты, сделайте
следующее:
</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
запустите <code class="literal">dquilt pop <em class="replaceable"><code>foo.patch</code></em></code>
для того, чтобы откатить наложенную заплату
<code class="filename"><em class="replaceable"><code>foo.patch</code></em></code>;
</p>
</li>
<li class="listitem">
<p>
исправьте проблему в старой заплате
<code class="filename"><em class="replaceable"><code>foo.patch</code></em></code>;
</p>
</li>
<li class="listitem">
<p>
запустите <code class="literal">dquilt refresh</code> для обновления заплаты
<code class="filename"><em class="replaceable"><code>foo.patch</code></em></code>;
</p>
</li>
<li class="listitem">
<p>
запустите <code class="literal">dquilt header -e</code> для обновления её описания;
</p>
</li>
<li class="listitem">
<p>
запустите <code class="literal">while dquilt push; do dquilt refresh; done</code> для
применения всех заплат при удалении <span class="emphasis"><em>шероховатостей</em></span>;
</p>
</li>
</ul>
</div>
</li>
<li class="listitem">
<p>
Добавьте новую редакцию в начало файла Debian
<code class="filename">changelog</code>, например, с помощью <code class="literal">dch
-i</code> или вручную с помощью <code class="literal">dch -v
<em class="replaceable"><code>версия</code></em>-<em class="replaceable"><code>редакция</code></em></code>,
а затем добавьте комментарии с помощью текстового редактора <a href="#ftn.idp65089120" class="footnote" id="idp65089120"><sup class="footnote">[78]</sup></a>.
</p>
</li>
<li class="listitem">
<p>
Включите краткое описание ошибки и её решение в список изменений
(changelog), сопроводив текстом <code class="literal">Closes: #654321</code>. Это
позволит <span class="emphasis"><em>автомагически</em></span> закрыть сообщение об ошибке с
помощью программного обеспечения обслуживания архива в тот момент, когда ваш
пакет будет принят в архив Debian.
</p>
</li>
<li class="listitem">
<p>
Повторите то, что делали выше, для исправления других ошибок, обновляя файл
Debian <code class="filename">changelog</code> с помощью <code class="literal">dch</code> по
мере надобности.
</p>
</li>
<li class="listitem">
<p>
Повторите всё из <a class="xref" href="build.ru.html#completebuild" title="6.1. Полная (пере)сборка">Раздел 6.1, «Полная (пере)сборка»</a> и <a class="xref" href="checkit.ru.html" title="Глава 7. Проверка пакета на наличие ошибок">Глава 7, <em>Проверка пакета на наличие ошибок</em></a>.
</p>
</li>
<li class="listitem">
<p>
После проверки правильности, измените в <code class="filename">changelog</code> имя
выпуска с <code class="literal">UNRELEASED</code> на значение целевого дистрибутива
<code class="literal">unstable</code> (или даже на
<code class="literal">experimental</code>). <a href="#ftn.idp65099664" class="footnote" id="idp65099664"><sup class="footnote">[79]</sup></a>
</p>
</li>
<li class="listitem">
<p>
Закачайте пакет, следуя <a class="xref" href="upload.ru.html" title="Глава 9. Отправка пакета">Глава 9, <em>Отправка пакета</em></a>. На этот раз разница в том,
что не будет включён оригинальный архив исходного кода, поскольку он не
изменён и уже присутствует в архиве Debian.
</p>
</li>
</ul>
</div>
<p>
Стоит упомянуть одну хитрость на случай, когда вы делаете локальный пакет
для эксперимента с пакетированием и не отправляете эту версию в официальный
архив, например,
<code class="literal"><em class="replaceable"><code>1.0.1</code></em>-<em class="replaceable"><code>1</code></em></code>.
Для плавного обновления рекомендуется создать запись в
<code class="filename">changelog</code> со строкой версии вида
<code class="literal"><em class="replaceable"><code>1.0.1</code></em>-<em class="replaceable"><code>1~rc1</code></em></code>.
Вы можете не перегружать <code class="filename">changelog</code> записями о локальных
изменениях, объединяя их в одну для официального пакета. Об упорядочивании
версий строк смотрите <a class="xref" href="first.ru.html#namever" title="2.6. Имя и версия пакета">Раздел 2.6, «Имя и версия пакета»</a>.
</p>
<p>
</p>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="inspectnewupstream"/>8.2. Изучение нового авторского выпуска</h2>
</div>
</div>
</div>
<p>
При подготовке пакетов нового авторского выпуска для архива Debian, вы
должны сперва проверить новый авторский выпуск.
</p>
<p>
Начните с чтения файлов <code class="filename">changelog</code>,
<code class="filename">NEWS</code> и всей остальной документации, которая может
поставляться с новой версией.
</p>
<p>
Потом проверьте изменения между старым и новым исходным кодом программы, как
описано ниже, чтобы найти что-нибудь подозрительное:
</p>
<pre class="screen">
$ diff -urN <em class="replaceable"><code>foo</code></em>-<em class="replaceable"><code>старая-версия</code></em> <em class="replaceable"><code>foo</code></em>-<em class="replaceable"><code>новая-версия</code></em>
</pre>
<p>
На изменения в некоторых автоматически сгенерированных файлах Autotools,
таких как <code class="filename">missing</code>, <code class="filename">aclocal.m4</code>,
<code class="filename">config.guess</code>, <code class="filename">config.h.in</code>,
<code class="filename">config.sub</code>, <code class="filename">configure</code>,
<code class="filename">depcomp</code>, <code class="filename">install-sh</code>,
<code class="filename">ltmain.sh</code> и <code class="filename">Makefile.in</code>, можно не
обращать внимания. Вы можете удалить их перед запуском
<span class="command"><strong>diff</strong></span> для проверки исходного кода.
</p>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="newupstream"/>8.3. Новый авторский выпуск</h2>
</div>
</div>
</div>
<p>
Если пакет <code class="systemitem"><em class="replaceable"><code>foo</code></em></code> правильно собран
в новом формате <code class="literal">3.0 (native)</code> или <code class="literal">3.0
(quilt)</code>, то для подготовки пакета новой версии программы
достаточно переместить старый каталог <code class="filename">debian</code> в новый
исходный код. Это можно сделать запуском <code class="literal">tar xvzf
/<em class="replaceable"><code>путь</code></em>/<em class="replaceable"><code>к</code></em>/<em class="replaceable"><code>foo</code></em>_<em class="replaceable"><code>старая-версия</code></em>.debian.tar.gz</code>
в каталоге с новым исходным кодом <a href="#ftn.idp65127488" class="footnote" id="idp65127488"><sup class="footnote">[80]</sup></a>. Конечно, потребуется сделать несколько очевидных рутинных
операций:
</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
Скопируйте авторский исходный код в файл
<code class="filename">foo_<em class="replaceable"><code>новая-версия</code></em>.orig.tar.gz</code>.
</p>
</li>
<li class="listitem">
<p>
Обновите файл Debian <code class="filename">changelog</code> с помощью <code class="literal">dch
-v
<em class="replaceable"><code>новая-версия</code></em>-<em class="replaceable"><code>1</code></em></code>.
</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
Добавьте пометку <code class="literal">New upstream release</code>.
</p>
</li>
<li class="listitem">
<p>
Лаконично опишите изменения <span class="emphasis"><em>в новом авторском выпуске</em></span>,
которые исправляют найденные ошибки, и закройте эти ошибки, добавляя
<code class="literal">Closes: #<em class="replaceable"><code>номер_ошибки</code></em></code>.
</p>
</li>
<li class="listitem">
<p>
Лаконично опишите изменения <span class="emphasis"><em>в новом авторском выпуске</em></span>,
сделанные сопровождающим, которые исправляют найденные ошибки, и закройте
эти ошибки, добавляя <code class="literal">Closes:
#<em class="replaceable"><code>номер_ошибки</code></em></code>.
</p>
</li>
</ul>
</div>
</li>
<li class="listitem">
<p>
запустите <code class="literal">while dquilt push; do qduilt refresh; done</code> для
применения всех заплат при удалении <span class="emphasis"><em>шероховатостей</em></span>.
</p>
</li>
</ul>
</div>
<p>
Если наложение/слияние произошло с ошибками, изучите ситуацию (сведения есть
в файлах <code class="filename">.rej</code>).
</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
Если применяемая заплата к исходному коду была интегрирована в авторский
исходный код, то
</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
выполните <code class="literal">dquilt delete</code> для её удаления.
</p>
</li>
</ul>
</div>
</li>
<li class="listitem">
<p>
Если применяемая заплата к исходному коду конфликтует с новыми изменениями в
авторском исходном коде, то
</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
выполните <code class="literal">dquilt push -f</code> для наложения старых заплат с
отбрасыванием конфликтующих
<code class="filename"><em class="replaceable"><code>baz</code></em>.rej</code>.
</p>
</li>
<li class="listitem">
<p>
Исправьте файл <code class="filename"><em class="replaceable"><code>baz</code></em></code> ручным
копированием нужных строки из
<code class="filename"><em class="replaceable"><code>baz</code></em>.rej</code>.
</p>
</li>
<li class="listitem">
<p>
запустите <code class="literal">dquilt refresh</code> для обновления заплаты.
</p>
</li>
</ul>
</div>
</li>
<li class="listitem">
<p>
Продолжайте, как обычно, командой <code class="literal">while dquilt push; do dquilt
refresh; done</code>.
</p>
</li>
</ul>
</div>
<p>
Это может быть автоматизировано с помощью команды <span class="citerefentry"><span class="refentrytitle">uupdate</span>(1)</span>:
</p>
<pre class="screen">
$ apt-get source <em class="replaceable"><code>foo</code></em>
...
dpkg-source: info: extracting <em class="replaceable"><code>foo</code></em> in <em class="replaceable"><code>foo</code></em>-<em class="replaceable"><code>старая-версия</code></em>
dpkg-source: info: unpacking <em class="replaceable"><code>foo</code></em>_<em class="replaceable"><code>старая-версия</code></em>.orig.tar.gz
dpkg-source: info: applying <em class="replaceable"><code>foo</code></em>_<em class="replaceable"><code>старая-версия</code></em>-1.debian.tar.gz
$ ls -F
<em class="replaceable"><code>foo</code></em>-<em class="replaceable"><code>старая-версия</code></em>/
<em class="replaceable"><code>foo</code></em>_<em class="replaceable"><code>старая-версия</code></em>-1.debian.tar.gz
<em class="replaceable"><code>foo</code></em>_<em class="replaceable"><code>старая-версия</code></em>-1.dsc
<em class="replaceable"><code>foo</code></em>_<em class="replaceable"><code>старая-версия</code></em>.orig.tar.gz
$ wget http://example.org/<em class="replaceable"><code>foo</code></em>/<em class="replaceable"><code>foo</code></em>-<em class="replaceable"><code>новая-версия</code></em>.tar.gz
$ cd <em class="replaceable"><code>foo</code></em>-<em class="replaceable"><code>старая-версия</code></em>
$ uupdate -v <em class="replaceable"><code>новая-версия</code></em> ../<em class="replaceable"><code>foo</code></em>-<em class="replaceable"><code>новая-версия</code></em>.tar.gz
$ cd ../<em class="replaceable"><code>foo</code></em>-<em class="replaceable"><code>новая-версия</code></em>
$ while dquilt push; do dquilt refresh; done
$ dch
... описание проведённых изменений
</pre>
<p>
Если вы настроили файл <code class="filename">debian/watch</code> по описанию из
<a class="xref" href="dother.ru.html#watch" title="5.22. Файл watch">Раздел 5.22, «Файл <code class="filename">watch</code>»</a>, то можете пропустить команду
<span class="command"><strong>wget</strong></span>. Просто запустите <span class="citerefentry"><span class="refentrytitle">uscan</span>(1)</span> в каталоге
<code class="filename"><em class="replaceable"><code>foo</code></em>-<em class="replaceable"><code>старая-версия</code></em></code>
вместо команды <span class="command"><strong>uupdate</strong></span>. Она
<span class="emphasis"><em>автомагически</em></span> найдёт обновления исходного кода, скачает
его и запустит команду <span class="command"><strong>uupdate</strong></span> <a href="#ftn.idp65177360" class="footnote" id="idp65177360"><sup class="footnote">[81]</sup></a>.
</p>
<p>
Вы можете выпустить этот обновлённый исходный код, повторив то, что делали в
<a class="xref" href="build.ru.html#completebuild" title="6.1. Полная (пере)сборка">Раздел 6.1, «Полная (пере)сборка»</a>, <a class="xref" href="checkit.ru.html" title="Глава 7. Проверка пакета на наличие ошибок">Глава 7, <em>Проверка пакета на наличие ошибок</em></a> и <a class="xref" href="upload.ru.html" title="Глава 9. Отправка пакета">Глава 9, <em>Отправка пакета</em></a>.
</p>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="packagestyle"/>8.4. Обновление стиля пакетирования</h2>
</div>
</div>
</div>
<p>
При обновлении пакета обновлять стиль пакетирования необязательно. Но сделав
это, вы сможете полностью использовать возможности современной системы
<code class="systemitem">debhelper</code> и формата исходного кода
<code class="literal">3.0</code> <a href="#ftn.idp65185696" class="footnote" id="idp65185696"><sup class="footnote">[82]</sup></a>.
</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
Если по какой-то причине требуется пересоздать удалённые шаблоны файлов, вы
можете ещё раз запустить <span class="command"><strong>dh_make</strong></span> с параметром
<code class="literal">--addmissing</code> в том же дереве исходного кода пакета
Debian, а затем отредактировать их должным образом.
</p>
</li>
<li class="listitem">
<p>
Если в пакете файл <code class="filename">debian/rules</code> не переписан с
использованием команды <span class="command"><strong>dh</strong></span> из пакета <code class="systemitem">debhelper</code> v7+, то сделайте это. Обновите файл
<code class="filename">debian/control</code> соответствующим образом.
</p>
</li>
<li class="listitem">
<p>
Если вы хотите переписать файл <code class="filename">rules</code> с использованием
<span class="command"><strong>dh</strong></span>, в котором сейчас используется механизм включения
<code class="filename">Makefile</code> из Common Debian Build System (<code class="systemitem">cdbs</code>), то для понимания его переменных настройки
<code class="literal">DEB_*</code> смотрите следующие документы:
</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>локальная копия <code class="filename">/usr/share/doc/cdbs/cdbs-doc.pdf.gz</code></p>
</li>
<li class="listitem">
<p>
<a class="ulink" href="http://meetings-archive.debian.net/pub/debian-meetings/2009/fosdem/slides/The_Common_Debian_Build_System_CDBS/">The Common Debian Build System (CDBS), FOSDEM
2009</a>
</p>
</li>
</ul>
</div>
</li>
<li class="listitem">
<p>
Если у вас есть пакет исходного кода формата <code class="literal">1.0</code> без
файла <code class="filename"><em class="replaceable"><code>foo</code></em>.diff.gz</code>, вы можете
обновить его до нового формата исходного кода <code class="literal">3.0
(native)</code>, создав файл <code class="filename">debian/source/format</code> с
содержимым <code class="literal">3.0 (native)</code>. Остальные файлы
<code class="filename">debian/*</code> могут быть просто скопированы.
</p>
</li>
<li class="listitem">
<p>
Если у вас есть пакет с исходным кодом формата <code class="literal">1.0</code> с
файлом <code class="filename"><em class="replaceable"><code>foo</code></em>.diff.gz</code>, вы
можете обновить его до нового формата исходного кода <code class="literal">3.0
(quilt)</code>, создав файл <code class="filename">debian/source/format</code> с
содержимым <code class="literal">3.0 (quilt)</code>. Остальные файлы
<code class="filename">debian/*</code> могут быть просто скопированы. Если нужно,
импортируйте файл <code class="filename">big.diff</code>, полученный командой
<code class="literal">filterdiff -z -x '*/debian/*'
<em class="replaceable"><code>foo</code></em>.diff.gz > big.diff</code>, в вашу
систему <span class="command"><strong>quilt</strong></span> <a href="#ftn.idp65210480" class="footnote" id="idp65210480"><sup class="footnote">[83]</sup></a>.
</p>
</li>
<li class="listitem">
<p>
Если в пакете используется другая система заплат, например, <code class="systemitem">dpatch</code>, <code class="systemitem">dbs</code> или <code class="systemitem">cdbs</code> с параметром <code class="literal">-p0</code>,
<code class="literal">-p1</code> или <code class="literal">-p2</code>, перейдите на <code class="systemitem">quilt</code>, используя <code class="filename">deb3</code>, как
описано в <a class="ulink" href="http://bugs.debian.org/581186">http://bugs.debian.org/581186</a>.
</p>
</li>
<li class="listitem">
<p>
Если пакет был собран командой <span class="command"><strong>dh</strong></span> с параметром
<code class="literal">--with quilt</code> или командами
<span class="command"><strong>dh_quilt_patch</strong></span> и <span class="command"><strong>dh_quilt_unpatch</strong></span>,
уберите их и перейдите на использование нового формата пакетов исходного
кода <code class="literal">3.0 (quilt)</code>.
</p>
</li>
</ul>
</div>
<p>
Проверьте <a class="ulink" href="http://dep.debian.net/">DEP - Debian Enhancement Proposals</a> и
учтите ПРИНЯТЫЕ предложения.
</p>
<p>
Также вам нужно выполнить остальные задачи, описанные в <a class="xref" href="update.ru.html#newupstream" title="8.3. Новый авторский выпуск">Раздел 8.3, «Новый авторский выпуск»</a>.
</p>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="utf8"/>8.5. Преобразование в UTF-8</h2>
</div>
</div>
</div>
<p>
Если авторские документы поставляются в старых кодировках, лучше
преобразовать их в <a class="ulink" href="http://en.wikipedia.org/wiki/UTF-8">UTF-8</a>.
</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
Для перекодирования простых файлов используйте <span class="citerefentry"><span class="refentrytitle">iconv</span>(1)</span>.
</p>
<pre class="screen">
iconv -f latin1 -t utf8 <em class="replaceable"><code>foo_in.txt</code></em> > <em class="replaceable"><code>foo_out.txt</code></em>
</pre>
</li>
<li class="listitem">
<p>
Для перекодирования файлов HTML в простой текст в кодировке UTF-8
используйте <span class="citerefentry"><span class="refentrytitle">w3m</span>(1)</span>. Выполнение данной операции должно
проводиться при включённой локали UTF-8.
</p>
<pre class="screen">
LC_ALL=en_US.UTF-8 w3m -o display_charset=UTF-8 \
-cols 70 -dump -no-graph -T text/html \
< <em class="replaceable"><code>foo_in.html</code></em> > <em class="replaceable"><code>foo_out.txt</code></em>
</pre>
</li>
</ul>
</div>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="reminders"/>8.6. Замечания по обновлению пакетов</h2>
</div>
</div>
</div>
<p>
Вот несколько замечаний по обновлению пакетов:
</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
Не удаляйте старые записи из <code class="filename">changelog</code> (на первый
взгляд это очевидно, но были случаи случайного набора <code class="literal">dch</code>
вместо <code class="literal">dch -i</code>).
</p>
</li>
<li class="listitem">
<p>
Существующие изменения Debian должны быть пересмотрены; выбросьте
инструментарий, который включил автор (в той или иной форме) и не забудьте
оставить инструментарий, который не был включён автором, пока не появится
убедительной причины этого не делать.
</p>
</li>
<li class="listitem">
<p>
Если в систему для сборки были внесены изменения (к счастью, вы узнаете об
этом при изучении авторских изменений), то при необходимости обновите
сборочные зависимости в файлах <code class="filename">debian/rules</code> и
<code class="filename">debian/control</code>.
</p>
</li>
<li class="listitem">
<p>
Проверьте <a class="ulink" href="http://www.debian.org/Bugs/">систему отслеживания ошибок (BTS)</a> на
случай, если кто-нибудь предоставил заплаты для исправления незакрытых
ошибок.
</p>
</li>
<li class="listitem">
<p>
Проверьте содержимое файла <code class="filename">.changes</code> и убедитесь, что вы
выполняете отправку в правильный дистрибутив, закрываемые ошибки перечислены
в поле <code class="literal">Closes</code>, поля <code class="literal">Maintainer</code> и
<code class="literal">Changed-By</code> совпадают, файл подписан GPG и т. д.
</p>
</li>
</ul>
</div>
</div>
<div class="footnotes">
<br/>
<hr/>
<div id="ftn.idp65089120" class="footnote">
<p><a href="#idp65089120" class="para"><sup class="para">[78] </sup></a>Дату в нужном формате можно получить с помощью команды <code class="literal">LANG=C date
-R</code>.
</p>
</div>
<div id="ftn.idp65099664" class="footnote">
<p><a href="#idp65099664" class="para"><sup class="para">[79] </sup></a>Если для выполнения изменения вы используете команду <code class="literal">dch
-r</code>, то убедитесь, что записали файл <code class="filename">changelog</code>
именно редактором.</p>
</div>
<div id="ftn.idp65127488" class="footnote">
<p><a href="#idp65127488" class="para"><sup class="para">[80] </sup></a> Если пакет <code class="systemitem"><em class="replaceable"><code>foo</code></em></code> собран в старом
формате <code class="literal">1.0</code>, то вместо этого можно запустить
<code class="literal">zcat
/<em class="replaceable"><code>путь</code></em>/<em class="replaceable"><code>к</code></em>/<em class="replaceable"><code>foo</code></em>_<em class="replaceable"><code>старая-версия</code></em>.diff.gz|patch
-p1</code> в каталоге с новым исходным кодом. </p>
</div>
<div id="ftn.idp65177360" class="footnote">
<p><a href="#idp65177360" class="para"><sup class="para">[81] </sup></a> Если команда <span class="command"><strong>uscan</strong></span> скачает обновлённый исходный код, но
не запустит команду <span class="command"><strong>uupdate</strong></span>, исправьте файл
<code class="filename">debian/watch</code> таким образом, чтобы упоминание
<code class="literal">debian uupdate</code> было в конце URL. </p>
</div>
<div id="ftn.idp65185696" class="footnote">
<p><a href="#idp65185696" class="para"><sup class="para">[82] </sup></a> Не стоит беспокоиться или спорить, если ваш поручитель или другие
сопровождающие возражают против обновления существующего стиля
пакетирования. Есть более важные вещи. </p>
</div>
<div id="ftn.idp65210480" class="footnote">
<p><a href="#idp65210480" class="para"><sup class="para">[83] </sup></a>
Вы можете разделить файл <code class="filename">big.diff</code> на много маленьких
приращиваемых заплат с помощью команды <span class="command"><strong>splitdiff</strong></span>. </p>
</div>
</div>
</div>
<div class="navfooter">
<hr/>
<table width="100%" summary="Navigation footer">
<tr>
<td align="left"><a accesskey="p" href="checkit.ru.html"><img src="images/prev.png" alt="Пред."/></a> </td>
<td align="center"> </td>
<td align="right"> <a accesskey="n" href="upload.ru.html"><img src="images/next.png" alt="След."/></a></td>
</tr>
<tr>
<td align="left" valign="top">Глава 7. Проверка пакета на наличие ошибок </td>
<td align="center">
<a accesskey="h" href="index.ru.html">
<img src="images/home.png" alt="Начало"/>
</a>
</td>
<td align="right" valign="top"> Глава 9. Отправка пакета</td>
</tr>
</table>
</div>
</body>
</html>
|