diff --git a/README.md b/README.md index 0359172..3959a0f 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,16 @@ # Csope Fork of Cscope, with various improvements, because cscope is good and shall not be forgotten. +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. # Usacases Csope shines at exploring stranger and obsecure code bases due to its TUI. -Cscope used to be advertized a -For example, the Cscope codebase used to be a total mess, -fixing it would have been a lost cause, if not for Cscope itself. +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 diff --git a/docs/original_site_-_Cscope_Home_Page.html b/docs/original_site_-_Cscope_Home_Page.html new file mode 100644 index 0000000..24f4788 --- /dev/null +++ b/docs/original_site_-_Cscope_Home_Page.html @@ -0,0 +1,341 @@ + + + + + +
SourceForge Project Page is here +
+
+ |
++ |
+ |
+
+ Cscope is a developer's tool for browsing source code. It has an
+ impeccable Unix pedigree, having been originally
+ developed at Bell Labs back in the days of the PDP-11. Cscope was
+ part of the official AT&T Unix distribution for many years, and has been
+ used to manage projects involving 20 million lines of code!
+
+ In April, 2000, thanks to the Santa Cruz + Operation, Inc. (SCO) (since merged with Caldera), the code for Cscope was open sourced + under the BSD license. + |
+
+ |
++ |
+ |
+
+
++
|
+
+ |
+ Screen shot of cscope in action: + |
+ |
++C symbol: atoi + + File Function Line + 0 stdlib.h <global> 86 extern int atoi (const char *nptr); + 1 dir.c makefilelist 336 dispcomponents = atoi(s); + 2 invlib.c invdump 793 j = atoi(term + 1); + 3 invlib.c invdump 804 j = atoi(term + 1); + 4 main.c main 287 dispcomponents = atoi(s); + 5 main.c main 500 dispcomponents = atoi(s); + 6 stdlib.h atoi 309 int atoi (const char *nptr) __THROW + + + + Find this C symbol: + Find this global definition: + Find functions called by this function: + Find functions calling this function: + Find this text string: + Change this text string: + Find this egrep pattern: + Find this file: + Find files #including this file: ++ |
+
+ |
++ |
+ |
+ Using Cscope on large projects (example: the Linux kernel) + +Using Cscope with Vim --- translated to Chinese (external link) + |
+ |
++ |
+ |
+ Cscope support is built into Vim (so long
+ as it is compiled with the '--enable-cscope' option--this is the case for
+ most binary distributions). The Vim interface, and a set of key mappings
+ you may find useful, is documented in our Vim/Cscope Tutorial.
+ The Berkeley Vi editor (nvi) also + works with cscope. + |
+ |
++ |
+ |
+
+ The XEmacs interface to cscope (which
+ also works with GNU
+ Emacs) is located in the subdirectory, cscope/contrib/xcscope/.
+
The source files contain all the installation and usage info you need to get started. + (Please contact Darryl Okahata for any queries regarding the XEmacs support.) + |
+
+ |
+ + |
+ + |
+ Cscope requires use of the (traditionally Unix-only) curses
+ screen-drawing library, so some form of curses support is needed to run
+ it on DOS or Windows.
+
+ Our download files include a zip file that contains a Cscope binary + compiled with DJGPP (an open + source compiler for DOS that has a fast native curses library). This + binary should work on any version of Windows (3.1, 95, NT, 2000) or DOS. + Note that it won't be able to see long filenames on NT4, and may show + all kinds of strange bugs on 2000 and XP, which the DJGPP team is still + working to resolve. + Windows NT and 2000 users also have the option of running Cscope + under the CygWin toolkit, which + provides a curses emulation library (among other goodies). Once Cygwin + are installed on your system, you can compile and run Cscope just as if + you were on a normal operating system (i.e. Unix). + |
+
+ |
++ |
+ |
+
+ If you experience problems with the latest release version, please try + the latest top of tree code. If that doesn't work, please check our + bug database, and add a new bug report if you don't see your problem + listed. + + Latest release: 15.8a + (previous versions available at same link) + + CVSROOT contents tarball + updated at the end of each day (WARNING: is not very straightforward + to use --- it's easier to just use anonymous CVS in most cases). + |
+
+ | + |
+ |
++ |
+ |
+
+
|
+
Change Log | ++ |
+ |
+
+
|
+
+ |
++ |
+ |
+ Cbrowser is an excellent GUI front-end written by Chris Felaco. It +is available for cscope, as well as cs. It is now available on +sourceforge.net. It can be downloaded from +http://cbrowser.sourceforge.net + ++KScope is a great new GUI +frontend for cscope based on the KDE environment. + + |