Annotation of src/usr.bin/cvs/cvsrc.5, Revision 1.6
1.6 ! xsa 1: .\" $OpenBSD: cvsrc.5,v 1.5 2005/06/11 12:15:44 joris Exp $
1.1 jfb 2: .\"
3: .\" Copyright (c) 2004 Jean-Francois Brousseau <jfb@openbsd.org>
4: .\" All rights reserved.
5: .\"
6: .\" Redistribution and use in source and binary forms, with or without
7: .\" modification, are permitted provided that the following conditions
8: .\" are met:
9: .\"
10: .\" 1. Redistributions of source code must retain the above copyright
11: .\" notice, this list of conditions and the following disclaimer.
12: .\" 2. The name of the author may not be used to endorse or promote products
13: .\" derived from this software without specific prior written permission.
14: .\"
15: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
16: .\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
17: .\" AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
18: .\" THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
19: .\" EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
20: .\" PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
21: .\" OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
22: .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
23: .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
24: .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25: .\"
26: .Dd June 14, 2004
27: .Dt CVSRC 5
28: .Os
29: .Sh NAME
30: .Nm cvsrc
31: .Nd startup resource file for CVS
32: .Sh DESCRIPTION
1.3 jmc 33: The
34: .Nm
35: file provides a way to give the
1.1 jfb 36: .Xr cvs 1
37: program implicit global options and command-specific options.
1.3 jmc 38: Unless the
1.1 jfb 39: .Fl f
1.3 jmc 40: option is specified,
41: .Xr cvs 1
42: reads its startup configuration file
43: .Pa .cvsrc
44: from the home directory of the user who invoked it.
1.1 jfb 45: .Pp
46: The format of each line is as follows:
47: .Pp
48: .Dl command [arg ...]
49: .Pp
50: where
51: .Ar command
1.4 joris 52: is either the
53: .Sq cvs
54: keyword to specify global options, one of the supported
1.1 jfb 55: .Xr cvs 1
56: commands or a command alias.
57: Arguments following
58: .Ar command
59: will be added implicitly to the appropriate command's argument vector if it is
60: run.
61: Lines whose
62: .Ar command
63: argument is not a valid command will generate a warning when running without
64: the
65: .Fl q
66: or
67: .Fl Q
68: flags.
1.5 joris 69: .Pp
70: Empty lines and lines specifying no optional arguments are ignored.
71: A line beginning with a hash character
72: .Pq Sq #
73: is considered a comment and ignored.
1.1 jfb 74: .Sh EXAMPLES
1.3 jmc 75: Specify that
76: .Xr cvs 1
77: should always run in quiet mode and the
78: .Ic diff
79: internal command should always produce unified output:
80: .Bd -literal -offset indent
81: cvs -q
82: diff -u
83: .Ed
1.1 jfb 84: .Sh SEE ALSO
1.6 ! xsa 85: .Xr cvs 1 ,
! 86: .Xr cvsintro 7