ViewVC logotype

Contents of /meta-cvs/F-B3689DBB46386B16F4B2331934B69223

Parent Directory Parent Directory | Revision Log Revision Log

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

  ViewVC Help
Powered by ViewVC 1.1.5