63 lines
3.3 KiB
Markdown
63 lines
3.3 KiB
Markdown
# Csope
|
|
Fork of Cscope, with various improvements, because cscope is good and shall not be forgotten.
|
|
While the original's 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.
|
|
|
|
# Usacases
|
|
Csope shines at exploring stranger and obsecure code bases due to its TUI.
|
|
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.
|
|
|
|
# Demo
|
|
TODO: fill in
|
|
|
|
# Before/After
|
|
TODO: fill in
|
|
|
|
# Interface
|
|
<-- Tab -->
|
|
+------------Message-------------+ +--------------------------------+
|
|
A |+--------------+---------------+| |+------------------------------+|
|
|
| || Input Window | Result window || || ||
|
|
| |+--------------+ || ? || ||
|
|
|| Mode Window | || ----> || Help ||
|
|
% || | || <---- || ||
|
|
|| | || ... || ||
|
|
| || | || || ||
|
|
| || | || || ||
|
|
V |+--------------+---------------+| |+------------------------------+|
|
|
+-----------Tool Tips------------+ +--------------------------------+
|
|
|
|
# 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
|
|
+ FILE\* refsfound used to be rewind()-ed everytime the reads were not sequencial
|
|
|
|
# Project structure /*probably move to documentation*/
|
|
| Component | Purpose |
|
|
| :-------: | :-----: |
|
|
| main.c | generic init functions, main() and primary event loops (and junk)
|
|
| display.c | all functions directly dealing with NCurses |
|
|
| input.c | top layer of functions dealing with user input; migth dispatch to readline |
|
|
| globals.h | an inherited curse; global var/prototype hell |
|
|
| readline.c | all functions directly dealing with GNU Readline; responsible for line editing in *input mode* |
|
|
| help.c | all functions dealing with help messages |
|
|
|
|
# Future features / contributor wishlist
|
|
+ providing support for other languages by integrating new lexers (e.g. ctag's)
|