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

  ViewVC Help
Powered by ViewVC 1.1.5