~bzr-pqm/bzr/bzr.dev

6 by mbp at sourcefrog
import all docs from arch
1
I think Ruby's point is right: we need to think about how a tool
2
*feels* as you're using it.
3
4
Making regular commits gives a nice rhythm to to working; in some
5
ways it's nicer to just commit single files with C-x v v than to build
6
complex changesets.  (See gmane.c.v-c.arch.devel post 19 Nov, Tom
7
Lord.)
8
9
10
* Would like to generate an activity report, to e.g. mail to your boss
11
  or post to your blog.  "What did I change today, across all these
12
  specified branches?"
13
14
15
* It is possibly nice that tla by default forbids you from committing
16
  if emacs autosave or lock files exist -- I find it confusing to
17
  commit somethin other than what is shown in the editor window
18
  because there are unsaved changes. 
19
20
  However, grumbling about unknown files is annoying, and requiring
21
  people to edit regexps in the id-tagging-method file to fix it is
22
  totally unreasonable.
23
24
  Perhaps there should be a preference to abort on unknown files, or
25
  perhaps it should be possible to specify forbidden files.
26
27
  Perhaps this is related to a mechanism to detect conflicted files:
28
  should refuse to commit if there are any .rej files lying around.
29
30
31
32
   *Those who lose history are doomed to recreate it.*
33
         -- broked (on #gnu.arch.users)
34
35
   *A universal convention supplies all of maintainability, clarity, consistency, and a foundation for good programming habits too. What it doesn't do is insist that you follow it against your will. That's Python!*
36
37
    -- Tim Peters on comp.lang.python, 2001-06-16
38
39
    (Bazaar provides mechanism and convention, but it is up to you
40
    whether you wish to follow or enforce that convention.)
41
42
----
43
44
jblack asks for 
45
46
   A way to subtract merges, so that you can see the work you've done
47
   to a branch since conception.
48
49
----
50
51
:: 
52
53
  <mpool> now that is a neat idea: advertise branches over zeroconf
54
  <mpool> should make lca fun :-)
55
56
----
57
58
http://thedailywtf.com/ShowPost.aspx?PostID=24281
59
60
  Source control is necessary and useful, but in a team of one (or even two) people the setup overhead isn't always worth it--especially if you're going to join source control in a month, and you don't want to have to migrate everything out of your existing (in my case, skunkworks) system before you can use it.
61
62
  At least that was my experience--I putzed with CVS a bit and knew other source control systems pretty well, but in the day-to-day it wasn't worth the bother (granted, I was a bit offended at having to wait to use the mainline source control, but that's another matter).
63
64
I think Bazaar-NG will have such low setup overhead (just ``init``,
65
``add``) that it can be easily used for even tiny projects.  The
66
ability to merge previously-unrelated trees means they can fold their
67
project in later.
68
69
70
----
71
72
From tridge:
73
74
* cope without $EMAIL better
75
76
* notes at start of .bzr.log:
77
  * you can delete this
78
  * or include it in bug reports
79
80
* should you be able to remove things from the default ignore list?
81
82
* headers at start of diff, giving some comments, perhaps dates
83
 
84
  * is diff against /dev/null really OK?  I think so.
85
86
* separate remove/delete commands?  
87
88
* detect files which were removed and now in 'missing' state
89
90
* should we actually compare files for 'status', or check mtime and
91
  size; reading every file in the samba source tree can take a long
92
  time.
93
94
  without this, doing a status on a large tree can be very slow.  but
95
  relying on mtime/size is a bit dangerous.
96
97
  people really do work on trees which take a large chunk of memory
98
  and which will not stay in memory
99
100
* status up-to-date files: not 'U', and don't list without --all
101
102
* if status does compare file text, then it should be quick when
103
  checking just a single file
104
105
* wrapper for svn that every time run logs
106
107
  - command
108
  - all inputs
109
  - time it took
110
  - sufficient to replay everything
111
  - record all files
112
113
* status crashes if a file is missing
114
115
* option for -p1 level on diff, etc.  perhaps
116
117
* commit without message should start $EDITOR
118
119
* don't duplicate all files on commit
120
121
* start importing tridge-junkcode
122
123
* perhaps need xdelta storage sooner rather than later, to handle very
124
  large file
125
126
----
127
128
The first operation most people do with a new version-control system
129
is *not* making their own project, but rather getting a checkout of an
130
existing project, building it, and possibly submitting a patch.  So
131
those operations should be *extremely* easy.
132
133
----
134
135
* Way to check that a branch is fully merged, and no longer needed:
136
  should mean all its changes have been integrated upstream, no
137
  uncommitted changes or rejects or unknown files.
138
139
* Filter revisions by containing a particular word (as for log).
140
  Perhaps have key-value fields that might be used for
141
  e.g. line-of-development or bug nr?
142
143
* List difference in the revisions on one branch vs another.
144
145
* Perhaps use a partially-readable but still hopefully unique ID for
146
  revisions/inventories?
147
148
* Preview what will happen in a merge before it is applied
149
150
* When a changeset deletes a file, should have the option to just make
151
  it unknown/ignored.
152
153
  Perhaps this is best handled by an interactive merge.  If the file
154
  is unchanged locally and deleted remotely, it will by default be
155
  deleted (but the user has the option to reject the delete, or to
156
  make it just unversioned, or to save a copy.)  If it is modified
157
  locall then the user still needs to choose between those options but
158
  there is no default (or perhaps the default is to reject the delete.)
159
160
* interactive commit, prompting whether each hunk should be sent (as
161
  for darcs)
162
163
* Write up something about detection of unmodified files
164
165
* Preview a merge so as to get some idea what will happen:
166
167
  * What revisions will be merged (log entries, etc)
168
169
  * What files will be affected?
170
171
  * Are those simple updates, or have they been updated locally as
172
    well.
173
174
  * Any renames or metadata clashes?
175
176
  * Show diffs or conflict markers.
177
178
  * Do the merge, but write into a second directory.
179
180
* "Show me all changesets that touch this file"
181
182
  Can be done by walking back through all revisions, and filtering out
183
  those where the file-id either gets a new name or a new text.  
184
185
* Way to commit backdated revisions or pretend to be something by
186
  someone else, for the benefit of import tools; in general allow
187
  everything taken from the current environment to be overridden.
188
189
* Cope well when trying to checkout or update over a flaky
190
  connection.  Passive HTTP possibly helps with this: we can fetch all
191
  the file texts first, then the inventory, and can even retry
192
  interrupted connections.
193
194
* Use readline for reading log messages, and store a history of
195
  previous commit messages!
196
36 by Martin Pool
doc
197
* Warn when adding huge files(?) - more than say 10MB?  On the other
198
  hand, why not just cope?
199
42 by Martin Pool
human-assigned revision ids?
200
* Perhaps allow people to specify a revision-id, much as people have
201
  unique but human-assigned names for patches at the moment?
202
6 by mbp at sourcefrog
import all docs from arch
203
----
204
205
20050218090900.GA2071@opteron.random
206
207
    Subject:      Re: [darcs-users] Re: [BK] upgrade will be needed
208
    From:         Andrea Arcangeli <andrea@suse.de>
209
    Newsgroups:   gmane.linux.kernel
210
    Date:         Fri, 18 Feb 2005 10:09:00 +0100
211
212
    On Thu, Feb 17, 2005 at 06:24:53PM -0800, Tupshin Harper wrote:
213
    > small to medium sized ones). Last I checked, Arch was still too slow in 
214
    > some areas, though that might have changed in recent months. Also, many 
215
216
    IMHO someone needs to rewrite ARCH using the RCS or SCCS format for the
217
    backend and a single file for the changesets and with sane parameters
218
    conventions miming SVN. The internal algorithms of arch seems the most
219
    advanced possible. It's just the interface and the fs backend that's so
220
    bad and doesn't compress in the backups either.  SVN bsddb doesn't
221
    compress either by default, but at least the new fsfs compresses pretty
222
    well, not as good as CVS, but not as badly as bsddb and arch either.
223
224
    I may be completely wrong, so take the above just as a humble
225
    suggestion.
226
227
    darcs scares me a bit because it's in haskell, I don't believe very much
228
    in functional languages for compute intensive stuff, ram utilization
229
    skyrockets sometime (I wouldn't like to need >1G of ram to manage the
230
    tree). Other languages like python or perl are much slower than C/C++
231
    too but at least ram utilization can be normally dominated to sane
232
    levels with them and they can be greatly optimized easily with C/C++
233
    extensions of the performance critical parts.
234
52 by mbp at sourcefrog
fixup doctest for new module structure
235
236
-----
237
197 by mbp at sourcefrog
notes from kernel discussion
238
When sending patches by email (optionall) send each one as a separate
239
mail, with a sequence number [%03d/%03d] at the start of the Subject.
240
See mail from linus 2005-04-07.
241
242
http://linux.yyz.us/patch-format.html
243
244
http://www.zip.com.au/~akpm/linux/patches/stuff/tpp.txt
245
246
----
247
248
dwmw2 (2005-04-07) 
249
250
reorder patches by cherry-picking them from a main development tree
251
before sending them on.
241 by mbp at sourcefrog
- Add more ignore patterns
252
253
----
254
255
ignore BitKeeper
256
257
re-add should give the same id as before