diff options
Diffstat (limited to 'docs/internals/cscope.NOTES')
-rw-r--r-- | docs/internals/cscope.NOTES | 142 |
1 files changed, 0 insertions, 142 deletions
diff --git a/docs/internals/cscope.NOTES b/docs/internals/cscope.NOTES deleted file mode 100644 index e0e3483d26edf..0000000000000 --- a/docs/internals/cscope.NOTES +++ /dev/null @@ -1,142 +0,0 @@ -Cscope Notes: - -The nvi tags structure has been reworked to handle the notion of multiple -locations per tag. This supports cscope, which returns multiple locations -per query. It will hopefully support ctags programs that create databases -with multiple locations per tag as well. - -There is now a list of "tag queues" chained from each screen. Each tag -queue has one or more "tag locations". - - +----+ +----+ +----+ +----+ - | EP | -> | Q1 | <-- | T1 | <-- | T2 | - +----+ +----+ --> +----+ --> +----+ - | - +----+ +----+ - | Q2 | <-- | T1 | - +----+ --> +----+ - | - +----+ +----+ - | Q3 | <-- | T1 | - +----+ --> +----+ - -In the above diagram, each "Q" is a "tag queue", and each "T" is a -tag location. Generally, the commands: - - :tag create a new Q - ^[ create a new Q - :cscope find create a new Q - :tagnext move to the next T - :tagprev move to the previous T - :tagpop discard one or more Q's - ^T discard the most recent Q - :tagtop discard all Q's - -More specifically: - -:cs[cope] a[dd] cscope-dir - - Attach to the cscope database in cscope-dir. - -:cs[cope] f[ind] c|d|e|f|g|i|s|t buffer|pattern - - Query all attached cscopes for the pattern. The pattern is a - regular expression. If the pattern is a double-quote character - followed by a valid buffer name (e.g., "t), then the contents - of the named buffer are used as the pattern. - - c: find callers of name - d: find all function calls made from name - e: find pattern - f: find files with name as substring - g: find definition of name - i: find files #including name - s: find all uses of name - t: find assignments to name - - The find command pushes the current location onto the tags stack, - and switches to the first location resulting from the query, if - the query returned at least one result. - -:cs[cope] h[elp] [command] - - List the cscope commands, or usage help on one command. - -:display c[onnections] - - Display the list of cscope connections - -:display t[ags] - - The tags display has been enhanced to display multiple tag - locations per tag query. - -:cs[cope] k[ill] # - - Kill cscope connection number #. - -:cs[cope] r[eset] - Kill all attached cscopes. Useful if one got hung but you don't - know which one. - -:tagn[ext][!] - - Move to the next tag resulting from a query. - -:tagpr[ev][!] - - Return to the previous tag resulting from a query. - -:tagp[op], ^T - - Return to the previous tag group (no change). - -:tagt[op] - - Discard all tag groups (no change). - -Suggested maps: - - " ^N: move to the next tag - map ^N :tagnext^M - " ^P: move to the previous tag - map ^P :tagprev^M - - " Tab+letter performs a C-Scope query on the current word. - " C-Scope 12.9 has a text-string query (type t). - " C-Scope 13.3 replaces it with an assignment query; hence a==t. - map <tab>a "tye:csc find t"t
- map <tab>c "tye:csc find c"t
- map <tab>d "tye:csc find d"t
- map <tab>e "tye:csc find e"t
- map <tab>f "tye:csc find f"t
- map <tab>g "tye:csc find g"t
- map <tab>i "tye:csc find i"t
- map <tab>s "tye:csc find s"t
- map <tab>t "tye:csc find t"t
- -To start nvi with an initial set of cscope directories, use the environment -variable CSCOPE_DIRS. This variable should contain a <blank>-separated -list of directories containing cscope databases. (This MAY be changed to -be an edit option, I haven't really decided, yet.) - -Each cscope directory must contain a file named "cscope.out" which is the -main cscope database, or nvi will not attempt to connect to a cscope to -handle requests for that database. - -The file "cscope.tpath" may contain a colon-separated directory search -path which will be used to find the files reported by cscope. If this -cscope.tpath does not exist, then the paths are assumed to be relative to -the cscope directory itself. This is an extension to the standard cscope, -but seems important enough to keep. - -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= -Cscope Availability: - -UNIXWare System V Release 4.0 variants such as Sun Solaris 2.x -(/opt/SUNWspro/bin) have version 11.5, and UNIXWare System V -Release 4.1 has version 12.10 with an option for much faster -searching. - -You can buy version 13.3 source with an unrestricted license -for $400 from AT&T Software Solutions by calling +1-800-462-8146. |