/[meta-cvs]/meta-cvs/F-B3689DBB46386B16F4B2331934B69223
ViewVC logotype

Contents of /meta-cvs/F-B3689DBB46386B16F4B2331934B69223

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.127.2.3 - (show annotations)
Sat Oct 12 22:32:23 2002 UTC (11 years, 6 months ago) by kaz
Branch: mcvs-1-0-branch
Changes since 1.127.2.2: +4 -0 lines
* code/mcvs-main.lisp (*update-options*): Added -C option.

* code/update.lisp (mcvs-update): Fall back on the mcvs-generic
if --metaonly or --nometa is specified to run CVS on specific
files.
1 Release Notes for Meta-CVS
2
3 Release 0.98, 2002-10-??:
4
5 Debug tracing shows command execution.
6
7 The filt command does not filter F- names if they are immediately preceded by
8 the MCVS/ prefix; such occurences are clearly concrete, sandbox-relative
9 references to the actual F- links, rather than abstract references.
10
11 The update command now supports the -C option, to fetch the repository
12 copy, throwing away local changes. It also now honors the --metaonly
13 and --nometa options.
14
15 Release 0.97, 2002-10-06:
16
17 Meta-CVS now builds and runs on Microsoft Windows, under Cygwin
18 (www.cygwin.com). It still relies on hard links, which requires
19 Windows 2000 or XP, and the NTFS filesystem. It probably won't
20 work over FAT.
21
22 New --debug option for verbose output.
23
24 Cleaned up of error messages. Error messages don't specify prefixes like
25 ``mcvs-add:'' or ``mcvs-grab:'' any more. Rather, the error handler adds the
26 ``mcvs:'' prefix when printing the messages in a situation when the error is
27 not continuable.
28
29 Fixed bug introduced in release 0.13: mcvs add -R was adding only
30 directories, effectively ignoring arguments that are regular files.
31 The error-continuation behavior of mcvs add has been revised.
32
33 Trying to rename an object onto itself, or to move the sandbox root
34 directory are no longer silent no-ops, but produce an error.
35
36 The remap command now preserves property lists, and picks up changes
37 in executable permission.
38
39 The grab command now notices when a file changes from having execute
40 permission to not having execute permission.
41
42 Operations on the path . now work in a partial sandbox.
43
44 Release 0.96, 2002-09-21:
45
46 The restore command was left broken during the change to the new
47 filemap format. It is now fixed.
48
49 The grab command now handles execute permission bits properly.
50
51 Some more commands have detailed help.
52
53 There is now a global option -i which specifies a script to be
54 executed. This allows Meta-CVS to be scripted using Lisp. For
55 instance suppose you have the following script and call it
56 list-matching:
57
58 #!/usr/local/bin/mcvs -i
59 (in-sandbox-root-dir
60 (let ((mapping (mapping-read *mcvs-map*))
61 (test-func (eval (read-from-string (pop *args*)))))
62 (dolist (entry mapping)
63 (with-slots (path raw-plist) entry
64 (when (funcall test-func raw-plist)
65 (format t "~a~%" path))))))
66
67 Then to list the names of files whose "importance" property is
68 a value greater than two, run:
69
70 ./list-matching '(lambda (plist)
71 (let ((imp (getf plist :importance)))
72 (and imp (> imp 2))))'
73
74 WARNING: Scripting accesses the guts of Meta-CVS directly, so scripts may
75 break as Meta-CVS is maintained. There is currently no published set of
76 stable interfaces.
77
78 Release 0.95, 2002-09-16:
79
80 The install.sh script no longer uses a borrowed copy of the clisp-link script
81 or the linkkit directory; these have been removed. These materials
82 are available at every CLISP installation; install.sh now finds them
83 and uses them. Users of non-x86 machines ran into problems because of this
84 because linkkit/clisp.h contains architecture-dependent information.
85
86 A bug in mcvs filt was fixed; it wasn't handling F- names that aren't found
87 in the map.
88
89 A more detailed help system now exists, though it's not complete. The ``mcvs
90 help'' command acts just like ``mcvs --help'' without any arguments. If given
91 an additional parameter which specifies a Meta-CVS command, it produces more
92 detailed documentation for that comand. Help exists already for a few
93 commands.
94
95 The release number is being warped to 0.95, which means that Meta-CVS is now
96 in beta. It is only five updates away from a 1.0 release.
97
98 Release 0.24, 2002-09-08:
99
100 The mapping entries for both symlinks and files have extensible property
101 lists now. These are stored in the optional fourth and fifth list elements,
102 respectively of the :FILE and :SYMLINK map entries.
103
104 Versioning of the execute permission of files is supported, represented as
105 the :EXEC property of a :FILE mapping entry.
106
107 Some lame syntax is provided for manipulating properties:
108
109 mcvs prop --set foo --clear bar --remove baz main.c list.c
110
111 will set the property FOO to true, set the property BAR to false,
112 and remove the property BAZ, in the files main.c and list.c.
113 The execute permission is represented by the property EXEC.
114
115 Release 0.23, 2002-09-02:
116
117 Bugfix: the grab command notices edited symlinks and incorporates the
118 changes into the mapping.
119
120 The grab command now figures out moved symlinks. Moved symlinks are those
121 whose pathname has changed, but which continue to point to the same object
122 (which may also have been moved).
123
124 Release 0.22, 2002-08-31:
125
126 Symbolic links are now versioned objects. The format of the MAP file
127 changes to accomodate this; the new Meta-CVS will read old MAP
128 files; when it writes it will write the new format. Old Meta-CVS won't
129 read the new format.
130
131 When a new module is created from an existing file tree, symbolic
132 links will be recognized and added. The add command will also add
133 symbolic links. Symbolic links can be renamed and moved; this does
134 nothing with their contents. They can point outside of the sandbox
135 using relative or absolute paths.
136
137 TODO:
138
139 There doesn't exist yet a special command to create symbolic links, nor to
140 retarget them; retargetting a link can be done manually by editing MCVS/MAP
141 and updating. Retargetting a link using the ln -s command, won't
142 backpropagate to the MAP file; an update will clobber the link.
143
144 The grab command does not yet compute symbolic link moves; a moved symbolic
145 link is treated as a remove and add. This will be easy to fix.
146
147 The remap command ignores symlinks.
148
149 Release 0.21, 2002-08-04:
150
151 Syntax of grab command changed. The branch is no longer specified as an
152 argument, but using the -r command option. If no revision is specified with
153 -r, then a -A must be specified to make the grab go to the main trunk. This
154 is a safety feature, since grabbing foreign snapshots to the trunk is almost
155 always wrong, though it could be useful during backup recovery, or for fixing
156 mistakes.
157
158 The way operating system functions are targetted has changed. Instead of
159 relying on the ``linuxlibc6'' module provided by CLISP, Meta-CVS now
160 has its own module for calling foreign functions. This module is portable;
161 it does not depend on the layout of glibc data structures. So Meta-CVS
162 is in theory now portable to other Unixes (provided they have /dev/urandom).
163
164 Release 0.20, 2002-07-27:
165
166 The commit command does a true global commit when given no file or directory
167 parameters, and not given the --metaonly option. This means commiting all
168 changes in the MCVS directory, even if they are in F-files that are not
169 currently mapped.
170
171 Release 0.19, 2002-07-16:
172
173 When moving multiple files or directories to a subdirectory, a
174 restart is now provided to skip over bad ones and continue.
175
176 Grab no longer scans files if there are only added files, or only removed
177 files. There are no moves to deduce in that case.
178
179 Restore properly creates lost+found at the root of a partial sandbox,
180 rather than at the abstract root of the module.
181
182 Some other algorithmic improvements made.
183
184 The first few sections of a user guide have been written.
185
186 Release 0.18, 2002-07-07:
187
188 Cool new feature: checkout takes an extra argument, which specifies a
189 subdirectory of the project. Specifying a subdirectory results in a ``partial
190 sandbox'', whose root directory is the specified subdirectory of the larger
191 project. The rest of the project is ``invisible'' to that sandbox. A
192 subdirectory argument can also be given to mcvs grab, which will cause it to
193 integrate the new source tree against a subtree of the Meta-CVS project
194 rather than the entire project. The subtree doesn't have to exist; in
195 that case you get an empty sandbox. Adding files to this sandbox will cause
196 the tree to exist in the project.
197
198 Bugfix: mcvs grab was not computing moves properly over small file sets,
199 wrongly treating them as removes and adds.
200
201 Release 0.17, 2002-07-02:
202
203 The create command no longer takes a vendor branch. Instead the symbol
204 ``Created-by-Meta-CVS'' is used as the vendor tag to satisfy CVS.
205
206 The grab command no longer does useless synchronization on files that
207 are about to be deleted.
208
209 New purge command; does ``cvs rm'' on deleted files, that is to say, F- files
210 that have no mapping.
211
212 New restore command; re-enters deleted files into the mapping, under
213 the ``lost+found'' directory, using their F- names as sandbox names.
214
215 Bugfix: when a checkout bails because it is requested over top of an existing
216 working copy, it must not delete that working copy's MCVS sub directory.
217
218 Release 0.16, 2002-06-29:
219
220 Added new heuristics to grab command. Paths are analyzed to determine
221 move distance. Greater distances reduce the confidence in a move.
222 These rules help sort out grabs in a project where similar or
223 duplicate files are subject to parallel moves, the ambiguity being
224 resolved by favoring shorter moves. Word comparisons are case-insensitive
225 now. Common words (those that appear in many files) are ignored when
226 comparing files.
227
228 New options, --meta and --metaonly. This area of Meta-CVS is cleaned
229 up a little bit. Most reporting commands like log or diff no longer
230 operate on meta files by default; they must be explicitly told to do
231 so with --meta or --metaonly. Only the commit command implicitly includes
232 metafiles by default, and so if this is not wanted, --nometa must be
233 selected. The update command remains special; if it is given file
234 arguments, it does not include meta files. If given no arguments, it
235 does a global CVS up across the entire project.
236
237 Release 0.15, 2002-06-25:
238
239 Optimized a string splitting routine which is used heavily for processing
240 paths; the result is a noticeable performance improvement in some commands
241 that process large numbers of files.
242
243 Renamed ``import'' command to ``create''.
244
245 Bugfix: checkout and create showed errors when removing directory, due to
246 broken :postorder support in directory walking function.
247
248 Bugfix: on failure, checkout was failing to delete the MCVS directory when
249 the checkout was directed to an existing directory.
250
251 New feature: ``mcvs grab'' command imports third-party snapshots to a
252 branch. This is invoked in the root directory of the source tree to import.
253 It determines what files have been added and removed in the snapshot, and
254 tries to compute which removes and adds are actually moves. This is done by
255 analyzing the actual contents of the files according to a crude algorithm to
256 do fuzzy comparisons, so that even files which were modified as well as moved
257 are discovered.
258
259 Release 0.14, 2002-06-21:
260
261 Bugfix: mcvs add was broken for files that have no suffix, causing
262 the underlying cvs add to fail. This was broken in 0.7 when type
263 handling was added.
264
265 Release 0.13, 2002-06-06:
266
267 Sandbox synchronization now handles the case of two files having
268 the same timestamp. An error is signaled, with interactive resolution
269 to synchronize either way, or do nothing.
270
271 If a file must be deleted on update, and this cannot be done, it
272 is now a continuable error.
273
274 Bugfix: pass -I ! to cvs import so that it won't ignore some F- files
275 whose suffix is one of the ones cvs ignores by default.
276
277 New command: mcvs remap. The user can move or delete files directly without
278 going through Meta-CVS. When mcvs remap is invoked, it will hunt down the
279 moves and deletions, and reconstruct the mapping accordingly; that is,
280 it remaps the new structure. This command uses inode numbers to identify
281 files; if a file is copied and then the original is deleted, that won't
282 be recognized as a move.
283
284 Release 0.12, 2002-04-18:
285
286 Bugfix: remove was broken in 0.10, fixed now.
287
288 Bugfix: status, diff, etc. work in empty project rather than complaining
289 ``. not known to Meta-CVS''.
290
291 The checkout operation now can now populate an existing directory, including
292 the current working directory (mcvs co -d . modulename). Of course, the
293 target directory cannot be an existing Meta-CVS sandbox.
294 This is a useful feature, which allows sandboxes to blend with an
295 existing directory structure.
296
297 Checkout now uses the same function for generating the sandbox
298 structure as does update. This is now necessary, because local files
299 can be clobbered by the checkout.
300
301 Release 0.11, 2002-04-12:
302
303 Bugfix: when branch invokes rtag, it now takes the CVSROOT information
304 from CVS/Root and passes it via -d. This is necessary because rtag does not
305 look at a local CVS subdirectory for this information, only the
306 -d option or the environment variable.
307
308 Command for listing branches added (list-branches or lb). Also shows
309 what sticky tag the sandbox is updated to.
310
311 Command for switching branches added (switch or sw).
312
313 Merge detects that working copy is on non-branch tag and bails.
314
315 Absolute paths can now be specified as file arguments. These are
316 based from the root directory of the sandbox, not the actual filesystem root
317 directory.
318
319 Release 0.10, 2002-04-03:
320
321 Automatic merging implemented. Branch is created using branch command,
322 and merging from another branch is done using simple merge command.
323 Meta-CVS maintains the tags to keep track of what has been merged
324 from what branch to what branch.
325
326 Bugfix: checkout -d foo bar was complaining about directory bar already
327 existing, even though it should only care about foo.
328
329 The remove command now requires explicit -R option to recursively remove
330 a directory. It has more detailed error reporting.
331
332 The move command has better error reporting.
333
334 Release 0.9, 2002-03-14:
335
336 Bugfix: the .cvsignore file is now subject to tagging, status, etc,
337 (unless --nometa is specified, of course).
338
339 The mcvs filt command takes -r <revision> or -D <date> parameters.
340 This means to retrieve the MAP file as of the specified revision or
341 date and use that mapping to perform the filtering translation,
342 rather than using MAP-LOCAL.
343
344 The mcvs update command takes filename arguments now and also
345 supports the -p option.
346
347 Release 0.8, 2002-03-13:
348
349 Bug fixed in mcvs add; it was not ignoring files that are already
350 listed as :ignore in MCVS/TYPES.
351
352 Bug fixed in mcvs move: a target with a trailing slash is now treated
353 as a directory (if it does not already exist and is a non-directory).
354
355 The -d option of mcvs checkout can now be used to override the checkout
356 directory, which is normally the same as the module name.
357
358 The global options --version, --help, -q, -Q and -e are now supported.
359
360 New global options --error-continue and --error-terminate to disable
361 interactive error handling in two different ways.
362
363 Log level of many messages has changed; many messages have been
364 relegated to debug level.
365
366 The import command now creates a .cvsignore file containing the name
367 MAP-LOCAL.
368
369 Release 0.7, 2002-03-09:
370
371 The import command collects a list of the file suffixes and brings up
372 a text editor to allow the user to edit their CVS keyword expansion
373 behavior. This information is kept in a new metafile called TYPES. The
374 add command also updates TYPES; it identifies any suffixes which are new,
375 and brings up an editor. The F- files now carry suffixes, which
376 simplifies interfacing with CVS, and also allows cvswrappers to work.
377
378 Recursive add works (mcvs add -R ...).
379
380 New command line option --nometa allows metafiles to be excluded from
381 diff, tag, and other commands; without the option they are inserted
382 into the list of files to be processed.
383
384 The commit option now takes an optional list of files or directories,
385 just like tag, diff, and others.
386
387 Release 0.6, 2002-02-16:
388
389 The add operation was horribly broken in 0.5, it is fixed.
390
391 User can interactively select whether to clobber local files or leave
392 everything alone. Effects on the mapping file of a mcvs move are undone,
393 if the restructuring is rolled back, or raises a condition that leads
394 to termination.
395
396 Meta-CVS now keeps a new meta-file called MCVS/TYPES. This is created
397 during import, and specifies the CVS keyword expansion mode for files
398 having given suffixes, and can also tell Meta-CVS to ignore certain files
399 when importing or adding.
400
401 Release 0.5, 2002-02-10:
402
403 Much improved error handling. Filesystem rearranging code performs
404 sanity checks to prevent adds and moves from accidentally clobbering
405 local files. A rearranging gone bad can be rolled back. Effects
406 of a failed mcvs add can also be rolled back.
407
408 MAP-LOCAL is now sorted in the same way as MAP.
409
410 Release 0.4, 2002-02-04:
411
412 CVS is invoked using internal function resembling the xargs utility,
413 which ensures that multiple command lines are generated if necessary to
414 avoid surpassing the operating system limit on argument and environment
415 vector size. This is important when someone wants to diff or stat a
416 subdirectory, which requires Meta-CVS to pick out the individual files
417 at the CVS level.
418
419 The tag, log, status and annotate commands are now available.
420
421 The MAP file is sorted on F- file names now, not path names. This
422 improves merging, since files do not move within the file when
423 they are renamed.
424
425 Release 0.3, 2002-02-02:
426
427 Process termination done is properly in top level handler, by a nonlocal
428 exit. The program properly indicates failed termination when it exits
429 due to an error condition.
430
431 Corrections are made in the command line option processing. If z is an
432 option that takes an argument, and the argument is -zx, then x is
433 treated as the argument to the option. Long options arguments are
434 recognized properly, according to the --opt=arg convention. The option
435 processing is restructured. Most of the commands now take the
436 appropriate cvs command-specific options.
437
438 The update algorithm performs dupe checking over the map, which could
439 happen during a merge.
440
441 Some more bugfixing has been done to the move command. It was still not
442 handling right some cases of an unversioned file being clobbered. Also,
443 it wasn't renaming a directory containing just one file.
444
445 I did some performance investigation for larger file sets, and
446 ended up rewriting the code that computes filesystem restructuring
447 changes and map duplicates.
448
449 Release 0.2, 2002-01-30:
450
451 Changed official name from MCVS to Meta-CVS. The move command now
452 performs some filesystem tests so it does the right thing when a versioned
453 file is moved over a non-versioned file, or when a file is moved into
454 a directory not known to Meta-CVS. Factored out reading and writing of
455 map files into functions.
456
457 Release 0.1, 2002-01-28:
458
459 Support for mcvs diff -u added. The -R option works for mcvs add command.
460 Bug fixed in mcvs mv command; it wasn't working analogously to the Unix
461 mv command when copying a directory to an existing directory.
462
463 Release 0.0, 2002-01-27:
464
465 This is alpha software. It is not complete, and lacks documentation.
466 However, it is already usable in its present state and is being used for
467 version control by its author. If you can program in Common Lisp and would
468 like to help, take a look through the TODO file. Send me patches, ideas,
469 feature requests.

  ViewVC Help
Powered by ViewVC 1.1.5