/[meta-cvs]/meta-cvs/F-F1216688DF5C31C04736DBD403342A77
ViewVC logotype

Contents of /meta-cvs/F-F1216688DF5C31C04736DBD403342A77

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.3 - (hide annotations)
Mon Jan 28 00:30:06 2002 UTC (12 years, 2 months ago) by kaz
Branch: MAIN
Changes since 1.2: +5 -3 lines
Adding cute little quote.
1 kaz 1.1 A Quick Guide to Using MCVS
2    
3     Kaz Kylheku
4     January 25, 2002
5    
6 kaz 1.3 "Anything you can do, I can do meta." -- origin unknown
7    
8 kaz 1.1
9     Contents
10    
11 kaz 1.3 1. Introduction . . . . . . . . . . . . . . . . . . . . . . Line 15
12     2. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
13     3. Filtering F- Names to Readable Names . . . . . . . . . . . . 63
14 kaz 1.1
15     1. Introduction
16    
17     This is a guide toward using MCVS. It assumes familiarity with
18     version control concepts and in particular with the CVS software.
19     In particular, it is assumed that you have hands-on
20     experience with CVS and that you have read the Cederqvist manual.
21    
22     In principle, MCVS could be understood as a version control
23     tool independently of CVS; in practice it helps to know CVS,
24     particularly because MCVS is relatively new software, and because
25     it is not intended to perfectly hide CVS from the user.
26    
27     It is also assumed that you have successfully installed MCVS.
28     For installation instructions see the file INSTALL.
29    
30     To gain some understanding of how MCVS represents your data and
31     how it works, read MCVS-PAPER.
32    
33    
34     2. Overview
35    
36     MCVS has a command syntax that is deliberately similar to
37     the CVS command syntax. In general, a MCVS command looks like
38     this:
39    
40     mcvs [ mcvs-options ] command [ command-options ] [ arguments ]
41    
42     Most of the options are simply passed through to CVS, when
43     appropriate. So for example,
44    
45     mcvs -z3 update -A
46    
47     will pass through the -z3 and -A options down to CVS when invoking
48     it, so that CVS ends up being called as:
49    
50     cvs -z3 update -A
51    
52     This passing through of options makes it easy to use MCVS for
53     users who are familiar with CVS, and is also straightforward to
54     deal with in the bowels of MCVS.
55    
56     Not all options are passed through to CVS, and there are some that
57     are entirely MCVS-specific. Think of MCVS as implementing an
58     intelligent filter over the CVS options. For example, if you
59     invoke ``mcvs --help'', you don't want ``cvs --help'' to be
60     called. [TODO: intelligent filtering not implemented yet.]
61 kaz 1.2
62    
63     3. Filtering F- Names to Readable Names
64    
65     The MCVS representation brings a readability problem: the
66     cryptic F- names appear in the output produced by CVS, making
67     it difficult to understand what file the output pertains to.
68     For this reason, MCVS includes a filtering command (``mcvs filt'')
69     which can be used in a pipe to filter out the cryptic names
70     and replace them with the paths that they map to. For example:
71    
72     mcvs diff | mcvs filt
73    
74     produces a human-readable diff.
75    
76     The filter works by looking for character sequences consisting
77     of the prefix ``F-'' followed by exactly 32 hex digits.
78     If such a sequence is mapped in the MAP-LOCAL file, then it
79     is replaced by its mapping. Anything which doesn't match or
80     doesn't map is passed through unchanged.

  ViewVC Help
Powered by ViewVC 1.1.5