This file is indexed.

/usr/share/doc/ubuntu-packaging-guide-html-fr/udd-merging.html is in ubuntu-packaging-guide-html-fr 0.3.6.

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
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
    <title>9. Fusion — Mise à jour à partir de Debian et de l’Amont &mdash; Ubuntu Packaging Guide</title>
    <link rel="shortcut icon" href="./_static/images/favicon.ico" type="image/x-icon" />
    <link rel="stylesheet" href="./_static/reset.css" type="text/css" />
    <link rel="stylesheet" href="./_static/960.css" type="text/css" />
    <link rel="stylesheet" href="./_static/base.css" type="text/css" />
    <link rel="stylesheet" href="./_static/home.css" type="text/css" />
    <link rel="stylesheet" href="./_static/pygments.css" type="text/css" />
    <link rel="stylesheet" href="./_static/guide.css" type="text/css" />
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '../',
        VERSION:     '0.3.6',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
      };
    </script>
    <script type="text/javascript" src="./_static/jquery.js"></script>
    <script type="text/javascript" src="./_static/underscore.js"></script>
    <script type="text/javascript" src="./_static/doctools.js"></script>
    <script type="text/javascript" src="./_static/translations.js"></script>
    
    <script type="text/javascript" src="./_static/main.js"></script>
    <link rel="top" title="Ubuntu Packaging Guide" href="./index.html" />
    <link rel="next" title="10. Utilisation des environnements Chroots" href="chroots.html" />
    <link rel="prev" title="8. Obtention des dernières nouveautés" href="udd-latest.html" /> 
  </head>
  <body class="home">
  <a name="top"></a>

<div class="header-navigation">
    <div>
      <nav role="navigation">
        <ul>
          <li class="page_item current_page_item"><a title="Contenu" href="index.html">Contenu</a>
          <li>
            <form id="form-search" method="get" action="search.html">
              <fieldset>
                <input id="input-search" type="text" name="q" value="Search" />
              </fieldset>
            </form>
          </li>
        </ul>
      </nav>
      <a class="logo-ubuntu" href="http://packaging.ubuntu.com/">
        <img src="./_static/images/logo-ubuntu.png" width="119" height="27" alt="Ubuntu logo" />
      </a>
      <a href="http://packaging.ubuntu.com/"><h2>Packaging Guide</h2></a>
    </div>
  </div>
<div class="header-content">
    <div class="clearfix">
  <div class="header-navigation-secondary">
    <div>
          <nav role="navigation">
            <ul class="clearfix">
	        <li class="page_item"><a style="margin-right: 10px" 
	        href="chroots.html" title="10. Utilisation des environnements Chroots"
	        accesskey="N">suivant</a></li>
	        <li class="page_item"><a  
	        href="udd-latest.html" title="8. Obtention des dernières nouveautés"
	        accesskey="P">précédent</a></li>
        <li class="page_item"><a class="sub-nav-item" href="index.html">Ubuntu Packaging Guide  &raquo;</a></li> 
      </ul>
    </nav>
  </div>
</div>
</div>
</div>
  
<div id="content" class="body container_12">
  <div class="grid_12">  

     <!--<section id="main-section">-->

    <div class="grid_9 alpha">
		
    
  <div class="section" id="merging-updating-from-debian-and-upstream">
<h1>9. Fusion — Mise à jour à partir de Debian et de l&#8217;Amont<a class="headerlink" href="#merging-updating-from-debian-and-upstream" title="Lien permanent vers ce titre"></a></h1>
<p>La fusion est l&#8217;un des points forts de Bazaar, et fréquemment utilisée dans le développement Ubuntu. Les mises à jour peuvent fusionner depuis Debian, depuis une nouvelle version de l&#8217;amont, ou depuis d&#8217;autres développeurs Ubuntu. Réaliser cela dans Bazaar est assez simple, et entièrement basé sur la commande <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">merge</span></tt> <a class="footnote-reference" href="#id3" id="id1">[1]</a>.</p>
<p>Lorsque vous êtes dans n&#8217;importe quel répertoire de travail d&#8217;une branche, vous pouvez fusionner une branche depuis un emplacement différent. Vérifiez tout d&#8217;abord que vous n&#8217;avez pas de modifications non validées&nbsp;:</p>
<div class="highlight-python"><div class="highlight"><pre>$ bzr status
</pre></div>
</div>
<p>Si cela signale quelque chose, vous devrez soit soumettre les modifications, les inverser ou les classer pour y revenir ultérieurement.</p>
<div class="section" id="merging-from-debian">
<h2>9.1. Fusion depuis Debian<a class="headerlink" href="#merging-from-debian" title="Lien permanent vers ce titre"></a></h2>
<p>Exécutez ensuite <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">merge</span></tt> en donnant l&#8217;URL de la branche à partir de laquelle fusionner. Par exemple, pour fusionner depuis la version du paquet dans Debian Unstable, lancez <a class="footnote-reference" href="#id4" id="id2">[2]</a>&nbsp;:</p>
<div class="highlight-python"><div class="highlight"><pre>$ bzr merge lp:debian/tomboy
</pre></div>
</div>
<p>Cela fusionnera les modifications depuis le dernier point de fusion et vous laissera avec les modifications à revoir. Cela pourrait engendrer quelques conflits. Vous pouvez voir tout ce que la commande <tt class="docutils literal"><span class="pre">merge</span></tt> a réalisé en exécutant&nbsp;:</p>
<div class="highlight-python"><div class="highlight"><pre>$ bzr status
$ bzr diff
</pre></div>
</div>
<p>Si des conflits sont signalés alors vous devrez éditer ces fichiers pour les faire paraître comme ils devraient, en supprimant les <em>marqueurs de conflit</em>. Une fois que vous l&#8217;avez fait, exécutez&nbsp;:</p>
<div class="highlight-python"><div class="highlight"><pre>$ bzr resolve
$ bzr conflicts
</pre></div>
</div>
<p>Ceci permet de résoudre tout conflit de fichier que vous avez corrigé, et vous indique ensuite ce qu&#8217;il vous reste à traiter.</p>
<p>Une fois que tous les conflits sont résolus, et que vous avez effectué toutes les autres modifications nécessaires, ajoutez une nouvelle entrée au changelog, et soumettez&nbsp;:</p>
<div class="highlight-python"><div class="highlight"><pre>$ dch -i
$ bzr commit
</pre></div>
</div>
<p>comme décrit précédemment.</p>
<p>Toutefois, avant de soumettre, il est toujours bon de vérifier toutes les modifications d&#8217;Ubuntu en exécutant&nbsp;:</p>
<div class="highlight-python"><div class="highlight"><pre>$ bzr diff -r tag:0.6.10-5
</pre></div>
</div>
<p>qui montre les différences entre les versions Debian (0.6.10-5) et Ubuntu (0.6.10-5ubuntu1). D&#8217;une manière similaire, vous pouvez comparer chacune des autres versions. Pour voir toutes les versions disponibles, exécutez&nbsp;:</p>
<div class="highlight-python"><div class="highlight"><pre>$ bzr tags
</pre></div>
</div>
<p>Après avoir testé et soumis votre fusion, vous devrez rechercher un parrainage ou télécharger vers l&#8217;archive de la manière habituelle.</p>
<p>Si vous êtes sur le point de construire le paquet source depuis cette branche fusionnée, vous devez utiliser l&#8217;option <tt class="docutils literal"><span class="pre">-S</span></tt> à la commande <tt class="docutils literal"><span class="pre">bd</span></tt>. Vous devez également prendre en considération l&#8217;utilisation de l&#8217;option <tt class="docutils literal"><span class="pre">--package-merge</span></tt>. Cela ajoutera le cas échéant les options <tt class="docutils literal"><span class="pre">-v</span></tt> et <tt class="docutils literal"><span class="pre">-sa</span></tt> au paquet source, de telle sorte que toutes les entrées du changelog depuis la dernière modification Ubuntu seront incluses dans votre fichier <tt class="docutils literal"><span class="pre">_source.changes</span></tt>. Par exemple&nbsp;:</p>
<div class="highlight-python"><div class="highlight"><pre>$ bzr builddeb -S --package-merge
</pre></div>
</div>
</div>
<div class="section" id="merging-a-new-upstream-version">
<h2>9.2. Fusion d&#8217;une nouvelle version de l&#8217;amont<a class="headerlink" href="#merging-a-new-upstream-version" title="Lien permanent vers ce titre"></a></h2>
<p>Lorsque l&#8217;amont livre une nouvelle version (ou si vous souhaitez empaqueter un instantané), vous devez fusionner une archive dans votre branche.</p>
<p>Ceci est réalisé en utilisant la commande <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">merge-upstream</span></tt>. Si votre paquet possède un fichier <tt class="docutils literal"><span class="pre">debian/watch</span></tt> valide, depuis l&#8217;intérieur de la branche que vous souhaitez fusionner, tapez simplement&nbsp;:</p>
<div class="highlight-python"><div class="highlight"><pre>$ bzr merge-upstream
</pre></div>
</div>
<p>Cela va télécharger l&#8217;archive et la fusionner à votre branche, vous ajoutant automatiquement une entrée <tt class="docutils literal"><span class="pre">debian/changelog</span></tt> pour vous. <tt class="docutils literal"><span class="pre">bzr-builddeb</span></tt> inspecte le fichier <tt class="docutils literal"><span class="pre">debian/watch</span></tt> pour localiser l’archive de l&#8217;amont.</p>
<p>Si vous <em>n&#8217;avez pas</em> de fichier <tt class="docutils literal"><span class="pre">debian/watch</span></tt>, vous devez spécifier manuellement la localisation de l&#8217;archive de l&#8217;amont, et sa version&nbsp;:</p>
<div class="highlight-python"><div class="highlight"><pre>$ bzr merge-upstream --version 1.2 http://example.org/releases/foo-1.2.tar.gz
</pre></div>
</div>
<p>L&#8217;option <tt class="docutils literal"><span class="pre">--version</span></tt> est utilisée pour spécifier la version de l&#8217;amont qui est en cours de fusion, puisque la commande n&#8217;est pas (encore) capable de la déduire.</p>
<p>Le dernier paramètre est l&#8217;emplacement de l&#8217;archive que vous mettez à niveau&nbsp;; cela peut être soit un chemin du système de fichiers local, soit une URI http, ftp, sftp, etc. comme indiqué. La commande va vous télécharger automatiquement l&#8217;archive. Elle sera renommée convenablement et, si nécessaire, convertie en <tt class="docutils literal"><span class="pre">.gz</span></tt>.</p>
<p>La commande <cite>merge-upstream</cite> va vous indiquer sa réussite ou si il y a eu des conflits. De toute façon, vous serez en mesure d&#8217;examiner les modifications avant la soumission habituelle.</p>
<p>Si vous fusionnez une version amont dans une branche Bazaar existante qui n&#8217;a pas antérieurement utilisé le format UDD, <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">merge-upstream</span></tt> va échouer avec une erreur indiquant que la balise de la version précédente de l&#8217;amont n&#8217;est pas disponible&nbsp;; la fusion ne peut être terminée sans connaître la version de base pour la fusion. Pour contourner ce problème, créez une balise dans votre dépôt existant pour la dernière version de l&#8217;amont présente ici&nbsp;; par exemple, si la dernière version Ubuntu est <em>1.1-0ubuntu3</em>, créer la balise <em>upstream-1.1</em> pointant vers la révision bzr que vous voulez utiliser comme la pointe de la branche amont.</p>
<table class="docutils footnote" frame="void" id="id3" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td><p class="first last">Vous aurez besoin des dernières version de <tt class="docutils literal"><span class="pre">bzr</span></tt> et de <tt class="docutils literal"><span class="pre">bzr-builddeb</span></tt> pour que la commande <tt class="docutils literal"><span class="pre">merge</span></tt> fonctionne. Utilisez les versions d&#8217;Ubuntu 12.04 (Precise) ou les versions de développement depuis le PPA <tt class="docutils literal"><span class="pre">bzr</span></tt>. Spécifiquement, vous prendrez <tt class="docutils literal"><span class="pre">bzr</span></tt> version 2.5 beta 5 ou plus récent et <tt class="docutils literal"><span class="pre">bzr-builddeb</span></tt> version 2.8.1 ou plus récent. Pour les versions plus anciennes, utilisez plutôt la commande <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">merge-package</span></tt>.</p>
</td></tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="id4" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id2">[2]</a></td><td><p class="first last">Pour vérifier les autres branches disponibles d&#8217;un paquet dans Debian, voir la page de code du paquet. Par exemple, <a class="reference external" href="https://code.launchpad.net/debian/+source/tomboy">https://code.launchpad.net/debian/+source/tomboy</a></p>
</td></tr>
</tbody>
</table>
</div>
</div>


	<div class="divide"></div>

          </div>

  <div id="sidebar" class="grid_3 omega">
    <div class="container-tweet">
        <h3>Table des Matières</h3>
        <div class="toc">
          <ul>
<li><a class="reference internal" href="#">9. Fusion — Mise à jour à partir de Debian et de l&#8217;Amont</a><ul>
<li><a class="reference internal" href="#merging-from-debian">9.1. Fusion depuis Debian</a></li>
<li><a class="reference internal" href="#merging-a-new-upstream-version">9.2. Fusion d&#8217;une nouvelle version de l&#8217;amont</a></li>
</ul>
</li>
</ul>

        </div>

      <div class="browse-guide">
        <h3>Browse The Guide:</h3>
        <ul>
          <li class="prev">
            <a href="udd-latest.html"
                      title="Sujet précédent: 8. Obtention des dernières nouveautés">Go Previous</a>
          </li>
          
          <li class="center">
            <a title="Back to Index" href="index.html">Index Guide</a>
          </li>
        
          <li class="next">
            <a href="chroots.html"
                      title="Sujet suivant: 10. Utilisation des environnements Chroots">Go Next</a>
          </li>
        </ul>
        <span>Cette page:</span> <a href="./_sources/udd-merging.txt"
               rel="nofollow">Montrer la source</a>
      </div>
     </div>
     <div id="back_top"><a href="#top">Back to Top</a></div>
    </div>
    <!--</section>-->
  </div>
</div>
<div class="shadow"></div>
<footer>
  <div>
      Version: 0.3.6.
    <a href="https://bugs.launchpad.net/ubuntu-packaging-guide">Report bugs</a> or 
    <a href="https://code.launchpad.net/~ubuntu-packaging-guide-team/ubuntu-packaging-guide/trunk">grab the source code</a> from Launchpad.
      Créé avec <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.3.
      <br />
        &copy; Copyright 2010-2014 , Ubuntu Developers, Creative Commons Attribution-ShareAlike 3.0.
        <a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/">
        Creative Commons Attribution-ShareAlike 3.0 Unported License</a>.
        <a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/">
        <img alt="Creative Commons License" style="border-width:0" 
        src="./_static/images/cc-by-sa.png" /></a>
    <br />
    <a href="http://people.ubuntu.com/~mitya57/ubuntu-packaging-guide-readme.html#translating">Help translate</a> or
    <a href="./_static/translators.html">view the list of translators</a>.

  </div>
</footer>
  </body>
</html>