ViewVC logotype

Contents of /meta-cvs/F-B3689DBB46386B16F4B2331934B69223

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1.123 - (show annotations)
Sun Oct 6 07:56:00 2002 UTC (11 years, 6 months ago) by kaz
Branch: MAIN
Changes since 1.122: +3 -0 lines
* code/mapping.lisp (equal-filemaps): Repair completely broken

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

  ViewVC Help
Powered by ViewVC 1.1.5