~ubuntu-branches/ubuntu/vivid/debian-policy/vivid-proposed

« back to all changes in this revision

Viewing changes to README.html

  • Committer: Bazaar Package Importer
  • Author(s): Russ Allbery, Colin Watson, Bill Allombert, Russ Allbery
  • Date: 2010-06-27 21:40:52 UTC
  • mfrom: (4.1.5 sid)
  • Revision ID: james.westby@ubuntu.com-20100627214052-2kfi11r55u6hk2jq
[ Colin Watson ]
* Fix path to changelog.Debian.gz in footnote on documentation symlinks.

[ Bill Allombert ]
* Convert upgrading-checklist to debiandoc-sgml. This generates a better
  looking .txt file.
  Closes: #567845
* Fix typo in package_upstream-version.orig.tar.gz.
  Thanks, Salvatore Bonaccorso. (Closes: #558430)
* Replace 'copyright and distribution license' by 'copyright information
  and distribution license' (three times).
  Proposed by Jonathan Nieder.
  Seconded:  Steve Langasek  <vorlon@debian.org>
  Seconded:  Thijs Kinkhorst <thijs@debian.org>
  Seconded:  Julien Cristau  <jcristau@debian.org>
  Seconded:  Gregor Herrmann <gregoa@debian.org>
  Closes: #566220
* extend UID range of user accounts by removing the 30000-59999 reserved 
  ranges.
  Proposed by Santiago Vila  
  Seconded:  Russ Allbery    <rra@debian.org>
  Seconded:  Luk Claes       <luk@debian.org>
  Seconded:  Raphael Hertzog <hertzog@debian.org>
  Seconded:  Steve Langasek  <vorlon@debian.org>
  Closes: #582495

[ Russ Allbery ]
* Policy: Overhaul Breaks, Conflicts, Provides, and Replaces
  Wording: Russ Allbery <rra@debian.org>
  Seconded: Steve Langasek <vorlon@debian.org>
  Seconded: Raphael Hertzog <hertzog@debian.org>
  Closes: #578854
* Policy: Support for architecture wildcards
  Wording: Manoj Srivastava <srivasta@debian.org>
  Wording: Russ Allbery <rra@debian.org>
  Seconded: Guillem Jover <guillem@debian.org>
  Seconded: Andrew McMillan <andrew@morphoss.com>
  Seconded: Steve Langasek <vorlon@debian.org>
  Closes: #530687
* Policy: Except init.d scripts from the normal set -e requirement
  Wording: Russ Allbery <rra@debian.org>
  Seconded: Raphael Hertzog <hertzog@debian.org>
  Seconded: Guillem Jover <guillem@debian.org>
  Closes: #562506
* Policy: Maintainer scripts might not have a controlling terminal
  Wording: Russ Allbery <rra@debian.org>
  Seconded: Guillem Jover <guillem@debian.org>
  Seconded: Andrew McMillan <andrew@morphoss.com>
  Seconded: Steve Langasek <vorlon@debian.org>
  Closes: #224509
* Policy: Fully specify the date format for changelog entries
  Wording: Charles Plessy <plessy@debian.org>
  Seconded: Russ Allbery <rra@debian.org>
  Seconded: Andrew McMillan <andrew@morphoss.com>
  Seconded: Giacomo A. Catenazzi <cate@debian.org>
  Closes: #569174
* Policy: Deprecate /usr/share/common-licenses/BSD
  Wording: Russ Allbery <rra@debian.org>
  Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
  Seconded: Jakub Wilk <jwilk@debian.org>
  Seconded: gregor herrmann <gregoa@debian.org>
  Closes: #284340
* Policy: Document Checksums-Sha1 and Checksums-Sha256
  Wording: Russ Allbery <rra@stanford.edu>
  Seconded: Julien Cristau <jcristau@debian.org>
  Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
  Closes: #478295
* Policy: Prohibit duplicate field names in a control paragraph
  Wording: Russ Allbery <rra@debian.org>
  Seconded: Charles Plessy <plessy@debian.org>
  Seconded: Steve Langasek <vorlon@debian.org>
  Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
  Closes: #555978
* Policy: Relax requirement that library dev files be in one package
  Wording: Russ Allbery <rra@debian.org>
  Seconded: Julien Cristau <jcristau@debian.org>
  Seconded: Andrew McMillan <andrew@morphoss.com>
  Closes: #347581
* Policy: Tighten requirements for maintainer-like fields
  Wording: Russ Allbery <rra@debian.org>
  Seconded: Emilio Pozuelo Monfort <pochu@debian.org>
  Seconded: Andrew McMillan <andrew@morphoss.com>
  Closes: #575639
* Policy: Update Format control field documentation
  Wording: Russ Allbery <rra@debian.org>
  Wording: Charles Plessy <plessy@debian.org>
  Seconded: Charles Plessy <plessy@debian.org>
  Seconded: Emilio Pozuelo Monfort <pochu27@gmail.com>
  Closes: #547272
* Debconf: Add SETTITLE, like title but uses a template
  Wording: Frans Pop <elendil@planet.nl>
  Seconded: Russ Allbery <rra@debian.org>
  Seconded: Ben Pfaff <blp@cs.stanford.edu>
  Closes: #560411
* Perl Policy: Change perlapi provides to use an ABI version
  Wording: Niko Tyni <ntyni@debian.org>
  Seconded: Russ Allbery <rra@debian.org>
  Seconded: Brendan O'Dea <bod@debian.org>
  Seconded: Damyan Ivanov <dmn@debian.org>
  Closes: #579457
* Perl Policy: Recommend DESTDIR instead of PREFIX with Makefile.PL
  Wording: Niko Tyni <ntyni@debian.org>
  Seconded: Russ Allbery <rra@debian.org>
  Seconded: Raphael Hertzog <hertzog@debian.org>
  Closes: #579461
* Standardize dpkg state wording and bring it in line with dpkg,
  renaming Failed-Config to Half-Configured and use uniform
  capitalization and punctuation.  (Closes: #442134)
* Remove documentation of alternative changelog formats.  This feature
  is not allowed in the Debian archive and will be documented in the
  dpkg-dev documentation instead.  The documentation that was in Policy
  was also somewhat outdated.  (Closes: #555009, see #584141)
* Remove obsolete footnote sentence saying that dpkg-statoverride is a
  new feature and not well-known.  (Closes: #563425)
* Clarify in the Perl Policy that perl-base is essential, not perl, and
  don't imply packages need to depend on perl-base.  (Closes: #576594)
* Document the special debian-installer section in the list of current
  sections and add a link to the list of sections in unstable, which
  contains longer descriptions.  (Closes: #577666)
* Remove the footnote listing every architecture known to dpkg.  This
  list can be trivially produced by dpkg-architecture -L (already
  noted), is very long, and quickly becomes out-of-date.
* Move silly version ordering example to a footnote.  (Closes: #560839)
* Reletter the process steps to not skip State C and use more
  traditional foreground and background colors for Process.html and
  README.html.  (Closes: #584521)
* Fix typo in footnote about help2man.  (Closes: #584796)
* Add an example for Replaces when a package is split.  Thanks, Uwe
  Kleine-König.  (Closes: #572253)
* Explicitly state that packages may remove unmodified, obsolete
  configuration files during  upgrade.  (Closes: #470633)
* Clarify the wording around which build dependencies must be satisfied
  for different debian/rules targets and add a footnote to the
  description of the build-arch and build-indep targets explaining why
  this split does not currently work as desired.  (Closes: #328951)
* Avoid "Debianised" or "Debianized" in favor of just "Debian" or
  "Debian package" as appropriate.  Patch from Ben Finney.
  (Closes: #586163)
* Switch to source format 3.0 (native).

Show diffs side-by-side

added added

removed removed

Lines of Context:
4
4
<html xmlns="http://www.w3.org/1999/xhtml"
5
5
lang="en" xml:lang="en">
6
6
<head>
7
 
<div style="text-align:right;font-size:70%;white-space:nowrap;">
8
 
 <a accesskey="h" href="http://www.debian.org/"> UP </a>
9
 
 |
10
 
 <a accesskey="H" href="http://wiki.debian.org/Teams/Policy"> HOME </a>
11
 
</div>
12
 
 
13
7
<title>Debian Policy</title>
14
8
<meta http-equiv="Content-Type" content="text/html;charset=utf-8"/>
15
9
<meta name="generator" content="Org-mode"/>
16
 
<meta name="generated" content="2009-10-05 00:20:29 CDT"/>
 
10
<meta name="generated" content="2010-06-04 09:42:57 PDT"/>
17
11
<meta name="author" content="Manoj Srivastava And Russ Allbery"/>
18
12
<meta name="description" content=""/>
19
13
<meta name="keywords" content=""/>
43
37
                                 font-weight:bold; }
44
38
 
45
39
  body {
46
 
   color: DarkSlateGrey;
47
 
   background-color: gainsboro;
 
40
   color: black;
 
41
   background-color: white;
48
42
   font-family: Palatino, "Palatino Linotype", "Hoefler Text", "Times New Roman", Times, Georgia, Utopia, serif;
49
43
  }
50
44
  .org-agenda-date          { color: #87cefa;    }
58
52
    font-weight: bold;
59
53
  }
60
54
 
61
 
  a {
62
 
    color: inherit;
63
 
    background-color: inherit;
64
 
    font: inherit;
65
 
    text-decoration: inherit;
66
 
  }
67
55
  a:hover { text-decoration: underline; }
68
56
  .todo  { font-weight:bold; }
69
57
  .done { font-weight:bold; }
120
108
</head>
121
109
<body>
122
110
<div id="content">
 
111
<div id="org-div-home-and-up" style="text-align:right;font-size:70%;white-space:nowrap;">
 
112
 <a accesskey="h" href="http://www.debian.org/"> UP </a>
 
113
 |
 
114
 <a accesskey="H" href="http://wiki.debian.org/Teams/Policy"> HOME </a>
 
115
</div>
 
116
 
123
117
<h1 class="title">Debian Policy</h1>
124
118
 
125
119
 
158
152
 
159
153
</div>
160
154
 
161
 
<div id="outline-container-1.1" class="outline-3">
162
 
<h3 id="sec-1.1">Interacting with the team </h3>
163
 
<div class="outline-text-3" id="text-1.1">
 
155
<div id="outline-container-1_1" class="outline-3">
 
156
<h3 id="sec-1_1">Interacting with the team </h3>
 
157
<div class="outline-text-3" id="text-1_1">
164
158
 
165
159
 
166
160
<ul>
223
217
 
224
218
 
225
219
 
226
 
 
227
220
<p>
228
221
&lt;local-branch-name&gt; is some convenient name designating your local
229
222
changes. You may want to use some common prefix like local-. You can
400
393
 
401
394
</div>
402
395
 
403
 
<div id="outline-container-4.1" class="outline-3">
404
 
<h3 id="sec-4.1">Maintenance procedures </h3>
405
 
<div class="outline-text-3" id="text-4.1">
406
 
 
407
 
 
408
 
</div>
409
 
 
410
 
</div>
411
 
 
412
 
<div id="outline-container-4.2" class="outline-3">
413
 
<h3 id="sec-4.2">Repository layout </h3>
414
 
<div class="outline-text-3" id="text-4.2">
 
396
<div id="outline-container-4_1" class="outline-3">
 
397
<h3 id="sec-4_1">Maintenance procedures </h3>
 
398
<div class="outline-text-3" id="text-4_1">
 
399
 
 
400
 
 
401
</div>
 
402
 
 
403
</div>
 
404
 
 
405
<div id="outline-container-4_2" class="outline-3">
 
406
<h3 id="sec-4_2">Repository layout </h3>
 
407
<div class="outline-text-3" id="text-4_2">
415
408
 
416
409
 
417
410
<p>
436
429
 
437
430
</div>
438
431
 
439
 
<div id="outline-container-4.3" class="outline-3">
440
 
<h3 id="sec-4.3">Managing a bug </h3>
441
 
<div class="outline-text-3" id="text-4.3">
 
432
<div id="outline-container-4_3" class="outline-3">
 
433
<h3 id="sec-4_3">Managing a bug </h3>
 
434
<div class="outline-text-3" id="text-4_3">
442
435
 
443
436
 
444
437
<p>
521
514
 
522
515
 
523
516
 
524
 
 
525
517
<p>
526
518
For the debian/changelog entry, use the following format:
527
519
</p>
536
528
 
537
529
 
538
530
 
539
 
 
540
531
<p>
541
532
For example:
542
533
</p>
552
543
 
553
544
 
554
545
 
555
 
 
556
 
</div>
557
 
 
558
 
</div>
559
 
 
560
 
<div id="outline-container-4.4" class="outline-3">
561
 
<h3 id="sec-4.4">Updating branches </h3>
562
 
<div class="outline-text-3" id="text-4.4">
 
546
</div>
 
547
 
 
548
</div>
 
549
 
 
550
<div id="outline-container-4_4" class="outline-3">
 
551
<h3 id="sec-4_4">Updating branches </h3>
 
552
<div class="outline-text-3" id="text-4_4">
563
553
 
564
554
 
565
555
<p>
581
571
 
582
572
 
583
573
 
584
 
 
585
574
<p>
586
575
assuming that you haven't packed the refs in your repository.
587
576
</p>
589
578
 
590
579
</div>
591
580
 
592
 
<div id="outline-container-4.5" class="outline-3">
593
 
<h3 id="sec-4.5">Making a release </h3>
594
 
<div class="outline-text-3" id="text-4.5">
 
581
<div id="outline-container-4_5" class="outline-3">
 
582
<h3 id="sec-4_5">Making a release </h3>
 
583
<div class="outline-text-3" id="text-4_5">
595
584
 
596
585
 
597
586
<p>
615
604
 
616
605
 
617
606
 
618
 
 
619
607
<p>
620
608
replacing the version number with the version of the release, of course.
621
609
</p>
628
616
 
629
617
</div>
630
618
 
631
 
<div id="outline-container-4.6" class="outline-3">
632
 
<h3 id="sec-4.6">Setting release goals </h3>
633
 
<div class="outline-text-3" id="text-4.6">
 
619
<div id="outline-container-4_6" class="outline-3">
 
620
<h3 id="sec-4_6">Setting release goals </h3>
 
621
<div class="outline-text-3" id="text-4_6">
634
622
 
635
623
 
636
624
<p>
681
669
</div>
682
670
<div id="postamble">
683
671
<p class="author"> Author: Manoj Srivastava And Russ Allbery
684
 
<a href="mailto:srivasta@debian.org">&lt;srivasta@debian.org&gt;</a>
685
672
</p>
686
 
<p class="date"> Date: 2009-10-05 00:20:29 CDT</p>
687
 
<p class="creator">HTML generated by org-mode 6.31trans in emacs 23</p>
 
673
<p class="date"> Date: 2010-06-04 09:42:57 PDT</p>
 
674
<p class="creator">HTML generated by org-mode 6.36c in emacs 23</p>
688
675
</div>
689
676
</div>
690
677
</body>