po4a/dgit-maint-gbp_7.pot

   1 # SOME DESCRIPTIVE TITLE
   2 # Copyright (C) YEAR Free Software Foundation, Inc.
   3 # This file is distributed under the same license as the PACKAGE package.
   4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
   5 #
   6 #, fuzzy
   7 msgid ""
   8 msgstr ""
   9 "Project-Id-Version: PACKAGE VERSION\n"
  10 "POT-Creation-Date: 2018-10-04 01:04+0100\n"
  11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=UTF-8\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 #. type: =head1
  20 #: ../dgit.1:3 ../dgit.7:2 ../dgit-user.7.pod:1 ../dgit-nmu-simple.7.pod:1
  21 #: ../dgit-maint-native.7.pod:1 ../dgit-maint-merge.7.pod:1
  22 #: ../dgit-maint-gbp.7.pod:1 ../dgit-maint-debrebase.7.pod:1
  23 #: ../dgit-downstream-dsc.7.pod:1 ../dgit-sponsorship.7.pod:1
  24 #: ../git-debrebase.1.pod:1 ../git-debrebase.5.pod:1
  25 #, no-wrap
  26 msgid "NAME"
  27 msgstr ""
  28
  29 #. type: =head1
  30 #: ../dgit.1:1394 ../dgit.7:23 ../dgit-user.7.pod:447
  31 #: ../dgit-nmu-simple.7.pod:137 ../dgit-maint-native.7.pod:126
  32 #: ../dgit-maint-merge.7.pod:491 ../dgit-maint-gbp.7.pod:136
  33 #: ../dgit-maint-debrebase.7.pod:722 ../dgit-downstream-dsc.7.pod:352
  34 #: ../dgit-sponsorship.7.pod:321 ../git-debrebase.1.pod:601
  35 #: ../git-debrebase.5.pod:678
  36 #, no-wrap
  37 msgid "SEE ALSO"
  38 msgstr ""
  39
  40 #. type: =head1
  41 #: ../dgit-user.7.pod:5 ../dgit-maint-native.7.pod:5
  42 #: ../dgit-maint-merge.7.pod:5 ../dgit-maint-gbp.7.pod:5
  43 #: ../dgit-maint-debrebase.7.pod:5 ../dgit-downstream-dsc.7.pod:5
  44 #: ../git-debrebase.1.pod:10 ../git-debrebase.5.pod:5
  45 msgid "INTRODUCTION"
  46 msgstr ""
  47
  48 #. type: =head1
  49 #: ../dgit-user.7.pod:222 ../dgit-maint-gbp.7.pod:56
  50 msgid "BUILDING"
  51 msgstr ""
  52
  53 #. type: textblock
  54 #: ../dgit-user.7.pod:449 ../dgit-maint-native.7.pod:128
  55 #: ../dgit-maint-merge.7.pod:493 ../dgit-maint-gbp.7.pod:138
  56 msgid "dgit(1), dgit(7)"
  57 msgstr ""
  58
  59 #. type: textblock
  60 #: ../dgit-maint-native.7.pod:37 ../dgit-maint-gbp.7.pod:16
  61 #: ../dgit-maint-debrebase.7.pod:38
  62 msgid ""
  63 "Benefit from dgit's safety catches.  In particular, ensure that your upload "
  64 "always matches exactly your git HEAD."
  65 msgstr ""
  66
  67 #. type: =head1
  68 #: ../dgit-maint-merge.7.pod:480 ../dgit-maint-gbp.7.pod:130
  69 #: ../dgit-maint-debrebase.7.pod:526
  70 msgid "INCORPORATING NMUS"
  71 msgstr ""
  72
  73 #. type: =head1
  74 #: ../dgit-maint-merge.7.pod:495 ../dgit-maint-gbp.7.pod:140
  75 #: ../dgit-maint-debrebase.7.pod:726
  76 msgid "AUTHOR"
  77 msgstr ""
  78
  79 #. type: textblock
  80 #: ../dgit-maint-gbp.7.pod:3
  81 msgid ""
  82 "dgit - tutorial for package maintainers already using git-buildpackage(1)"
  83 msgstr ""
  84
  85 #. type: textblock
  86 #: ../dgit-maint-gbp.7.pod:7
  87 msgid ""
  88 "This document explains how B<dgit> can be incorporated into a git-"
  89 "buildpackage(1) package-maintenance workflow.  This should be read jointly "
  90 "with git-buildpackage(1)'s documentation.  Some reasons why you might want "
  91 "to incorporate B<dgit> into your existing workflow:"
  92 msgstr ""
  93
  94 #. type: textblock
  95 #: ../dgit-maint-gbp.7.pod:21
  96 msgid ""
  97 "Provide a better, more detailed git history to downstream dgit users, such "
  98 "as people using dgit to do an NMU (see dgit-nmu-simple(7) and dgit-user(7))."
  99 msgstr ""
 100
 101 #. type: textblock
 102 #: ../dgit-maint-gbp.7.pod:27
 103 msgid ""
 104 "Note that we assume a patches-unapplied repository: the upstream source "
 105 "committed to the git repository is unpatched.  git-buildpackage(1) can work "
 106 "with patched-applied repositories, but is normally used with patches-"
 107 "unapplied."
 108 msgstr ""
 109
 110 #. type: =head1
 111 #: ../dgit-maint-gbp.7.pod:32 ../dgit-maint-debrebase.7.pod:293
 112 msgid "GIT CONFIGURATION"
 113 msgstr ""
 114
 115 #. type: textblock
 116 #: ../dgit-maint-gbp.7.pod:34
 117 msgid ""
 118 "If you have configured an I<export-dir> in your gbp.conf, you should tell "
 119 "dgit about it:"
 120 msgstr ""
 121
 122 #. type: verbatim
 123 #: ../dgit-maint-gbp.7.pod:39
 124 #, no-wrap
 125 msgid ""
 126 "    % git config --global dgit.default.build-products-dir /home/spwhitton/build-area\n"
 127 "\n"
 128 msgstr ""
 129
 130 #. type: textblock
 131 #: ../dgit-maint-gbp.7.pod:43
 132 msgid "If you run"
 133 msgstr ""
 134
 135 #. type: verbatim
 136 #: ../dgit-maint-gbp.7.pod:47
 137 #, no-wrap
 138 msgid ""
 139 "    % git config dgit.default.quilt-mode gbp\n"
 140 "\n"
 141 msgstr ""
 142
 143 #. type: textblock
 144 #: ../dgit-maint-gbp.7.pod:51
 145 msgid "in your repository, you can omit I<--gbp> wherever it occurs below."
 146 msgstr ""
 147
 148 #. type: textblock
 149 #: ../dgit-maint-gbp.7.pod:53
 150 msgid ""
 151 "Note that this does require that you always work from your gbp master "
 152 "branch, never the dgit patches-applied branch."
 153 msgstr ""
 154
 155 #. type: textblock
 156 #: ../dgit-maint-gbp.7.pod:58
 157 msgid "You can perform test builds like this:"
 158 msgstr ""
 159
 160 #. type: verbatim
 161 #: ../dgit-maint-gbp.7.pod:62
 162 #, no-wrap
 163 msgid ""
 164 "    % dgit [--include-dirty] gbp-build [OPTIONS]\n"
 165 "\n"
 166 msgstr ""
 167
 168 #. type: textblock
 169 #: ../dgit-maint-gbp.7.pod:66
 170 msgid ""
 171 "where I<--include-dirty> is needed for testing uncommitted changes, and "
 172 "I<OPTIONS> are any further options to be passed on to gbp-buildpackage(1)."
 173 msgstr ""
 174
 175 #. type: textblock
 176 #: ../dgit-maint-gbp.7.pod:70
 177 msgid ""
 178 "If you are doing a source-only upload, you do not need to prepare a "
 179 "I<_source.changes>, as B<dgit push-source> will take of that on your behalf."
 180 msgstr ""
 181
 182 #. type: textblock
 183 #: ../dgit-maint-gbp.7.pod:74
 184 msgid ""
 185 "If you need to include binaries with your upload, you will probably want to "
 186 "use sbuild(1), pbuilder(1) or cowbuilder(1):"
 187 msgstr ""
 188
 189 #. type: verbatim
 190 #: ../dgit-maint-gbp.7.pod:79
 191 #, no-wrap
 192 msgid ""
 193 "    % dgit --rm-old-changes --gbp sbuild\n"
 194 "\n"
 195 msgstr ""
 196
 197 #. type: textblock
 198 #: ../dgit-maint-gbp.7.pod:83
 199 msgid "replacing 'sbuild' with 'pbuilder' or 'cowbuilder' if appropriate."
 200 msgstr ""
 201
 202 #. type: textblock
 203 #: ../dgit-maint-gbp.7.pod:85
 204 msgid ""
 205 "We use I<--rm-old-changes> to ensure that there is exactly one changes file "
 206 "corresponding to this package, so we can be confident we're uploading what "
 207 "we intend (though B<dgit push> will do some safety checks)."
 208 msgstr ""
 209
 210 #. type: textblock
 211 #: ../dgit-maint-gbp.7.pod:90
 212 msgid ""
 213 "Note that none of the commands in this section are required to upload with "
 214 "dgit.  You can invoke gbp-buildpackage(1), pbuilder(1), cowbuilder(1) and "
 215 "sbuild(1) directly.  However, the defaults for these tools may leave you "
 216 "with something that dgit will refuse to upload because it doesn't match your "
 217 "git HEAD."
 218 msgstr ""
 219
 220 #. type: textblock
 221 #: ../dgit-maint-gbp.7.pod:96
 222 msgid "As a general rule, leave all signing and tagging to dgit."
 223 msgstr ""
 224
 225 #. type: =head1
 226 #: ../dgit-maint-gbp.7.pod:98
 227 msgid "UPLOADING"
 228 msgstr ""
 229
 230 #. type: textblock
 231 #: ../dgit-maint-gbp.7.pod:100
 232 msgid ""
 233 "Don't use I<--git-tag>: B<dgit push> will do this for you.  To do a source-"
 234 "only upload:"
 235 msgstr ""
 236
 237 #. type: verbatim
 238 #: ../dgit-maint-gbp.7.pod:105
 239 #, no-wrap
 240 msgid ""
 241 "    % dgit --gbp push-source\n"
 242 "\n"
 243 msgstr ""
 244
 245 #. type: textblock
 246 #: ../dgit-maint-gbp.7.pod:109
 247 msgid "or if you need to include binaries,"
 248 msgstr ""
 249
 250 #. type: verbatim
 251 #: ../dgit-maint-gbp.7.pod:113 ../dgit-sponsorship.7.pod:173
 252 #, no-wrap
 253 msgid ""
 254 "    % dgit --gbp push\n"
 255 "\n"
 256 msgstr ""
 257
 258 #. type: textblock
 259 #: ../dgit-maint-gbp.7.pod:117
 260 msgid ""
 261 "This will push your git history to the dgit-repos, but you probably want to "
 262 "follow it up with a push to salsa."
 263 msgstr ""
 264
 265 #. type: textblock
 266 #: ../dgit-maint-gbp.7.pod:120
 267 msgid ""
 268 "You will need to pass I<--overwrite> if the previous upload was not "
 269 "performed with dgit."
 270 msgstr ""
 271
 272 #. type: textblock
 273 #: ../dgit-maint-gbp.7.pod:123
 274 msgid ""
 275 "If this is first ever dgit push of the package, consider passing I<--"
 276 "deliberately-not-fast-forward> instead of I<--overwrite>.  This avoids "
 277 "introducing a new origin commit into the dgit view of your git history.  "
 278 "(This origin commit would represent the most recent non-dgit upload of the "
 279 "package, but this should already be represented in your git history.)"
 280 msgstr ""
 281
 282 #. type: textblock
 283 #: ../dgit-maint-gbp.7.pod:132
 284 msgid ""
 285 "B<dgit pull> can't yet incorporate NMUs into patches-unapplied gbp "
 286 "branches.  You can just apply the NMU diff the traditional way.  The next "
 287 "upload will require I<--overwrite>."
 288 msgstr ""
 289
 290 #. type: textblock
 291 #: ../dgit-maint-gbp.7.pod:142
 292 msgid ""
 293 "This tutorial was written and is maintained by Sean Whitton "
 294 "<spwhitton@spwhitton.name>."
 295 msgstr ""