2023-07-27 14:04:50 -04:00
|
|
|
# Csope
|
|
|
|
|
Fork of Cscope, with various improvements, because cscope is good and shall not be forgotten.
|
2023-08-05 07:38:19 -04:00
|
|
|
While the originals mainentence seems abandoned and as far as I can tell you need a PhD in autoconf to compile the latest version,
|
|
|
|
|
Csope is alive and well.
|
2023-07-27 14:04:50 -04:00
|
|
|
|
2023-08-05 07:29:13 -04:00
|
|
|
# Usacases
|
|
|
|
|
Csope shines at exploring stranger and obsecure code bases due to its TUI.
|
2023-08-05 07:38:19 -04:00
|
|
|
It sometimes gets mislabeled as a code navigation tool, but the original documentation describes it best as a "code browsing tool".
|
|
|
|
|
Many tools can jump you to a definition or grep for patterns,
|
|
|
|
|
but Csope is unqie in that it allows for those and many other functionalities while providing you with a very comprehansible list of all results,
|
|
|
|
|
ready to fire up your editor at just the spot.
|
|
|
|
|
An example of its excelence is this project. The Cscope codebase used to be a total mess,
|
|
|
|
|
fixing it would have been a lost cause, if not for Cscope itself. Well, Csope now.
|
2023-08-05 07:29:13 -04:00
|
|
|
|
|
|
|
|
# Demo
|
|
|
|
|
TODO: fill in
|
2023-07-29 09:40:48 -04:00
|
|
|
|
|
|
|
|
# Interface
|
|
|
|
|
<-- Tab -->
|
2023-08-05 05:30:18 -04:00
|
|
|
+------------Message-------------+ +--------------------------------+
|
|
|
|
|
A |+--------------+---------------+| |+------------------------------+|
|
|
|
|
|
| || Input Window | Result window || || ||
|
|
|
|
|
| |+--------------+ || ? || ||
|
|
|
|
|
|| Mode Window | || ----> || Help ||
|
|
|
|
|
% || | || <---- || ||
|
|
|
|
|
|| | || ... || ||
|
|
|
|
|
| || | || || ||
|
|
|
|
|
| || | || || ||
|
|
|
|
|
V |+--------------+---------------+| |+------------------------------+|
|
|
|
|
|
+-----------Tool Tips------------+ +--------------------------------+
|
2023-08-05 07:29:13 -04:00
|
|
|
|
|
|
|
|
# Improvements/Changes
|
|
|
|
|
## User side
|
|
|
|
|
+ renamed the program, because "cscope" is annoying to type
|
|
|
|
|
+ improved gui /*pending*/
|
|
|
|
|
+ GNU Readline integration (ie. VI/EMACS mode, command history) /*pending*/
|
|
|
|
|
## To the code
|
|
|
|
|
+ nuked autoconf, replaced with single Makefile
|
|
|
|
|
+ removed "scanner.l" which seems to be an anchient version (and redundant copy) of "fscanner.l" forgotten by all
|
|
|
|
|
+ encapsulated changes to the TUI into display.c
|
|
|
|
|
+ removed macro hell put in place to allow compiling on a dead badger
|
|
|
|
|
+ replaced repeated inline #ifdef KEY_\*-s with guaranteed definitions
|
|
|
|
|
+ removed random commets giving tips for and refering to specific issues
|
|
|
|
|
+ use stdbool instead of YES/NO macros
|
|
|
|
|
+ saved kilobytes by stripping trailing whitespace
|
|
|
|
|
|
|
|
|
|
# Future features / contributor wishlist
|
|
|
|
|
+ providing support for other languages by integrating new lexers (e.g. ctag's)
|
