/[meta-cvs]/meta-cvs/F-233AD6EEE14894A7303F09519A2AB734
ViewVC logotype

Contents of /meta-cvs/F-233AD6EEE14894A7303F09519A2AB734

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.69.2.17 - (show annotations)
Sun Feb 23 18:49:43 2003 UTC (11 years, 2 months ago) by kaz
Branch: mcvs-1-0-branch
CVS Tags: mcvs-1-0-5, mcvs-1-0-6
Changes since 1.69.2.16: +2 -0 lines
* code/mcvs-main.lisp (*usage*): Add help text for --up option.
1 ;;; This source file is part of the Meta-CVS program,
2 ;;; which is distributed under the GNU license.
3 ;;; Copyright 2002 Kaz Kylheku
4
5 ;; Clear out requires for mcvs-upgrade to work right.
6 (setf *modules* nil)
7
8 (require "create")
9 (require "checkout")
10 (require "grab")
11 (require "add")
12 (require "remove")
13 (require "move")
14 (require "link")
15 (require "update")
16 (require "filt")
17 (require "generic")
18 (require "convert")
19 (require "branch")
20 (require "remap")
21 (require "purge")
22 (require "restore")
23 (require "prop")
24 (require "watch")
25 (require "split")
26 (require "restart")
27 (require "error")
28 (require "options")
29 (require "find-bind")
30 (provide "mcvs-main")
31
32 (define-option-constant *global-options*
33 (0 arg "H" "help" "Q" "q" "r" "w" "l" "n" "t" "v" "f" "version"
34 "meta" "metaonly" "nometa" "error-continue" "error-terminate"
35 "debug")
36 (1 arg "T" "e" "d" "r" "z" "s" "i" "up"))
37
38 (define-option-constant *help-options*)
39
40 (define-option-constant *create-options*
41 (0 arg "d")
42 (1 arg "k" "I" "b" "m" "W"))
43
44 (define-option-constant *grab-options*
45 (0 arg "A")
46 (1 arg "r"))
47
48 (define-option-constant *checkout-options*
49 (0 arg "f")
50 (1 arg "r" "D" "d" "k" "j"))
51
52 (define-option-constant *export-options*
53 (0 arg "f")
54 (1 arg "r" "D" "d" "k"))
55
56 (define-option-constant *add-options*
57 (0 arg "R")
58 (1 arg "k" "m"))
59
60 (define-option-constant *remove-options*
61 (0 arg "R"))
62
63 (define-option-constant *update-options*
64 (0 arg "A" "C" "f" "p")
65 (1 arg "k" "r" "D" "j" "I" "W"))
66
67 (define-option-constant *switch-options*
68 (1 arg "k" "I" "W"))
69
70 (define-option-constant *commit-options*
71 (0 arg "f")
72 (1 arg "F" "m" "r"))
73
74 (define-option-constant *diff-options*
75 (0 arg "a" "b" "B" "brief" "c" "d" "e" "ed" "expand-tabs" "f" "forward-ed"
76 "H" "i" "ignore-all-space" "ignore-blank-lines" "ignore-case"
77 "ignore-space-change" "initial-tab" "l" "left-column" "minimal" "n"
78 "N" "new-file" "p" "P" "--paginate" "q" "rcs" "report-identical-files"
79 "s" "show-c-function" "side-by-side" "speed-large-files"
80 "suppress-common-lines" "t" "T" "text" "u" "unidirectional-new-file"
81 "w" "y")
82 (1 arg "C" "context" "D" "F" "horizon-lines" "ifdef" "ignore-matching-lines"
83 "L" "label" "line-format" "new-group-format" "new-line-format"
84 "old-group-format" "old-line-format" "r" "show-function-line"
85 "unchanged-group-format" "unchanged-line-format" "U" "unified" "W"
86 "width"))
87
88 (define-option-constant *tag-options*
89 (0 arg "l" "d" "f" "b" "F" "c")
90 (1 arg "r" "D"))
91
92 (define-option-constant *log-options*
93 (0 arg "R" "h" "t" "N" "b")
94 (1 arg "r" "d" "s" "w"))
95
96 (define-option-constant *status-options*
97 (0 arg "v"))
98
99 (define-option-constant *annotate-options*
100 (0 arg "f")
101 (1 arg "r" "D"))
102
103 (define-option-constant *filt-options*
104 (1 arg "r" "D"))
105
106 (define-option-constant *move-options*)
107 (define-option-constant *link-options*)
108 (define-option-constant *convert-options*)
109 (define-option-constant *branch-options*)
110
111 (define-option-constant *merge-options*
112 (1 arg "k"))
113
114 (define-option-constant *remerge-options*
115 (1 arg "k"))
116
117 (define-option-constant *list-branches-options*)
118 (define-option-constant *remap-options*)
119 (define-option-constant *purge-options*)
120 (define-option-constant *restore-options*)
121
122 (define-option-constant *prop-options*
123 (1 arg "set" "clear" "remove")
124 (2 arg "value"))
125
126 (define-option-constant *watch-options*
127 (0 arg "on" "off")
128 (1 arg "add" "remove"))
129
130 (define-option-constant *watchers-options*)
131 (define-option-constant *edit-options*)
132 (define-option-constant *unedit-options*)
133 (define-option-constant *editors-options*)
134
135 (defun mcvs-help (global-options command-options args)
136 (declare (special *usage* *mcvs-command-table*)
137 (ignore global-options command-options))
138 (cond
139 ((null args)
140 (terpri)
141 (write-line *usage*)
142 (terpri))
143 ((= (length args) 1)
144 (let* ((command-name (first args))
145 (command (find command-name *mcvs-command-table*
146 :key #'first
147 :test #'string=)))
148 (when (null command)
149 (error "~a is not a recognized mcvs command."
150 command-name))
151 (let ((help-text (third command)))
152 (when (null help-text)
153 (error "sorry, no help available for ~a command."
154 command-name))
155 (terpri)
156 (write-line help-text)
157 (terpri))))
158 (t (error "try \"mcvs help <name-of-command>\"."))))
159
160 (defconstant *mcvs-command-table*
161 `(("help" ,#'mcvs-help nil ,*help-options*)
162 ("create" ,#'mcvs-create-wrapper ,*create-help* ,*create-options*)
163 ("grab" ,#'mcvs-grab-wrapper ,*grab-help* ,*grab-options*)
164 ("checkout" ,#'mcvs-checkout-wrapper ,*checkout-help* ,*checkout-options*)
165 ("co" ,#'mcvs-checkout-wrapper ,*checkout-help* ,*checkout-options*)
166 ("export" ,#'mcvs-export-wrapper ,*export-help* ,*export-options*)
167 ("ex" ,#'mcvs-export-wrapper ,*export-help* ,*export-options*)
168 ("add" ,#'mcvs-add-wrapper ,*add-help* ,*add-options*)
169 ("remove" ,#'mcvs-remove-wrapper ,*remove-help* ,*remove-options*)
170 ("rm" ,#'mcvs-remove-wrapper ,*remove-help* ,*remove-options*)
171 ("move" ,#'mcvs-move-wrapper ,*move-help* ,*move-options*)
172 ("mv" ,#'mcvs-move-wrapper ,*move-help* ,*move-options*)
173 ("link" ,#'mcvs-link-wrapper ,*link-help* ,*link-options*)
174 ("ln" ,#'mcvs-link-wrapper ,*link-help* ,*link-options*)
175 ("update" ,#'mcvs-update-wrapper nil ,*update-options*)
176 ("up" ,#'mcvs-update-wrapper nil ,*update-options*)
177 ("commit" ,#'mcvs-commit-wrapper nil ,*commit-options*)
178 ("ci" ,#'mcvs-commit-wrapper nil ,*commit-options*)
179 ("diff" ,#'mcvs-diff-wrapper nil ,*diff-options*)
180 ("tag" ,#'mcvs-tag-wrapper nil ,*tag-options*)
181 ("log" ,#'mcvs-log-wrapper nil ,*log-options*)
182 ("status" ,#'mcvs-status-wrapper nil ,*status-options*)
183 ("stat" ,#'mcvs-status-wrapper nil ,*status-options*)
184 ("annotate" ,#'mcvs-annotate-wrapper nil ,*annotate-options*)
185 ("filt" ,#'mcvs-filt-wrapper nil ,*filt-options*)
186 ("fi" ,#'mcvs-filt-wrapper nil ,*filt-options*)
187 ("convert" ,#'mcvs-convert-wrapper nil ,*convert-options*)
188 ("branch" ,#'mcvs-branch-wrapper ,*branch-help* ,*branch-options*)
189 ("switch" ,#'mcvs-switch-wrapper nil ,*switch-options*)
190 ("sw" ,#'mcvs-switch-wrapper nil ,*switch-options*)
191 ("merge" ,#'mcvs-merge-wrapper nil ,*merge-options*)
192 ("remerge" ,#'mcvs-remerge-wrapper nil ,*remerge-options*)
193 ("list-branches" ,#'mcvs-list-branches-wrapper nil ,*list-branches-options*)
194 ("lb" ,#'mcvs-list-branches-wrapper nil ,*list-branches-options*)
195 ("purge" ,#'mcvs-purge-wrapper nil ,*purge-options*)
196 ("restore" ,#'mcvs-restore-wrapper nil ,*restore-options*)
197 ("remap" ,#'mcvs-remap-wrapper nil ,*remap-options*)
198 ("prop" ,#'mcvs-prop-wrapper nil ,*prop-options*)
199 ("watch" ,#'mcvs-watch-wrapper nil ,*watch-options*)
200 ("watchers" ,#'mcvs-watchers-wrapper nil ,*watchers-options*)
201 ("edit" ,#'mcvs-edit-wrapper nil ,*edit-options*)
202 ("unedit" ,#'mcvs-unedit-wrapper nil ,*unedit-options*)
203 ("editors" ,#'mcvs-editors-wrapper nil ,*editors-options*)))
204
205 (defconstant *usage*
206 "Meta-CVS command syntax:
207
208 mcvs [ global-options] command [ command-options ] [ command-arguments ]
209
210 Global options:
211
212 -H --help Print this help and terminate. If a command is specified,
213 help specific to that command is printed instead.
214 -Q Very quiet, generate output only for serious problems. (*)
215 -q Somewhat quiet, some informational messages suppresed. (*)
216 -n Dry run; do not modify filesystem. (*)
217 --debug Verbose debug output; -Q and -q are ignored but still
218 passed to CVS.
219 -r Make working files read-only. (@)
220 -w Make new working files read-write (default). (@)
221 -l Do not log cvs command in command history, but execute
222 it anyway. (@)
223 -t Trace CVS execution. (@)
224 -v --version Display version information and terminate.
225 -f CVS not to read ~/.cvsrc file. (@)
226 -i script-name Load a Lisp file and evaluate its top level forms,
227 allowing Meta-CVS to behave as an interpreter.
228 --meta Include metafiles such as MCVS/MAP in the set of files
229 to operate on.
230 --metaonly Operate only on metafiles.
231 --nometa Exclude metafiles from the set of files to operate on.
232 --error-continue Instead of interactive error handling, automatically
233 continue all continuable errors.
234 --error-terminate Terminate without cleanup when an error happens instead
235 of interactive error handling (use with care).
236 -T tempdir Place temporary files in tempdir. (@)
237 -e editor Edit messages with editor. (*)
238 -d root Specify CVSROOT. (@)
239 -z gzip-level Specify compression level. (@)
240 --up N Escape out of N levels of sandbox nesting before executing
241 operation.
242
243 Notes: (*) option processed by Meta-CVS and passed to CVS too.
244 (@) option merely passed to CVS.
245
246 Commands:
247
248 help Obtain more detailed help for a specific command.
249 create Create new project from an existing file tree.
250 grab Take a snapshot of an external source tree, such
251 as a third-party release, and incorporate it into
252 the working copy. Tries to discover file moves.
253 checkout (co) Retrieve a Meta-CVS project from the repository to
254 create a working copy.
255 export (ex) Retrieve a Meta-CVS project without creating a
256 working copy.
257 add Place files (or directories with add -R) under
258 version control.
259 remove (rm) Remove files or directories.
260 move (mv) Rename files and directories.
261 link (ln) Create a versioned symbolic link.
262 update (up) Incorporate latest changes from repository into
263 working copy.
264 commit (ci) Incorporate outstanding changes in the working copy
265 into the repository.
266 diff Compute differences between files in the working copy
267 and the repository or between revisions in the repository.
268 tag Associate a symbolic name with file revisions to create
269 an identifiable baseline. By default, tags the
270 revisions that were last synchronized with the
271 directory. A branch is created using tag -b.
272 log Display log information for files.
273 status (stat) Show current status of files.
274 annotate Perform a detailed analysis of files, showing the
275 version information about every individual line of text.
276 filt (fi) Act as a text filter, which converts Meta-CVS F- file
277 names to readable paths, according to the current mapping.
278 branch Create a managed branch. Meta-CVS managed branches keep
279 track of what has been merged where, so users don't have
280 to track merges with tags at all.
281 merge Merge a managed branch to the current branch or trunk.
282 remerge Re-apply the most recent merge without changing any tags.
283 Useful when a merge goes bad so the local changes have
284 to be discarded and the merge done over again.
285 list-branches (lb) List Meta-CVS managed branches.
286 switch (sw) Switch to a branch. With no arguments, switch to
287 main trunk.
288 remap Force Meta-CVS to notice and incorporate moves and
289 deletions that were performed directly on the sandbox.
290 purge Execute a CVS remove on files that have been unmapped
291 with the remove command.
292 restore Restore files that have been deleted with the remove
293 command, but not purged. These appear in the lost+found
294 directory under cryptic names.
295 prop Manipulate properties.
296 prop --set <bool-prop-name> [ files ... ]
297 prop --clear <bool-prop-name> [ files ... ]
298 prop --value <prop-name> <new-value> [ files ... ]
299 prop --remove <prop-name> [ files ... ]
300 The ``exec'' property represents the execute permission
301 of a file. More than one --set, --clear, --value
302 or --remove may be specified before the files.
303 watch Manipulate per-file CVS watch settings.
304 watch --on [ files ... ]
305 watch --off [ files ... ]
306 watch --add <action> [ files ... ]
307 watch --remove <action> [ files ... ]
308 watchers See who is watching files.
309 edit Indicate the intent to edit a watched file.
310 unedit Retract the indication signaled by edit.
311 editors See who is editing files.
312 convert Convert a CVS module to a Meta-CVS project. This requires
313 filesystem-level access to the repository. This is
314 currently an experimental command that is known not
315 to work 100%.")
316
317 (defun mcvs-execute (args)
318 (handler-bind ((error #'mcvs-error-handler))
319 (multiple-value-bind (global-options global-args)
320 (parse-opt args *global-options*)
321 (setf global-options (filter-global-options global-options))
322
323 (when *print-usage*
324 (terpri)
325 (write-line *usage*)
326 (terpri)
327 (throw 'mcvs-terminate nil))
328
329 (when (not (first global-args))
330 (write-line "Meta-CVS requires a command argument.")
331 (write-line "Use mcvs -H to view help.")
332 (throw 'mcvs-terminate nil))
333
334 (let ((command (find (first global-args) *mcvs-command-table*
335 :key #'first
336 :test #'string=)))
337 (when (not command)
338 (error "~a is not a recognized mcvs command."
339 (first global-args)))
340 (destructuring-bind (name func help-text opt-spec) command
341 (declare (ignore name help-text))
342 (multiple-value-bind (command-options command-args)
343 (parse-opt (rest global-args) opt-spec)
344 (funcall func global-options command-options command-args))))))
345 nil)
346
347 (defun mcvs-debug-shell ()
348 (let ((counter 0)
349 (*mcvs-error-treatment* :decline))
350 (loop
351 (format t "~&mcvs[~a]> " (incf counter))
352 (let ((line (string-trim #(#\space #\tab) (read-line))))
353 (restart-case
354 (cond
355 ((zerop (length line)))
356 ((string-equal line "exit")
357 (return-from mcvs-debug-shell))
358 ((char-equal (char line 0) #\!)
359 (print (eval (read-from-string (subseq line 1)))))
360 (t (mcvs-execute (split-words line #(#\space #\tab)))))
361 (debug () :report "Return to mcvs debug shell"
362 (terpri)))))))
363
364 #+clisp
365 (defun mcvs ()
366 (exit (catch 'mcvs-terminate (or (mcvs-execute ext:*args*)
367 *mcvs-errors-occured-p*))))

  ViewVC Help
Powered by ViewVC 1.1.5