chiark / gitweb /
po4a: pairwise-pocheck: Better handling for missing tcl
[dgit.git] / po4a / dgit-maint-native_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: textblock
49 #: ../dgit-user.7.pod:449 ../dgit-maint-native.7.pod:128
50 #: ../dgit-maint-merge.7.pod:493 ../dgit-maint-gbp.7.pod:138
51 msgid "dgit(1), dgit(7)"
52 msgstr ""
53
54 #. type: textblock
55 #: ../dgit-maint-native.7.pod:3
56 msgid "dgit - tutorial for package maintainers of Debian-native packages"
57 msgstr ""
58
59 #. type: textblock
60 #: ../dgit-maint-native.7.pod:7
61 msgid ""
62 "This document describes elements of a workflow for using B<dgit> to maintain "
63 "a Debian package that uses one of the native source formats (\"1.0\" & \"3.0 "
64 "(native)\")."
65 msgstr ""
66
67 #. type: textblock
68 #: ../dgit-maint-native.7.pod:15
69 msgid "We expect that your git history is fast-forwarding."
70 msgstr ""
71
72 #. type: textblock
73 #: ../dgit-maint-native.7.pod:19
74 msgid ""
75 "You should be prepared to tolerate a small amount of ugliness in your git "
76 "history in the form of merges which stitch the dgit-generated archive view "
77 "into your maintainer history."
78 msgstr ""
79
80 #. type: textblock
81 #: ../dgit-maint-native.7.pod:25
82 msgid ""
83 "This is to handle uploads that were not made with dgit, such as the uploads "
84 "you made before switching to this workflow, or NMUs."
85 msgstr ""
86
87 #. type: =head2
88 #: ../dgit-maint-native.7.pod:31
89 msgid "Benefits"
90 msgstr ""
91
92 #. type: textblock
93 #: ../dgit-maint-native.7.pod:37 ../dgit-maint-gbp.7.pod:16
94 #: ../dgit-maint-debrebase.7.pod:38
95 msgid ""
96 "Benefit from dgit's safety catches.  In particular, ensure that your upload "
97 "always matches exactly your git HEAD."
98 msgstr ""
99
100 #. type: textblock
101 #: ../dgit-maint-native.7.pod:42
102 msgid "Provide a better, more detailed history to downstream dgit users."
103 msgstr ""
104
105 #. type: textblock
106 #: ../dgit-maint-native.7.pod:48
107 msgid "Incorporate an NMU with one command."
108 msgstr ""
109
110 #. type: =head1
111 #: ../dgit-maint-native.7.pod:52
112 msgid "FIRST PUSH WITH DGIT"
113 msgstr ""
114
115 #. type: textblock
116 #: ../dgit-maint-native.7.pod:54
117 msgid "You do not need to do anything special to your tree to push with dgit."
118 msgstr ""
119
120 #. type: textblock
121 #: ../dgit-maint-native.7.pod:57
122 msgid "Simply prepare your git tree in the usual way, and then:"
123 msgstr ""
124
125 #. type: verbatim
126 #: ../dgit-maint-native.7.pod:61
127 #, no-wrap
128 msgid ""
129 "    % dgit -wgf sbuild -A -c sid\n"
130 "    % dgit -wgf --overwrite push\n"
131 "\n"
132 msgstr ""
133
134 #. type: textblock
135 #: ../dgit-maint-native.7.pod:66
136 msgid "(Do not make any tags yourself: dgit push will do that.)"
137 msgstr ""
138
139 #. type: textblock
140 #: ../dgit-maint-native.7.pod:68
141 msgid ""
142 "You may use B<dgit pbuilder> or B<dgit cowbuilder> instead of B<dgit "
143 "sbuild>; see dgit(1) for the syntax of those subcommands."
144 msgstr ""
145
146 #. type: textblock
147 #: ../dgit-maint-native.7.pod:72
148 msgid ""
149 "The --overwrite option tells dgit that you are expecting that your git "
150 "history is not a descendant of the history which dgit synthesised from the "
151 "previous non-dgit uploads."
152 msgstr ""
153
154 #. type: textblock
155 #: ../dgit-maint-native.7.pod:77
156 msgid ""
157 "dgit will make a merge commit on your branch but without making any code "
158 "changes (ie, a pseudo-merge)  so that your history, which will be pushed to "
159 "the dgit git server, is fast forward from the dgit archive view."
160 msgstr ""
161
162 #. type: textblock
163 #: ../dgit-maint-native.7.pod:85
164 msgid ""
165 "Alternatively, if this was the first ever dgit push of the package, you can "
166 "avoid this merge commit by passing C<--deliberately-not-fast-forward>.  "
167 "instead of C<--overwrite>.  This avoids introducing a new origin commit into "
168 "your git history."
169 msgstr ""
170
171 #. type: =head1
172 #: ../dgit-maint-native.7.pod:93
173 msgid "SUBSEQUENT PUSHES"
174 msgstr ""
175
176 #. type: verbatim
177 #: ../dgit-maint-native.7.pod:97
178 #, no-wrap
179 msgid ""
180 "    % dgit -wgf push\n"
181 "\n"
182 msgstr ""
183
184 #. type: textblock
185 #: ../dgit-maint-native.7.pod:101 ../dgit-maint-native.7.pod:111
186 msgid "That's it."
187 msgstr ""
188
189 #. type: =head1
190 #: ../dgit-maint-native.7.pod:103
191 msgid "INCORPORATING AN NMU"
192 msgstr ""
193
194 #. type: verbatim
195 #: ../dgit-maint-native.7.pod:107 ../dgit-maint-merge.7.pod:484
196 #, no-wrap
197 msgid ""
198 "    % dgit pull\n"
199 "\n"
200 msgstr ""
201
202 #. type: textblock
203 #: ../dgit-maint-native.7.pod:113
204 msgid "Or, if you would prefer to review the changes, you can do this:"
205 msgstr ""
206
207 #. type: verbatim
208 #: ../dgit-maint-native.7.pod:118
209 #, no-wrap
210 msgid ""
211 "    % dgit fetch\n"
212 "    % dgit diff HEAD..dgit/dgit/sid\n"
213 "\n"
214 msgstr ""
215
216 #. type: textblock
217 #: ../dgit-maint-native.7.pod:123
218 msgid ""
219 "If you do not merge the NMU into your own git history, the next push will "
220 "then require I<--overwrite>."
221 msgstr ""