ViewVC logotype

Contents of /meta-cvs/F-B3689DBB46386B16F4B2331934B69223

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1.101 - (show annotations)
Sat Sep 7 04:41:47 2002 UTC (11 years, 7 months ago) by kaz
Branch: MAIN
Changes since 1.100: +1 -1 lines
Unify command option parsing, and enable it to handle options with
any number of required parameters.

* code/options.lisp (parse-opt): Function rewritten. Argument
syntax and semantics have changed. Options are specified
as an association list whose member are string-integer
pairs. The string is the option name, the integer specifies
the number of required parameters.
(option-spec-expand): New function.
(option-spec): New macro.
(define-option-constant): New macro.

* code/mcvs-main.lisp (*cvs-options-arg*): Constant removed.
(*cvs-options*, *create-options*, *grab-options*, *checkout-options*,
*add-options*, *remove-options*, *update-options*,
*switch-options*, *commit-options*, *diff-options*, *tag-options*,
*log-options*, *status-options*, *annotate-options, *filt-options*,
*convert-options*, *branch-options*, *merge-options*,
*remerge-options*, *list-branches-options*, *remap-options*,
*purge-options*, *restore-options*, *prop-options*): Constant
definitions refactored using define-option-constant macro.
(*mcvs-command-table*): Use , rather than ,@ to insert
option specs.
(*usage*): Suggest cleaner syntax for prop options.
(mcvs-execute): Switch to new parse-opt.
1 Release Notes for Meta-CVS
3 Release 0.24, 2002-09-??:
5 The mapping entries for both symlinks and files have extensible property
6 lists now. These are stored in the optional fourth and fifth list elements,
7 respectively of the :FILE and :SYMLINK map entries.
9 Versioning of the execute permission of files is supported, represented as
10 the :EXEC property of a :FILE mapping entry.
12 Some lame syntax is provided for manipulating properties:
14 mcvs --set foo --clear bar --remove baz main.c list.c
16 will set the property FOO to true, set the property BAR to false,
17 and remove the property BAZ, in the files main.c and list.c.
19 The execute permission is represented by the property EXEC.
21 Release 0.23, 2002-09-02:
23 Bugfix: the grab command notices edited symlinks and incorporates the
24 changes into the mapping.
26 The grab command now figures out moved symlinks. Moved symlinks are those
27 whose pathname has changed, but which continue to point to the same object
28 (which may also have been moved).
30 Release 0.22, 2002-08-31:
32 Symbolic links are now versioned objects. The format of the MAP file
33 changes to accomodate this; the new Meta-CVS will read old MAP
34 files; when it writes it will write the new format. Old Meta-CVS won't
35 read the new format.
37 When a new module is created from an existing file tree, symbolic
38 links will be recognized and added. The add command will also add
39 symbolic links. Symbolic links can be renamed and moved; this does
40 nothing with their contents. They can point outside of the sandbox
41 using relative or absolute paths.
43 TODO:
45 There doesn't exist yet a special command to create symbolic links, nor to
46 retarget them; retargetting a link can be done manually by editing MCVS/MAP
47 and updating. Retargetting a link using the ln -s command, won't
48 backpropagate to the MAP file; an update will clobber the link.
50 The grab command does not yet compute symbolic link moves; a moved symbolic
51 link is treated as a remove and add. This will be easy to fix.
53 The remap command ignores symlinks.
55 Release 0.21, 2002-08-04:
57 Syntax of grab command changed. The branch is no longer specified as an
58 argument, but using the -r command option. If no revision is specified with
59 -r, then a -A must be specified to make the grab go to the main trunk. This
60 is a safety feature, since grabbing foreign snapshots to the trunk is almost
61 always wrong, though it could be useful during backup recovery, or for fixing
62 mistakes.
64 The way operating system functions are targetted has changed. Instead of
65 relying on the ``linuxlibc6'' module provided by CLISP, Meta-CVS now
66 has its own module for calling foreign functions. This module is portable;
67 it does not depend on the layout of glibc data structures. So Meta-CVS
68 is in theory now portable to other Unixes (provided they have /dev/urandom).
70 Release 0.20, 2002-07-27:
72 The commit command does a true global commit when given no file or directory
73 parameters, and not given the --metaonly option. This means commiting all
74 changes in the MCVS directory, even if they are in F-files that are not
75 currently mapped.
77 Release 0.19, 2002-07-16:
79 When moving multiple files or directories to a subdirectory, a
80 restart is now provided to skip over bad ones and continue.
82 Grab no longer scans files if there are only added files, or only removed
83 files. There are no moves to deduce in that case.
85 Restore properly creates lost+found at the root of a partial sandbox,
86 rather than at the abstract root of the module.
88 Some other algorithmic improvements made.
90 The first few sections of a user guide have been written.
92 Release 0.18, 2002-07-07:
94 Cool new feature: checkout takes an extra argument, which specifies a
95 subdirectory of the project. Specifying a subdirectory results in a ``partial
96 sandbox'', whose root directory is the specified subdirectory of the larger
97 project. The rest of the project is ``invisible'' to that sandbox. A
98 subdirectory argument can also be given to mcvs grab, which will cause it to
99 integrate the new source tree against a subtree of the Meta-CVS project
100 rather than the entire project. The subtree doesn't have to exist; in
101 that case you get an empty sandbox. Adding files to this sandbox will cause
102 the tree to exist in the project.
104 Bugfix: mcvs grab was not computing moves properly over small file sets,
105 wrongly treating them as removes and adds.
107 Release 0.17, 2002-07-02:
109 The create command no longer takes a vendor branch. Instead the symbol
110 ``Created-by-Meta-CVS'' is used as the vendor tag to satisfy CVS.
112 The grab command no longer does useless synchronization on files that
113 are about to be deleted.
115 New purge command; does ``cvs rm'' on deleted files, that is to say, F- files
116 that have no mapping.
118 New restore command; re-enters deleted files into the mapping, under
119 the ``lost+found'' directory, using their F- names as sandbox names.
121 Bugfix: when a checkout bails because it is requested over top of an existing
122 working copy, it must not delete that working copy's MCVS sub directory.
124 Release 0.16, 2002-06-29:
126 Added new heuristics to grab command. Paths are analyzed to determine
127 move distance. Greater distances reduce the confidence in a move.
128 These rules help sort out grabs in a project where similar or
129 duplicate files are subject to parallel moves, the ambiguity being
130 resolved by favoring shorter moves. Word comparisons are case-insensitive
131 now. Common words (those that appear in many files) are ignored when
132 comparing files.
134 New options, --meta and --metaonly. This area of Meta-CVS is cleaned
135 up a little bit. Most reporting commands like log or diff no longer
136 operate on meta files by default; they must be explicitly told to do
137 so with --meta or --metaonly. Only the commit command implicitly includes
138 metafiles by default, and so if this is not wanted, --nometa must be
139 selected. The update command remains special; if it is given file
140 arguments, it does not include meta files. If given no arguments, it
141 does a global CVS up across the entire project.
143 Release 0.15, 2002-06-25:
145 Optimized a string splitting routine which is used heavily for processing
146 paths; the result is a noticeable performance improvement in some commands
147 that process large numbers of files.
149 Renamed ``import'' command to ``create''.
151 Bugfix: checkout and create showed errors when removing directory, due to
152 broken :postorder support in directory walking function.
154 Bugfix: on failure, checkout was failing to delete the MCVS directory when
155 the checkout was directed to an existing directory.
157 New feature: ``mcvs grab'' command imports third-party snapshots to a
158 branch. This is invoked in the root directory of the source tree to import.
159 It determines what files have been added and removed in the snapshot, and
160 tries to compute which removes and adds are actually moves. This is done by
161 analyzing the actual contents of the files according to a crude algorithm to
162 do fuzzy comparisons, so that even files which were modified as well as moved
163 are discovered.
165 Release 0.14, 2002-06-21:
167 Bugfix: mcvs add was broken for files that have no suffix, causing
168 the underlying cvs add to fail. This was broken in 0.7 when type
169 handling was added.
171 Release 0.13, 2002-06-06:
173 Sandbox synchronization now handles the case of two files having
174 the same timestamp. An error is signaled, with interactive resolution
175 to synchronize either way, or do nothing.
177 If a file must be deleted on update, and this cannot be done, it
178 is now a continuable error.
180 Bugfix: pass -I ! to cvs import so that it won't ignore some F- files
181 whose suffix is one of the ones cvs ignores by default.
183 New command: mcvs remap. The user can move or delete files directly without
184 going through Meta-CVS. When mcvs remap is invoked, it will hunt down the
185 moves and deletions, and reconstruct the mapping accordingly; that is,
186 it remaps the new structure. This command uses inode numbers to identify
187 files; if a file is copied and then the original is deleted, that won't
188 be recognized as a move.
190 Release 0.12, 2002-04-18:
192 Bugfix: remove was broken in 0.10, fixed now.
194 Bugfix: status, diff, etc. work in empty project rather than complaining
195 ``. not known to Meta-CVS''.
197 The checkout operation now can now populate an existing directory, including
198 the current working directory (mcvs co -d . modulename). Of course, the
199 target directory cannot be an existing Meta-CVS sandbox.
200 This is a useful feature, which allows sandboxes to blend with an
201 existing directory structure.
203 Checkout now uses the same function for generating the sandbox
204 structure as does update. This is now necessary, because local files
205 can be clobbered by the checkout.
207 Release 0.11, 2002-04-12:
209 Bugfix: when branch invokes rtag, it now takes the CVSROOT information
210 from CVS/Root and passes it via -d. This is necessary because rtag does not
211 look at a local CVS subdirectory for this information, only the
212 -d option or the environment variable.
214 Command for listing branches added (list-branches or lb). Also shows
215 what sticky tag the sandbox is updated to.
217 Command for switching branches added (switch or sw).
219 Merge detects that working copy is on non-branch tag and bails.
221 Absolute paths can now be specified as file arguments. These are
222 based from the root directory of the sandbox, not the actual filesystem root
223 directory.
225 Release 0.10, 2002-04-03:
227 Automatic merging implemented. Branch is created using branch command,
228 and merging from another branch is done using simple merge command.
229 Meta-CVS maintains the tags to keep track of what has been merged
230 from what branch to what branch.
232 Bugfix: checkout -d foo bar was complaining about directory bar already
233 existing, even though it should only care about foo.
235 The remove command now requires explicit -R option to recursively remove
236 a directory. It has more detailed error reporting.
238 The move command has better error reporting.
240 Release 0.9, 2002-03-14:
242 Bugfix: the .cvsignore file is now subject to tagging, status, etc,
243 (unless --nometa is specified, of course).
245 The mcvs filt command takes -r <revision> or -D <date> parameters.
246 This means to retrieve the MAP file as of the specified revision or
247 date and use that mapping to perform the filtering translation,
248 rather than using MAP-LOCAL.
250 The mcvs update command takes filename arguments now and also
251 supports the -p option.
253 Release 0.8, 2002-03-13:
255 Bug fixed in mcvs add; it was not ignoring files that are already
256 listed as :ignore in MCVS/TYPES.
258 Bug fixed in mcvs move: a target with a trailing slash is now treated
259 as a directory (if it does not already exist and is a non-directory).
261 The -d option of mcvs checkout can now be used to override the checkout
262 directory, which is normally the same as the module name.
264 The global options --version, --help, -q, -Q and -e are now supported.
266 New global options --error-continue and --error-terminate to disable
267 interactive error handling in two different ways.
269 Log level of many messages has changed; many messages have been
270 relegated to debug level.
272 The import command now creates a .cvsignore file containing the name
275 Release 0.7, 2002-03-09:
277 The import command collects a list of the file suffixes and brings up
278 a text editor to allow the user to edit their CVS keyword expansion
279 behavior. This information is kept in a new metafile called TYPES. The
280 add command also updates TYPES; it identifies any suffixes which are new,
281 and brings up an editor. The F- files now carry suffixes, which
282 simplifies interfacing with CVS, and also allows cvswrappers to work.
284 Recursive add works (mcvs add -R ...).
286 New command line option --nometa allows metafiles to be excluded from
287 diff, tag, and other commands; without the option they are inserted
288 into the list of files to be processed.
290 The commit option now takes an optional list of files or directories,
291 just like tag, diff, and others.
293 Release 0.6, 2002-02-16:
295 The add operation was horribly broken in 0.5, it is fixed.
297 User can interactively select whether to clobber local files or leave
298 everything alone. Effects on the mapping file of a mcvs move are undone,
299 if the restructuring is rolled back, or raises a condition that leads
300 to termination.
302 Meta-CVS now keeps a new meta-file called MCVS/TYPES. This is created
303 during import, and specifies the CVS keyword expansion mode for files
304 having given suffixes, and can also tell Meta-CVS to ignore certain files
305 when importing or adding.
307 Release 0.5, 2002-02-10:
309 Much improved error handling. Filesystem rearranging code performs
310 sanity checks to prevent adds and moves from accidentally clobbering
311 local files. A rearranging gone bad can be rolled back. Effects
312 of a failed mcvs add can also be rolled back.
314 MAP-LOCAL is now sorted in the same way as MAP.
316 Release 0.4, 2002-02-04:
318 CVS is invoked using internal function resembling the xargs utility,
319 which ensures that multiple command lines are generated if necessary to
320 avoid surpassing the operating system limit on argument and environment
321 vector size. This is important when someone wants to diff or stat a
322 subdirectory, which requires Meta-CVS to pick out the individual files
323 at the CVS level.
325 The tag, log, status and annotate commands are now available.
327 The MAP file is sorted on F- file names now, not path names. This
328 improves merging, since files do not move within the file when
329 they are renamed.
331 Release 0.3, 2002-02-02:
333 Process termination done is properly in top level handler, by a nonlocal
334 exit. The program properly indicates failed termination when it exits
335 due to an error condition.
337 Corrections are made in the command line option processing. If z is an
338 option that takes an argument, and the argument is -zx, then x is
339 treated as the argument to the option. Long options arguments are
340 recognized properly, according to the --opt=arg convention. The option
341 processing is restructured. Most of the commands now take the
342 appropriate cvs command-specific options.
344 The update algorithm performs dupe checking over the map, which could
345 happen during a merge.
347 Some more bugfixing has been done to the move command. It was still not
348 handling right some cases of an unversioned file being clobbered. Also,
349 it wasn't renaming a directory containing just one file.
351 I did some performance investigation for larger file sets, and
352 ended up rewriting the code that computes filesystem restructuring
353 changes and map duplicates.
355 Release 0.2, 2002-01-30:
357 Changed official name from MCVS to Meta-CVS. The move command now
358 performs some filesystem tests so it does the right thing when a versioned
359 file is moved over a non-versioned file, or when a file is moved into
360 a directory not known to Meta-CVS. Factored out reading and writing of
361 map files into functions.
363 Release 0.1, 2002-01-28:
365 Support for mcvs diff -u added. The -R option works for mcvs add command.
366 Bug fixed in mcvs mv command; it wasn't working analogously to the Unix
367 mv command when copying a directory to an existing directory.
369 Release 0.0, 2002-01-27:
371 This is alpha software. It is not complete, and lacks documentation.
372 However, it is already usable in its present state and is being used for
373 version control by its author. If you can program in Common Lisp and would
374 like to help, take a look through the TODO file. Send me patches, ideas,
375 feature requests.

  ViewVC Help
Powered by ViewVC 1.1.5