![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to vgrindefs.5 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / man / man5|
Return to vgrindefs.5 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / man / man5 |
1.1 root 1: .\" Copyright (c) 1983 Regents of the University of California.
2: .\" All rights reserved. The Berkeley software License Agreement
3: .\" specifies the terms and conditions for redistribution.
4: .\"
5: .\" @(#)vgrindefs.5 6.2 (Berkeley) 9/30/87
6: .\"
7: .tr ||
8: .TH VGRINDEFS 5 "September 30, 1987"
9: .UC 5
10: .SH NAME
11: vgrindefs \- vgrind's language definition data base
12: .SH SYNOPSIS
13: .B /usr/lib/vgrindefs
14: .SH DESCRIPTION
15: .I Vgrindefs
16: contains all language definitions for vgrind. The data base is
17: very similar to
18: .IR termcap (5).
19: .SH FIELDS
20: The following table names and describes each field.
21: .PP
22: .nf
23: .ta \w'k0-k9 'u +\w'Type 'u
24: \fBName Type Description\fR
25: pb str regular expression for start of a procedure
26: bb str regular expression for start of a lexical block
27: be str regular expression for the end of a lexical block
28: cb str regular expression for the start of a comment
29: ce str regular expression for the end of a comment
30: sb str regular expression for the start of a string
31: se str regular expression for the end of a string
32: lb str regular expression for the start of a character constant
33: le str regular expression for the end of a character constant
34: tl bool present means procedures are only defined at the top
35: lexical level
36: oc bool present means upper and lower case are equivalent
37: kw str a list of keywords separated by spaces
38: .fi
39: .PP
40: .B Example
41: .PP
42: The following entry, which describes the C language, is
43: typical of a language entry.
44: .PP
45: .nf
46: C|c:\
47: :pb=^\ed?*?\ed?\ep\ed?\(\ea?\):bb={:be=}:cb=/*:ce=*/:sb=":se=\ee":\e
48: :lb=':le=\ee':tl:\e
49: :kw=asm auto break case char continue default do double else enum\e
50: extern float for fortran goto if int long register return short\e
51: sizeof static struct switch typedef union unsigned while #define\e
52: #else #endif #if #ifdef #ifndef #include #undef # define else endif\e
53: if ifdef ifndef include undef:
54: .fi
55: .PP
56: Note that the first field is just the language name (and any variants
57: of it). Thus the C language could be specified to
58: .IR vgrind (1)
59: as "c" or "C".
60: .PP
61: Entries may continue onto multiple lines by giving a \e as the last
62: character of a line.
63: Capabilities in
64: .I vgrindefs
65: are of two types:
66: Boolean capabilities which indicate that the language has
67: some particular feature
68: and string
69: capabilities which give a regular expression or
70: keyword list.
71: .PP
72: .B REGULAR EXPRESSIONS
73: .PP
74: .I Vgrindefs
75: uses regular expression which are very similar to those of
76: .IR ex (1)
77: and
78: .IR lex (1).
79: The characters `^', `$', `:' and `\e'
80: are reserved characters and must be
81: "quoted" with a preceding \e if they
82: are to be included as normal characters.
83: The metasymbols and their meanings are:
84: .IP $
85: the end of a line
86: .IP ^
87: the beginning of a line
88: .IP \ed
89: a delimiter (space, tab, newline, start of line)
90: .IP \ea
91: matches any string of symbols (like .* in lex)
92: .IP \ep
93: matches any alphanumeric name. In a procedure definition (pb) the string
94: that matches this symbol is used as the procedure name.
95: .IP ()
96: grouping
97: .IP |
98: alternation
99: .IP ?
100: last item is optional
101: .IP \ee
102: preceding any string means that the string will not match an
103: input string if the input string is preceded by an escape character (\e).
104: This is typically used for languages (like C) which can include the
105: string delimiter in a string by escaping it.
106: .PP
107: Unlike other regular expressions in the system, these match words
108: and not characters. Hence something like "(tramp|steamer)flies?"
109: would match "tramp", "steamer", "trampflies", or "steamerflies".
110: .PP
111: .B KEYWORD LIST
112: .PP
113: The keyword list is just a list of keywords in the language separated
114: by spaces. If the "oc" boolean is specified, indicating that upper
115: and lower case are equivalent, then all the keywords should be
116: specified in lower case.
117: .SH FILES
118: .DT
119: /usr/lib/vgrindefs file containing terminal descriptions
120: .SH SEE ALSO
121: vgrind(1), troff(1)
122: .SH AUTHOR
123: Dave Presotto
124: .SH BUGS
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.