ViewVC logotype

Diff of /meta-cvs/F-B3689DBB46386B16F4B2331934B69223

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision by kaz, Fri Apr 5 00:02:06 2002 UTC revision 1.196 by kaz, Mon Mar 10 00:19:32 2008 UTC
# Line 1  Line 1 
1                         Release Notes for Meta-CVS                         Release Notes for Meta-CVS
3  Release 0.11, 2002-04-??:  Release 1.1.99, 2008-0?-??:
5      Build doesn't require lndir tool.
7    Release 1.1.98, 2008-03-07:
9      Support for old CLISP versions is dropped. The oldest CLISP version that
10      this release has been tested with is 2.38.
12      Support for POSIX as a general platform is dropped. Instead, specific
13      operating system implementations are targetted directly, directly using
14      entry points into their shared libraries. This is not only more efficient,
15      but makes Meta-CVS easier to install. No C compiling and linking of a
16      custom CLISP image is required.  The only operating systems supported in
17      this release are Linux (glibc 2.3 or newer) and Cygwin (1.5.22-1 or newer).
19      The mcvs-upgrade script is gone.
21      A mcvs-debug command is now installed along with mcvs. This is just like
22      mcvs, but not compiled. If mcvs breaks, reproducing the problem using
23      mcvs-debug can be helpful.
25      A small bugfix was done to "mcvs filt", as well as a minor enhancement.
26      When CVS reports that a backup file was created having a name such as
27      1.1.#F-1ADF...391, the filter recognizes this .# prefix in front of the
28      F- and will not perform the substitution. Previously, the substitution
29      was performed, resulting in a misleading output from the filter, suggesting
30      that a backup copy of a file was created under the actual name.
32      It is now no longer necessary to pipe the output of mcvs through mcvs fi.
33      It is done automatically for most of the commands where doing so makes sense.
34      The filtering is done in a forked child process, but without exec'ing a new
35      process image, and it is only done around calls to cvs. It can be turned
36      off with a new global option --nofilt.
38      There was an issue building Meta-CVS with CLISP patch revisions that have a
39      third version number, for example "2.32.1". This was fixed in July 2004,
40      but never released. The fix doesn't exist any longer, since the CLISP
41      version check, and the code which depended on it, is completely gone.
43      New -x global option feature: takes an argument which is parsed as
44      a Lisp expression (in the MCVS package) and evaluated.
46      The -i option may appear more than once.
48    Release 1.1.0, 2004-03-12:
50      All Lisp symbols are in a package. Compiling and loading is simplified,
51      and more portable.
53    Release 1.0.13, 2004-03-12:
55      The ``mcvs convert'' command now creates the TYPES and .cvsignore files.
57    Release 1.0.12, 2004-01-31:
59      Fixes various bugs in ``mcvs convert'', so that it is
60      actually useable now, albeit still far from a perfect CVS
61      migration tool.
63      The remap command can now purge the MAP of entries that refer to non-existent
64      F- files, which is useful for cleaning up after the convert algorithm,
65      if necessary.
67    Release 1.0.11, 2004-01-28:
69      Fixes breakage of list-branches command introduced in last release.
71      Fixes failures in grab command when pulling new baseline over
72      partial sandbox. Renamed symlinks, and execute permissions of files
73      were being accessed using abstract instead of real path.
75    Release 1.0.10, 2004-01-09:
77      Builds on CLISP 2.32. The lb command no longer produces bogus warning
78      when working copy is sticky to a version tag.
80    Release 1.0.9, 2003-11-24:
82      Failures to open terminal for reasons other than non-existence
83      of the object are handled (e.g. ``no such device'', etc).
85      The --nometa option now works properly in those commands that
86      operate on the whole project when no file arguments are given
87      (tag, update, commit). Also, these commands no longer implicitly
88      include the meta files when file arguments *are* given.
89      These files can be included explicitly with the --meta global option.
91    Release 1.0.8, 2003-06-03:
93      The Cygwin /dev/tty problem is partially addressed. The program
94      won't fail if /dev does not exist, but emits a warning message,
95      and disables interactive error handling. The workaround is to use
96      ``mkdir /dev''. This is a CLISP issue; its OPEN function expects the
97      full path to a file to actually exist, but on Cygwin, there are fake
98      /dev/* paths even though /dev does not exist.  If a real /dev directory
99      does in fact exist, it does not interfere with these magic paths.
101      The ``mcvs fi'' command no longer performs expansion on F- names
102      that are preceded by a slash.
104    Release 1.0.7, 2003-04-23:
106      New commands sync-to-cvs and sync-from-cvs expose the hard link
107      synchronization algorithm.
109      Revamped error recovery logic. To continue in an error situation now
110      consistently means ``take the bold action that may erase data''
111      or ``proceed in the most obvious way to finish the specified job''.
112      It never means ``roll back the operation and bail'', which was
113      confusing.
115      Termination is no longer unsafe; the `T' menu command, and the
116      equivalent --error-terminate global option perform all necessary
117      restoration and cleanup.
119      Errors that have more information to print, like a list of files or
120      whatever, now indicate it in a standard way which translates to the
121      `I' menu command.
123      Chatter output goes to standard error rather than standard output,
124      as do all error messages.
126      The interactive error menu now talks to the user using the controlling
127      tty, meaning that it will work even if the input or output of the
128      mcvs command are redirected. If no controlling tty is available,
129      then interactive error handling is disabled; the default behavior
130      is then like --error-terminate but can of course be overridden by
131      --error-continue.
133    Release 1.0.6, 2003-04-14:
135      The create command detects the existence of text editor backup files (or
136      other junk) in the MCVS directory after the editor is invoked on the
137      TYPES file. The user is prompted regarding their removal. If these files are
138      not removed, cvs import will bring them into the repository.
140      When Meta-CVS has to split a large CVS command into two or more
141      invocations with shorter argument lists, it now does not stop when one of
142      these invocations is unsuccessful; it does all of them, and combines
143      their termination indications by a logical AND. There was a bug in this
144      logic also which caused, upon termination failure, a cvs command to be
145      repeated for the same list of files.
147      Synchronization logic has been revamped. Unnecessary synchronizations
148      have been removed, which will make some commands run faster.
149      Synchronizations now have specific directions; for instance before
150      a CVS commit or update, changes are pushed from the directory tree to the MCVS
151      directory only, and after the CVS operation, in the reverse direction only.
153      Meta-CVS will no longer re-create missing F- files by linking from the
154      directory tree. Doing this causes two problems. One is that if a user
155      manually removes a F- file and do ``mcvs up'', she wants CVS to fetch a clean
156      copy and push it into the tree. She does not want the file to be restored
157      from the tree prior to the CVS update. Secondly, sometimes CVS itself
158      removes files. If we re-create the files, CVS will consider them to
159      be ``in the way''.
161      Failures to read from the MAP or MAP-LOCAL files are treated as interactive,
162      continuable errors. By continuing, the user agrees that the behavior will
163      be as if an empty map were read.
165      The grab command uses less memory for performing move analysis.
167    Release 1.0.5, 2003-02-25:
169      Bugfix: some one-argument command line options of CVS must be
170      specifies as a single parameter, with no separation between the
171      option letter and the argument characters. For example:
173        cvs log -r rev-1::rev-2      # invalid
174        cvs log -rrev1::rev2         # correct
176      Meta-CVS accepts either syntax, but it was generating the first form
177      when calling CVS. Now, *all* one-letter options that have an argument
178      are formatted in the second manner.
180      Bugfix: one more waitpid() issue was fixed; on fast machines, under
181      Linux, it was observed that from time to time Meta-CVS would get
182      a -1/ECHILD when waiting for the CVS process.
184    Release 1.0.4, 2003-02-20:
186      Fix remaining occurences of the CVS ``No child processes'' abort
187      problem, affecting the list-branches command, merge command
188      and the -r option of the filt command.
190    Release 1.0.3, 2003-02-12:
192      ! THIS RELEASE IS WITHDRAWN. It was accidentally created from the
193      ! experimental main trunk of the Meta-CVS codebase, rather than
194      ! the 1.0 branch. But 1.0.4 does contain all of the changes
195      ! described here.
197      Fix for the CVS ``No child processes'' abort problem. It turns out
198      that CLISP sets the signal handling action for the SIGCHLD signal
199      to SIG_IGN, which is inherited by child processes across the
200      fork() and execvp() calls used in our mcvs_spawn() function.
201      We correct the problem by resetting the signal handler to SIG_DFL
202      just before executing the new process image.
204      New feature, --up option. The argument is a nonnegative integer value
205      (default is zero) which specifies how many sandbox nesting levels to
206      escape out of when locating the sandbox root. This helps work with
207      nested Meta-CVS sandboxes.
209    Release 1.0.2, 2003-02-10:
211      Bugfix in waitpid logic in the C library for running external processes;
212      we were not dealing with an interrupted waitpid.
214      Behavior of mcvs tag is changed: when there are no filename arguments,
215      the whole tree is tagged including the metafiles. In other words, it
216      now works like the commit command.
218    Release 1.0.1, 2003-01-30:
220      Hard link sync optimization: update of a subset of files, commit, and
221      other operations like log and diff don't need to synchronize all
222      hard links, just the ones operated on.
224      The merge and remerge commands support -k option for overriding
225      CVS keyword expansion mode.
227      Fixes to getcwd error handling.
229      Improvement in install.sh script's logic for locating CLISP installation
230      directory.
232    Release 1.0, 2003-01-01:
234      NOTE: It's not possible to upgrade to this release via mcvs-upgrade,
235      because it adds some new C functions to the Lisp executable.
237      Security fix: read-time evaluation was not suppressed when reading
238      structured data, like MCVS/MAP and MCVS/TYPES. This means that it
239      was possible for Alice to check in something that would execute
240      arbitrary code on Bob's computer.
242      Optimization: use fork and exec to launch CVS rather than CLISP's
243      run-program function, which indirects through the shell interpreter.
244      (On Cygwin, the spawnvp function is used).
246      Performance fix: stat() was being called superfluously by the
247      hard synchronization code, twice for each file.
249      Build fix: install.sh works when CLISP executable is called ``lisp.exe'',
250      which is the case under Cygwin with newer CLISP releases.
252    Release 0.99, 2002-11-17:
254      New link command for creating symbolic links.
256      Global option -n (dry run---don't modify filesystem) is processed
257      internally now, not just passed to CVS.
259      Failure to invoke text editor is handled.
261      The -r option of filt is fixed; it has been broken since the change to the
262      new MAP format, because it was reading the raw map representation, not
263      passing it through the right conversion steps that are needed now.
265      Bugfix to purge and remap commands: they were fooled by CVS-generated
266      files in the MCVS/CVS directory. Specifically, files having F- names, and a
267      the suffix ,t.
269      Bugfix to add logic in directory restructuring: there was the possibility
270      of mistakingly taking a clobbered local file to be a new local version of
271      the added file, instead of replacing it. This could happen if the local
272      file had a future timestamp relative to the one coming from the repository.
274      The prop command does not synchronize or write out map if no options are
275      specified.
277      Help text added for move and branch commands. Help text for grab rewritten.
279      The CVSEDITOR and VISUAL environment variables are now checked, not
280      only EDITOR.
282    Release 0.98, 2002-10-13:
284      The prop command was mistakenly reading from MAP-LOCAL and writing to MAP,
285      which could cause information loss if the two differ. It now reads from MAP
286      and writes to MAP. (The property changes propagate to MAP-LOCAL by the
287      update operation invoked by prop, as before).
289      Invocation of external programs included in debug trace.
291      The filt command does not filter F- names if they are immediately preceded by
292      the MCVS/ prefix; such occurences are clearly concrete, sandbox-relative
293      references to the actual F- links, rather than abstract references.
295      The update command now supports the -C option, to fetch the repository
296      copy, throwing away local changes. It also now honors the --metaonly
297      and --nometa options.
299      The export command has been added, for checking out documents without creating
300      a working copy (no MCVS directory in the root of the checkout).
302      The watch command has been added. Note that its syntax differs from that
303      of CVS.
305      The watchers, editors, edit, and unedit commands have been added.
307      A script called mcvs-upgrade is now included, and installs alongside the mcvs
308      script.  This allows the Meta-CVS Lisp image to recompile and patch itself,
309      giving users of binary distributions an easy way to upgrade from source
310      code.
312    Release 0.97, 2002-10-06:
314      Meta-CVS now builds and runs on Microsoft Windows, under Cygwin
315      (www.cygwin.com). It still relies on hard links, which requires
316      Windows 2000 or XP, and the NTFS filesystem. It probably won't
317      work over FAT.
319      New --debug option for verbose output.
321      Cleaned up of error messages. Error messages don't specify prefixes like
322      ``mcvs-add:'' or ``mcvs-grab:'' any more. Rather, the error handler adds the
323      ``mcvs:'' prefix when printing the messages in a situation when the error is
324      not continuable.
326      Fixed bug introduced in release 0.13: mcvs add -R was adding only
327      directories, effectively ignoring arguments that are regular files.
328      The error-continuation behavior of mcvs add has been revised.
330      Trying to rename an object onto itself, or to move the sandbox root
331      directory are no longer silent no-ops, but produce an error.
333      The remap command now preserves property lists, and picks up changes
334      in executable permission.
336      The grab command now notices when a file changes from having execute
337      permission to not having execute permission.
339      Operations on the path . now work in a partial sandbox.
341    Release 0.96, 2002-09-21:
343      The restore command was left broken during the change to the new
344      filemap format. It is now fixed.
346      The grab command now handles execute permission bits properly.
348      Some more commands have detailed help.
350      There is now a global option -i which specifies a script to be
351      executed. This allows Meta-CVS to be scripted using Lisp. For
352      instance suppose you have the following script and call it
353      list-matching:
355        #!/usr/local/bin/mcvs -i
356        (in-sandbox-root-dir
357          (let ((mapping (mapping-read *mcvs-map*))
358                (test-func (eval (read-from-string (pop *args*)))))
359            (dolist (entry mapping)
360              (with-slots (path raw-plist) entry
361                (when (funcall test-func raw-plist)
362                  (format t "~a~%" path))))))
364      Then to list the names of files whose "importance" property is
365      a value greater than two, run:
367        ./list-matching '(lambda (plist)
368                           (let ((imp (getf plist :importance)))
369                             (and imp (> imp 2))))'
371      WARNING: Scripting accesses the guts of Meta-CVS directly, so scripts may
372      break as Meta-CVS is maintained. There is currently no published set of
373      stable interfaces.
375    Release 0.95, 2002-09-16:
377      The install.sh script no longer uses a borrowed copy of the clisp-link script
378      or the linkkit directory; these have been removed.  These materials
379      are available at every CLISP installation; install.sh now finds them
380      and uses them.  Users of non-x86 machines ran into problems because of this
381      because linkkit/clisp.h contains architecture-dependent information.
383      A bug in mcvs filt was fixed; it wasn't handling F- names that aren't found
384      in the map.
386      A more detailed help system now exists, though it's not complete.  The ``mcvs
387      help'' command acts just like ``mcvs --help'' without any arguments. If given
388      an additional parameter which specifies a Meta-CVS command, it produces more
389      detailed documentation for that comand. Help exists already for a few
390      commands.
392      The release number is being warped to 0.95, which means that Meta-CVS is now
393      in beta. It is only five updates away from a 1.0 release.
395    Release 0.24, 2002-09-08:
397      The mapping entries for both symlinks and files have extensible property
398      lists now. These are stored in the optional fourth and fifth list elements,
399      respectively of the :FILE and :SYMLINK map entries.
401      Versioning of the execute permission of files is supported, represented as
402      the :EXEC property of a :FILE mapping entry.
404      Some lame syntax is provided for manipulating properties:
406        mcvs prop --set foo --clear bar --remove baz main.c list.c
408      will set the property FOO to true, set the property BAR to false,
409      and remove the property BAZ, in the files main.c and list.c.
410      The execute permission is represented by the property EXEC.
412    Release 0.23, 2002-09-02:
414      Bugfix: the grab command notices edited symlinks and incorporates the
415      changes into the mapping.
417      The grab command now figures out moved symlinks. Moved symlinks are those
418      whose pathname has changed, but which continue to point to the same object
419      (which may also have been moved).
421    Release 0.22, 2002-08-31:
423      Symbolic links are now versioned objects. The format of the MAP file
424      changes to accomodate this; the new Meta-CVS will read old MAP
425      files; when it writes it will write the new format. Old Meta-CVS won't
426      read the new format.
428      When a new module is created from an existing file tree, symbolic
429      links will be recognized and added. The add command will also add
430      symbolic links. Symbolic links can be renamed and moved; this does
431      nothing with their contents. They can point outside of the sandbox
432      using relative or absolute paths.
434      TODO:
436      There doesn't exist yet a special command to create symbolic links, nor to
437      retarget them; retargetting a link can be done manually by editing MCVS/MAP
438      and updating. Retargetting a link using the ln -s command, won't
439      backpropagate to the MAP file; an update will clobber the link.
441      The grab command does not yet compute symbolic link moves; a moved symbolic
442      link is treated as a remove and add.  This will be easy to fix.
444      The remap command ignores symlinks.
446    Release 0.21, 2002-08-04:
448      Syntax of grab command changed. The branch is no longer specified as an
449      argument, but using the -r command option. If no revision is specified with
450      -r, then a -A must be specified to make the grab go to the main trunk. This
451      is a safety feature, since grabbing foreign snapshots to the trunk is almost
452      always wrong, though it could be useful during backup recovery, or for fixing
453      mistakes.
455      The way operating system functions are targetted has changed. Instead of
456      relying on the ``linuxlibc6'' module provided by CLISP, Meta-CVS now
457      has its own module for calling foreign functions. This module is portable;
458      it does not depend on the layout of glibc data structures. So Meta-CVS
459      is in theory now portable to other Unixes (provided they have /dev/urandom).
461    Release 0.20, 2002-07-27:
463      The commit command does a true global commit when given no file or directory
464      parameters, and not given the --metaonly option.  This means commiting all
465      changes in the MCVS directory, even if they are in F-files that are not
466      currently mapped.
468    Release 0.19, 2002-07-16:
470      When moving multiple files or directories to a subdirectory, a
471      restart is now provided to skip over bad ones and continue.
473      Grab no longer scans files if there are only added files, or only removed
474      files. There are no moves to deduce in that case.
476      Restore properly creates lost+found at the root of a partial sandbox,
477      rather than at the abstract root of the module.
479      Some other algorithmic improvements made.
481      The first few sections of a user guide have been written.
483    Release 0.18, 2002-07-07:
485      Cool new feature: checkout takes an extra argument, which specifies a
486      subdirectory of the project. Specifying a subdirectory results in a ``partial
487      sandbox'', whose root directory is the specified subdirectory of the larger
488      project. The rest of the project is ``invisible'' to that sandbox.  A
489      subdirectory argument can also be given to mcvs grab, which will cause it to
490      integrate the new source tree against a subtree of the Meta-CVS project
491      rather than the entire project. The subtree doesn't have to exist; in
492      that case you get an empty sandbox. Adding files to this sandbox will cause
493      the tree to exist in the project.
495      Bugfix: mcvs grab was not computing moves properly over small file sets,
496      wrongly treating them as removes and adds.
498    Release 0.17, 2002-07-02:
500      The create command no longer takes a vendor branch. Instead the symbol
501      ``Created-by-Meta-CVS'' is used as the vendor tag to satisfy CVS.
503      The grab command no longer does useless synchronization on files that
504      are about to be deleted.
506      New purge command; does ``cvs rm'' on deleted files, that is to say, F- files
507      that have no mapping.
509      New restore command; re-enters deleted files into the mapping, under
510      the ``lost+found'' directory, using their F- names as sandbox names.
512      Bugfix: when a checkout bails because it is requested over top of an existing
513      working copy, it must not delete that working copy's MCVS sub directory.
515    Release 0.16, 2002-06-29:
517      Added new heuristics to grab command. Paths are analyzed to determine
518      move distance. Greater distances reduce the confidence in a move.
519      These rules help sort out grabs in a project where similar or
520      duplicate files are subject to parallel moves, the ambiguity being
521      resolved by favoring shorter moves. Word comparisons are case-insensitive
522      now. Common words (those that appear in many files) are ignored when
523      comparing files.
525      New options, --meta and --metaonly. This area of Meta-CVS is cleaned
526      up a little bit. Most reporting commands like log or diff no longer
527      operate on meta files by default; they must be explicitly told to do
528      so with --meta or --metaonly. Only the commit command implicitly includes
529      metafiles by default, and so if this is not wanted, --nometa must be
530      selected.  The update command remains special; if it is given file
531      arguments, it does not include meta files. If given no arguments, it
532      does a global CVS up across the entire project.
534    Release 0.15, 2002-06-25:
536      Optimized a string splitting routine which is used heavily for processing
537      paths; the result is a noticeable performance improvement in some commands
538      that process large numbers of files.
540      Renamed ``import'' command to ``create''.
542      Bugfix: checkout and create showed errors when removing directory, due to
543      broken :postorder support in directory walking function.
545      Bugfix: on failure, checkout was failing to delete the MCVS directory when
546      the checkout was directed to an existing directory.
548      New feature: ``mcvs grab'' command imports third-party snapshots to a
549      branch. This is invoked in the root directory of the source tree to import.
550      It determines what files have been added and removed in the snapshot, and
551      tries to compute which removes and adds are actually moves. This is done by
552      analyzing the actual contents of the files according to a crude algorithm to
553      do fuzzy comparisons, so that even files which were modified as well as moved
554      are discovered.
556    Release 0.14, 2002-06-21:
558      Bugfix: mcvs add was broken for files that have no suffix, causing
559      the underlying cvs add to fail. This was broken in 0.7 when type
560      handling was added.
562    Release 0.13, 2002-06-06:
564      Sandbox synchronization now handles the case of two files having
565      the same timestamp. An error is signaled, with interactive resolution
566      to synchronize either way, or do nothing.
568      If a file must be deleted on update, and this cannot be done, it
569      is now a continuable error.
571      Bugfix: pass -I ! to cvs import so that it won't ignore some F- files
572      whose suffix is one of the ones cvs ignores by default.
574      New command: mcvs remap. The user can move or delete files directly without
575      going through Meta-CVS. When mcvs remap is invoked, it will hunt down the
576      moves and deletions, and reconstruct the mapping accordingly; that is,
577      it remaps the new structure. This command uses inode numbers to identify
578      files; if a file is copied and then the original is deleted, that won't
579      be recognized as a move.
581    Release 0.12, 2002-04-18:
583      Bugfix: remove was broken in 0.10, fixed now.
585      Bugfix: status, diff, etc. work in empty project rather than complaining
586      ``. not known to Meta-CVS''.
588      The checkout operation now can now populate an existing directory, including
589      the current working directory (mcvs co -d . modulename).  Of course, the
590      target directory cannot be an existing Meta-CVS sandbox.
591      This is a useful feature, which allows sandboxes to blend with an
592      existing directory structure.
594      Checkout now uses the same function for generating the sandbox
595      structure as does update. This is now necessary, because local files
596      can be clobbered by the checkout.
598    Release 0.11, 2002-04-12:
600    Bugfix: when branch invokes rtag, it now takes the CVSROOT information    Bugfix: when branch invokes rtag, it now takes the CVSROOT information
601    from CVS/Root and passes it via -d. This is necessary because rtag does not    from CVS/Root and passes it via -d. This is necessary because rtag does not
# Line 14  Release 0.11, 2002-04-??: Line 609  Release 0.11, 2002-04-??:
610    Merge detects that working copy is on non-branch tag and bails.    Merge detects that working copy is on non-branch tag and bails.
612    Add operation defers invoking cvs add; instead the cvs add commands    Absolute paths can now be specified as file arguments. These are
613    are shunted into a local file. They are later performed at commit time.    based from the root directory of the sandbox, not the actual filesystem root
614    This allows files to be locally added, but then later commited to a different    directory.
   branch. It's a use case that is broken in CVS, hence the need to defer.  
616  Release 0.10, 2002-04-03:  Release 0.10, 2002-04-03:

Removed from v.  
changed lines
  Added in v.1.196

  ViewVC Help
Powered by ViewVC 1.1.5