annotate runtime/doc/if_cscop.txt @ 12974:f7e78e142aa8

Added tag v8.0.1362 for changeset 418941f0df0894e1551f560ca04fd1d084a43022
author Christian Brabandt <cb@256bit.org>
date Fri, 01 Dec 2017 21:15:06 +0100
parents 45987b1b77dc
children 371ceeebbdaa
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
12968
45987b1b77dc Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 11659
diff changeset
1 *if_cscop.txt* For Vim version 8.0. Last change: 2017 Nov 23
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4 VIM REFERENCE MANUAL by Andy Kahn
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6 *cscope* *Cscope*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7 This document explains how to use Vim's cscope interface.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9 Cscope is a tool like ctags, but think of it as ctags on steroids since it
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10 does a lot more than what ctags provides. In Vim, jumping to a result from
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11 a cscope query is just like jumping to any tag; it is saved on the tag stack
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 so that with the right keyboard mappings, you can jump back and forth between
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13 functions as you normally would with |tags|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15 1. Cscope introduction |cscope-intro|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16 2. Cscope related commands |cscope-commands|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17 3. Cscope options |cscope-options|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18 4. How to use cscope in Vim |cscope-howtouse|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19 5. Limitations |cscope-limitations|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20 6. Suggested usage |cscope-suggestions|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
21 7. Availability & Information |cscope-info|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
22
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23 This is currently for Unix and Win32 only.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24 {Vi does not have any of these commands}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
26 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27 1. Cscope introduction *cscope-intro*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29 The following text is taken from a version of the cscope man page:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31 -----
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33 Cscope is an interactive screen-oriented tool that helps you:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35 Learn how a C program works without endless flipping through a thick
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36 listing.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38 Locate the section of code to change to fix a bug without having to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39 learn the entire program.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41 Examine the effect of a proposed change such as adding a value to an
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42 enum variable.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 Verify that a change has been made in all source files such as adding
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45 an argument to an existing function.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 Rename a global variable in all source files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49 Change a constant to a preprocessor symbol in selected lines of files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
50
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51 It is designed to answer questions like:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52 Where is this symbol used?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53 Where is it defined?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
54 Where did this variable get its value?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
55 What is this global symbol's definition?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
56 Where is this function in the source files?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
57 What functions call this function?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
58 What functions are called by this function?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
59 Where does the message "out of space" come from?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
60 Where is this source file in the directory structure?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
61 What files include this header file?
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
62
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
63 Cscope answers these questions from a symbol database that it builds the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
64 first time it is used on the source files. On a subsequent call, cscope
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
65 rebuilds the database only if a source file has changed or the list of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
66 source files is different. When the database is rebuilt the data for the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
67 unchanged files is copied from the old database, which makes rebuilding
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
68 much faster than the initial build.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
69
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
70 -----
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
71
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
72 When cscope is normally invoked, you will get a full-screen selection
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
73 screen allowing you to make a query for one of the above questions.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
74 However, once a match is found to your query and you have entered your
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
75 text editor to edit the source file containing match, you cannot simply
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
76 jump from tag to tag as you normally would with vi's Ctrl-] or :tag
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
77 command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
78
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
79 Vim's cscope interface is done by invoking cscope with its line-oriented
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
80 interface, and then parsing the output returned from a query. The end
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
81 result is that cscope query results become just like regular tags, so
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
82 you can jump to them just like you do with normal tags (Ctrl-] or :tag)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
83 and then go back by popping off the tagstack with Ctrl-T. (Please note
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
84 however, that you don't actually jump to a cscope tag simply by doing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
85 Ctrl-] or :tag without remapping these commands or setting an option.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
86 See the remaining sections on how the cscope interface works and for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
87 suggested use.)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
88
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
89
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
90 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
91 2. Cscope related commands *cscope-commands*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
92
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
93 *:cscope* *:cs* *:scs* *:scscope* *E259* *E262* *E561* *E560*
11659
49c12c93abf3 Updated runtime files and translations.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
94 All cscope commands are accessed through suboptions to the cscope commands.
49c12c93abf3 Updated runtime files and translations.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
95 `:cscope` or `:cs` is the main command
49c12c93abf3 Updated runtime files and translations.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
96 `:scscope` or `:scs` does the same and splits the window
49c12c93abf3 Updated runtime files and translations.
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
97 `:lcscope` or `:lcs` uses the location list, see |:lcscope|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
98
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
99 The available subcommands are:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
100
8951
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
101 *E563* *E564* *E566* *E568* *E622* *E623* *E625*
0bdeaf7092bc commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
102 *E626* *E609*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
103 add : Add a new cscope database/connection.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
104
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
105 USAGE :cs add {file|dir} [pre-path] [flags]
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
106
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
107 [pre-path] is the pathname used with the -P command to cscope.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
108
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
109 [flags] are any additional flags you want to pass to cscope.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
110
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
111 EXAMPLES >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
112 :cscope add /usr/local/cdb/cscope.out
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
113 :cscope add /projects/vim/cscope.out /usr/local/vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
114 :cscope add cscope.out /usr/local/vim -C
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
115 <
2596
fae782ef63dd Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
116 *cscope-find* *cs-find* *E567*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
117 find : Query cscope. All cscope query options are available
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
118 except option #5 ("Change this grep pattern").
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
119
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
120 USAGE :cs find {querytype} {name}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
121
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
122 {querytype} corresponds to the actual cscope line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
123 interface numbers as well as default nvi commands:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
124
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
125 0 or s: Find this C symbol
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
126 1 or g: Find this definition
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
127 2 or d: Find functions called by this function
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
128 3 or c: Find functions calling this function
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
129 4 or t: Find this text string
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
130 6 or e: Find this egrep pattern
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
131 7 or f: Find this file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
132 8 or i: Find files #including this file
9344
33c1b85d408c commit https://github.com/vim/vim/commit/802a0d902fca423acb15f835d7b09183883d79a0
Christian Brabandt <cb@256bit.org>
parents: 8951
diff changeset
133 9 or a: Find places where this symbol is assigned a value
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
134
1847
44fe912b5a1b updated for version 7.2-145
vimboss
parents: 1702
diff changeset
135 For all types, except 4 and 6, leading white space for {name} is
44fe912b5a1b updated for version 7.2-145
vimboss
parents: 1702
diff changeset
136 removed. For 4 and 6 there is exactly one space between {querytype}
44fe912b5a1b updated for version 7.2-145
vimboss
parents: 1702
diff changeset
137 and {name}. Further white space is included in {name}.
44fe912b5a1b updated for version 7.2-145
vimboss
parents: 1702
diff changeset
138
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
139 EXAMPLES >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
140 :cscope find c vim_free
1847
44fe912b5a1b updated for version 7.2-145
vimboss
parents: 1702
diff changeset
141 :cscope find 3 vim_free
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
142 <
1847
44fe912b5a1b updated for version 7.2-145
vimboss
parents: 1702
diff changeset
143 These two examples perform the same query: functions calling
44fe912b5a1b updated for version 7.2-145
vimboss
parents: 1702
diff changeset
144 "vim_free". >
44fe912b5a1b updated for version 7.2-145
vimboss
parents: 1702
diff changeset
145
44fe912b5a1b updated for version 7.2-145
vimboss
parents: 1702
diff changeset
146 :cscope find t initOnce
44fe912b5a1b updated for version 7.2-145
vimboss
parents: 1702
diff changeset
147 :cscope find t initOnce
44fe912b5a1b updated for version 7.2-145
vimboss
parents: 1702
diff changeset
148 <
44fe912b5a1b updated for version 7.2-145
vimboss
parents: 1702
diff changeset
149 The first one searches for the text "initOnce", the second one for
44fe912b5a1b updated for version 7.2-145
vimboss
parents: 1702
diff changeset
150 " initOnce". >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
151
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
152 :cscope find 0 DEFAULT_TERM
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
153 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
154 Executing this example on the source code for Vim 5.1 produces the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
155 following output:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
156
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
157 Cscope tag: DEFAULT_TERM
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
158 # line filename / context / line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
159 1 1009 vim-5.1-gtk/src/term.c <<GLOBAL>>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
160 #define DEFAULT_TERM (char_u *)"amiga"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
161 2 1013 vim-5.1-gtk/src/term.c <<GLOBAL>>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
162 #define DEFAULT_TERM (char_u *)"win32"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
163 3 1017 vim-5.1-gtk/src/term.c <<GLOBAL>>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
164 #define DEFAULT_TERM (char_u *)"pcterm"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
165 4 1021 vim-5.1-gtk/src/term.c <<GLOBAL>>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
166 #define DEFAULT_TERM (char_u *)"ansi"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
167 5 1025 vim-5.1-gtk/src/term.c <<GLOBAL>>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
168 #define DEFAULT_TERM (char_u *)"vt52"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
169 6 1029 vim-5.1-gtk/src/term.c <<GLOBAL>>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
170 #define DEFAULT_TERM (char_u *)"os2ansi"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
171 7 1033 vim-5.1-gtk/src/term.c <<GLOBAL>>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
172 #define DEFAULT_TERM (char_u *)"ansi"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
173 8 1037 vim-5.1-gtk/src/term.c <<GLOBAL>>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
174 # undef DEFAULT_TERM
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
175 9 1038 vim-5.1-gtk/src/term.c <<GLOBAL>>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
176 #define DEFAULT_TERM (char_u *)"beos-ansi"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
177 10 1042 vim-5.1-gtk/src/term.c <<GLOBAL>>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
178 #define DEFAULT_TERM (char_u *)"mac-ansi"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
179 11 1335 vim-5.1-gtk/src/term.c <<set_termname>>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
180 term = DEFAULT_TERM;
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
181 12 1459 vim-5.1-gtk/src/term.c <<set_termname>>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
182 if (STRCMP(term, DEFAULT_TERM))
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
183 13 1826 vim-5.1-gtk/src/term.c <<termcapinit>>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
184 term = DEFAULT_TERM;
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
185 14 1833 vim-5.1-gtk/src/term.c <<termcapinit>>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
186 term = DEFAULT_TERM;
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
187 15 3635 vim-5.1-gtk/src/term.c <<update_tcap>>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
188 p = find_builtin_term(DEFAULT_TERM);
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
189 Enter nr of choice (<CR> to abort):
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
190
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
191 The output shows several pieces of information:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
192 1. The tag number (there are 15 in this example).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
193 2. The line number where the tag occurs.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
194 3. The filename where the tag occurs.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
195 4. The context of the tag (e.g., global, or the function name).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
196 5. The line from the file itself.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
197
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
198 help : Show a brief synopsis.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
199
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
200 USAGE :cs help
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
201
2596
fae782ef63dd Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
202 *E261*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
203 kill : Kill a cscope connection (or kill all cscope connections).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
204
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
205 USAGE :cs kill {num|partial_name}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
206
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
207 To kill a cscope connection, the connection number or a partial
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
208 name must be specified. The partial name is simply any part of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
209 the pathname of the cscope database. Kill a cscope connection
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
210 using the partial name with caution!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
211
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
212 If the specified connection number is -1, then _ALL_ cscope
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
213 connections will be killed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
214
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
215 reset : Reinit all cscope connections.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
216
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
217 USAGE :cs reset
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
218
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
219 show : Show cscope connections.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
220
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
221 USAGE :cs show
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
222
665
21ab9abf0f08 updated for version 7.0196
vimboss
parents: 236
diff changeset
223 *:lcscope* *:lcs*
21ab9abf0f08 updated for version 7.0196
vimboss
parents: 236
diff changeset
224 This command is same as the ":cscope" command, except when the
21ab9abf0f08 updated for version 7.0196
vimboss
parents: 236
diff changeset
225 'cscopequickfix' option is set, the location list for the current window is
21ab9abf0f08 updated for version 7.0196
vimboss
parents: 236
diff changeset
226 used instead of the quickfix list to show the cscope results.
21ab9abf0f08 updated for version 7.0196
vimboss
parents: 236
diff changeset
227
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
228 *:cstag* *E257* *E562*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
229 If you use cscope as well as ctags, |:cstag| allows you to search one or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
230 the other before making a jump. For example, you can choose to first
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
231 search your cscope database(s) for a match, and if one is not found, then
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
232 your tags file(s) will be searched. The order in which this happens
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
233 is determined by the value of |csto|. See |cscope-options| for more
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
234 details.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
235
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
236 |:cstag| performs the equivalent of ":cs find g" on the identifier when
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
237 searching through the cscope database(s).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
238
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
239 |:cstag| performs the equivalent of |:tjump| on the identifier when searching
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
240 through your tags file(s).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
241
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
242
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
243 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
244 3. Cscope options *cscope-options*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
245
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
246 Use the |:set| command to set all cscope options. Ideally, you would do
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
247 this in one of your startup files (e.g., .vimrc). Some cscope related
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
248 variables are only valid within |.vimrc|. Setting them after vim has
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
249 started will have no effect!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
250
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
251 *cscopeprg* *csprg*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
252 'cscopeprg' specifies the command to execute cscope. The default is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
253 "cscope". For example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
254 :set csprg=/usr/local/bin/cscope
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
255 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
256 *cscopequickfix* *csqf* *E469*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
257 {not available when compiled without the |+quickfix| feature}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
258 'cscopequickfix' specifies whether to use quickfix window to show cscope
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 147
diff changeset
259 results. This is a list of comma-separated values. Each item consists of
9344
33c1b85d408c commit https://github.com/vim/vim/commit/802a0d902fca423acb15f835d7b09183883d79a0
Christian Brabandt <cb@256bit.org>
parents: 8951
diff changeset
260 |cscope-find| command (s, g, d, c, t, e, f, i or a) and flag (+, - or 0).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
261 '+' indicates that results must be appended to quickfix window,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
262 '-' implies previous results clearance, '0' or command absence - don't use
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 147
diff changeset
263 quickfix. Search is performed from start until first command occurrence.
4707450c2b33 updated for version 7.0066
vimboss
parents: 147
diff changeset
264 The default value is "" (don't use quickfix anyway). The following value
33
f6033dcbaf31 updated for version 7.0020
vimboss
parents: 20
diff changeset
265 seems to be useful: >
9344
33c1b85d408c commit https://github.com/vim/vim/commit/802a0d902fca423acb15f835d7b09183883d79a0
Christian Brabandt <cb@256bit.org>
parents: 8951
diff changeset
266 :set cscopequickfix=s-,c-,d-,i-,t-,e-,a-
33
f6033dcbaf31 updated for version 7.0020
vimboss
parents: 20
diff changeset
267 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
268 *cscopetag* *cst*
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2873
diff changeset
269 If 'cscopetag' is set, the commands ":tag" and CTRL-] as well as "vim -t"
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2873
diff changeset
270 will always use |:cstag| instead of the default :tag behavior. Effectively,
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2873
diff changeset
271 by setting 'cst', you will always search your cscope databases as well as
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2873
diff changeset
272 your tag files. The default is off. Examples: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
273 :set cst
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
274 :set nocst
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
275 <
2873
eeb1ac4f66d1 updated for version 7.3.210
Bram Moolenaar <bram@vim.org>
parents: 2596
diff changeset
276 *cscoperelative* *csre*
2908
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2873
diff changeset
277 If 'cscoperelative' is set, then in absence of a prefix given to cscope
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2873
diff changeset
278 (prefix is the argument of -P option of cscope), basename of cscope.out
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2873
diff changeset
279 location (usually the project root directory) will be used as the prefix
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2873
diff changeset
280 to construct an absolute path. The default is off. Note: This option is
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2873
diff changeset
281 only effective when cscope (cscopeprg) is initialized without a prefix
fd09a9c8468e Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2873
diff changeset
282 path (-P). Examples: >
2873
eeb1ac4f66d1 updated for version 7.3.210
Bram Moolenaar <bram@vim.org>
parents: 2596
diff changeset
283 :set csre
eeb1ac4f66d1 updated for version 7.3.210
Bram Moolenaar <bram@vim.org>
parents: 2596
diff changeset
284 :set nocsre
eeb1ac4f66d1 updated for version 7.3.210
Bram Moolenaar <bram@vim.org>
parents: 2596
diff changeset
285 <
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
286 *cscopetagorder* *csto*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
287 The value of 'csto' determines the order in which |:cstag| performs a search.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
288 If 'csto' is set to zero, cscope database(s) are searched first, followed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
289 by tag file(s) if cscope did not return any matches. If 'csto' is set to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
290 one, tag file(s) are searched before cscope database(s). The default is zero.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
291 Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
292 :set csto=0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
293 :set csto=1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
294 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
295 *cscopeverbose* *csverb*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
296 If 'cscopeverbose' is not set (the default), messages will not be printed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
297 indicating success or failure when adding a cscope database. Ideally, you
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
298 should reset this option in your |.vimrc| before adding any cscope databases,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
299 and after adding them, set it. From then on, when you add more databases
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
300 within Vim, you will get a (hopefully) useful message should the database fail
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
301 to be added. Examples: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
302 :set csverb
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
303 :set nocsverb
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
304 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
305 *cscopepathcomp* *cspc*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
306 The value of 'cspc' determines how many components of a file's path to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
307 display. With the default value of zero the entire path will be displayed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
308 The value one will display only the filename with no path. Other values
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
309 display that many components. For example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
310 :set cspc=3
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
311 will display the last 3 components of the file's path, including the file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
312 name itself.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
313
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
314 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
315 4. How to use cscope in Vim *cscope-howtouse*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
316
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
317 The first thing you need to do is to build a cscope database for your
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
318 source files. For the most basic case, simply do "cscope -b". Please
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
319 refer to the cscope man page for more details.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
320
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
321 Assuming you have a cscope database, you need to "add" the database to Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
322 This establishes a cscope "connection" and makes it available for Vim to use.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
323 You can do this in your .vimrc file, or you can do it manually after starting
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
324 vim. For example, to add the cscope database "cscope.out", you would do:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
325
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
326 :cs add cscope.out
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
327
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
328 You can double-check the result of this by executing ":cs show". This will
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
329 produce output which looks like this:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
330
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
331 # pid database name prepend path
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
332 0 28806 cscope.out <none>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
333
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
334 Note:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
335 Because of the Microsoft RTL limitations, Win32 version shows 0 instead
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
336 of the real pid.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
337
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
338 Once a cscope connection is established, you can make queries to cscope and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
339 the results will be printed to you. Queries are made using the command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
340 ":cs find". For example:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
341
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
342 :cs find g ALIGN_SIZE
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
343
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
344 This can get a little cumbersome since one ends up doing a significant
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
345 amount of typing. Fortunately, there are ways around this by mapping
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
346 shortcut keys. See |cscope-suggestions| for suggested usage.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
347
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
348 If the results return only one match, you will automatically be taken to it.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
349 If there is more than one match, you will be given a selection screen to pick
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
350 the match you want to go to. After you have jumped to the new location,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
351 simply hit Ctrl-T to get back to the previous one.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
352
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
353
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
354 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
355 5. Limitations *cscope-limitations*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
356
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
357 Cscope support for Vim is only available on systems that support these four
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
358 system calls: fork(), pipe(), execl(), waitpid(). This means it is mostly
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
359 limited to Unix systems.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
360
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
361 Additionally Cscope support works for Win32. For more information and a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
362 cscope version for Win32 see:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
363
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
364 http://iamphet.nm.ru/cscope/index.html
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
365
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
366 The DJGPP-built version from http://cscope.sourceforge.net is known to not
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
367 work with Vim.
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
368
1931
3f661e42f262 updated for version 7.2-228
vimboss
parents: 1847
diff changeset
369 Hard-coded limitation: doing a |:tjump| when |:cstag| searches the tag files
3f661e42f262 updated for version 7.2-228
vimboss
parents: 1847
diff changeset
370 is not configurable (e.g., you can't do a tselect instead).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
371
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
372 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
373 6. Suggested usage *cscope-suggestions*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
374
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
375 Put these entries in your .vimrc (adjust the pathname accordingly to your
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
376 setup): >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
377
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
378 if has("cscope")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
379 set csprg=/usr/local/bin/cscope
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
380 set csto=0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
381 set cst
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
382 set nocsverb
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
383 " add any database in current directory
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
384 if filereadable("cscope.out")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
385 cs add cscope.out
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
386 " else add database pointed to by environment
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
387 elseif $CSCOPE_DB != ""
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
388 cs add $CSCOPE_DB
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
389 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
390 set csverb
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
391 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
392
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
393 By setting 'cscopetag', we have effectively replaced all instances of the :tag
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
394 command with :cstag. This includes :tag, Ctrl-], and "vim -t". In doing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
395 this, the regular tag command not only searches your ctags generated tag
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
396 files, but your cscope databases as well.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
397
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
398 Some users may want to keep the regular tag behavior and have a different
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
399 shortcut to access :cstag. For example, one could map Ctrl-_ (underscore)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
400 to :cstag with the following command: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
401
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
402 map <C-_> :cstag <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
403
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
404 A couple of very commonly used cscope queries (using ":cs find") is to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
405 find all functions calling a certain function and to find all occurrences
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
406 of a particular C symbol. To do this, you can use these mappings as an
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
407 example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
408
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
409 map g<C-]> :cs find 3 <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
410 map g<C-\> :cs find 0 <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
411
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
412 These mappings for Ctrl-] (right bracket) and Ctrl-\ (backslash) allow you to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
413 place your cursor over the function name or C symbol and quickly query cscope
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
414 for any matches.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
415
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
416 Or you may use the following scheme, inspired by Vim/Cscope tutorial from
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
417 Cscope Home Page (http://cscope.sourceforge.net/): >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
418
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
419 nmap <C-_>s :cs find s <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
420 nmap <C-_>g :cs find g <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
421 nmap <C-_>c :cs find c <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
422 nmap <C-_>t :cs find t <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
423 nmap <C-_>e :cs find e <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
424 nmap <C-_>f :cs find f <C-R>=expand("<cfile>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
425 nmap <C-_>i :cs find i ^<C-R>=expand("<cfile>")<CR>$<CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
426 nmap <C-_>d :cs find d <C-R>=expand("<cword>")<CR><CR>
9344
33c1b85d408c commit https://github.com/vim/vim/commit/802a0d902fca423acb15f835d7b09183883d79a0
Christian Brabandt <cb@256bit.org>
parents: 8951
diff changeset
427 nmap <C-_>a :cs find a <C-R>=expand("<cword>")<CR><CR>
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
428
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
429 " Using 'CTRL-spacebar' then a search type makes the vim window
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
430 " split horizontally, with search result displayed in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
431 " the new window.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
432
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
433 nmap <C-Space>s :scs find s <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
434 nmap <C-Space>g :scs find g <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
435 nmap <C-Space>c :scs find c <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
436 nmap <C-Space>t :scs find t <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
437 nmap <C-Space>e :scs find e <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
438 nmap <C-Space>f :scs find f <C-R>=expand("<cfile>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
439 nmap <C-Space>i :scs find i ^<C-R>=expand("<cfile>")<CR>$<CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
440 nmap <C-Space>d :scs find d <C-R>=expand("<cword>")<CR><CR>
9344
33c1b85d408c commit https://github.com/vim/vim/commit/802a0d902fca423acb15f835d7b09183883d79a0
Christian Brabandt <cb@256bit.org>
parents: 8951
diff changeset
441 nmap <C-Space>a :scs find a <C-R>=expand("<cword>")<CR><CR>
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
442
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
443 " Hitting CTRL-space *twice* before the search type does a vertical
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
444 " split instead of a horizontal one
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
445
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
446 nmap <C-Space><C-Space>s
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
447 \:vert scs find s <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
448 nmap <C-Space><C-Space>g
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
449 \:vert scs find g <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
450 nmap <C-Space><C-Space>c
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
451 \:vert scs find c <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
452 nmap <C-Space><C-Space>t
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
453 \:vert scs find t <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
454 nmap <C-Space><C-Space>e
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
455 \:vert scs find e <C-R>=expand("<cword>")<CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
456 nmap <C-Space><C-Space>i
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
457 \:vert scs find i ^<C-R>=expand("<cfile>")<CR>$<CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
458 nmap <C-Space><C-Space>d
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
459 \:vert scs find d <C-R>=expand("<cword>")<CR><CR>
9344
33c1b85d408c commit https://github.com/vim/vim/commit/802a0d902fca423acb15f835d7b09183883d79a0
Christian Brabandt <cb@256bit.org>
parents: 8951
diff changeset
460 nmap <C-Space><C-Space>a
33c1b85d408c commit https://github.com/vim/vim/commit/802a0d902fca423acb15f835d7b09183883d79a0
Christian Brabandt <cb@256bit.org>
parents: 8951
diff changeset
461 \:vert scs find a <C-R>=expand("<cword>")<CR><CR>
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
462
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
463 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
464 7. Cscope availability and information *cscope-info*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
465
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
466 If you do not already have cscope (it did not come with your compiler
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
467 license or OS distribution), then you can download it for free from:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
468 http://cscope.sourceforge.net/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
469 This is released by SCO under the BSD license.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
470
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
471 In Solaris 2.x, if you have the C compiler license, you will also have
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
472 cscope. Both are usually located under /opt/SUNWspro/bin
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
473
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
474 There is source to an older version of a cscope clone (called "cs") available
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
475 on the net. Due to various reasons, this is not supported with Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
476
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
477 The cscope interface/support for Vim was originally written by
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
478 Andy Kahn <ackahn@netapp.com>. The original structure (as well as a tiny
12968
45987b1b77dc Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 11659
diff changeset
479 bit of code) was adapted from the cscope interface in nvi.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
480 *cscope-win32*
12968
45987b1b77dc Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 11659
diff changeset
481 For a cscope version for Win32 see (seems abandonded):
45987b1b77dc Update runtime files
Christian Brabandt <cb@256bit.org>
parents: 11659
diff changeset
482 https://code.google.com/archive/p/cscope-win32/
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
483
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 147
diff changeset
484 Win32 support was added by Sergey Khorev <sergey.khorev@gmail.com>. Contact
147
2f5a3b881ada updated for version 7.0046
vimboss
parents: 33
diff changeset
485 him if you have Win32-specific issues.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
486
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
487 vim:tw=78:ts=8:ft=help:norl: