ViewVC logotype

Contents of /meta-cvs/F-B3689DBB46386B16F4B2331934B69223

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1.131 - (hide annotations)
Mon Oct 14 00:00:23 2002 UTC (11 years, 6 months ago) by kaz
Branch: MAIN
Changes since 1.130: +2 -0 lines
Merging from mcvs-1-0-branch.

* code/mcvs-main.lisp (*usage*): Describe export and watch commands.
(*watch-options*): New constant.
(*mcvs-command-table*): New entry for watch command.

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

  ViewVC Help
Powered by ViewVC 1.1.5