rpms/cscope/FC-4 Makefile, NONE, 1.1 cscope-15.5-findassign.patch, NONE, 1.1 cscope-15.5-inverted.patch, NONE, 1.1 cscope-15.5-ocs-dash_s_fix.patch, NONE, 1.1 cscope-15.5-ocs.patch, NONE, 1.1 cscope-15.5-resize.patch, NONE, 1.1 cscope-15.5-tempsec.patch, NONE, 1.1 cscope-15.5-xcscope-man.patch, NONE, 1.1 cscope.spec, NONE, 1.1 sources, NONE, 1.1
fedora-cvs-commits at redhat.com
fedora-cvs-commits at redhat.com
Mon Apr 18 18:51:08 UTC 2005
Update of /cvs/dist/rpms/cscope/FC-4
In directory cvs.devel.redhat.com:/tmp/cvs-serv8924/FC-4
Added Files:
Makefile cscope-15.5-findassign.patch
cscope-15.5-inverted.patch cscope-15.5-ocs-dash_s_fix.patch
cscope-15.5-ocs.patch cscope-15.5-resize.patch
cscope-15.5-tempsec.patch cscope-15.5-xcscope-man.patch
cscope.spec sources
Log Message:
adding FC-4 branch for cscope
***** Error reading new file: [Errno 2] No such file or directory: 'Makefile'
cscope-15.5-findassign.patch:
constants.h | 2 -
display.c | 1
find.c | 81 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
global.h | 1
4 files changed, 84 insertions(+), 1 deletion(-)
--- NEW FILE cscope-15.5-findassign.patch ---
diff -rU4 -N cscope-15.5/src/constants.h cscope-15.5-findassign/src/constants.h
--- cscope-15.5/src/constants.h 2003-09-04 11:54:02.000000000 -0400
+++ cscope-15.5-findassign/src/constants.h 2004-07-01 21:37:42.000000000 -0400
@@ -92,9 +92,9 @@
#define CHANGE 5
#define REGEXP 6
#define FILENAME 7
#define INCLUDES 8
-#define FIELDS 9
+#define FIELDS 11
#if (BSD || V9) && !__NetBSD__
#define TERMINFO 0 /* no terminfo curses */
#else
diff -rU4 -N cscope-15.5/src/display.c cscope-15.5-findassign/src/display.c
--- cscope-15.5/src/display.c 2003-09-04 11:54:02.000000000 -0400
+++ cscope-15.5-findassign/src/display.c 2004-07-01 21:06:47.000000000 -0400
@@ -104,8 +104,9 @@
{"Find this", "egrep pattern", findregexp},
{"Find this", "file", findfile},
{"Find", "files #including this file", findinclude},
{"Find all", "function definitions", findallfcns}, /* samuel only */
+ {"Find all", "symbol assignments", findassign},
};
/* Internal prototypes: */
static RETSIGTYPE jumpback(int sig);
diff -rU4 -N cscope-15.5/src/find.c cscope-15.5-findassign/src/find.c
--- cscope-15.5/src/find.c 2003-09-04 11:58:52.000000000 -0400
+++ cscope-15.5-findassign/src/find.c 2004-07-01 22:10:31.000000000 -0400
@@ -76,8 +76,10 @@
static char *lcasify(char *s);
static void findcalledbysub(char *file, BOOL macro);
static void findterm(char *pattern);
static void putline(FILE *output);
+static char *find_symbol_or_assignment(char *pattern, BOOL assign_flag);
+static BOOL check_for_assignment(void);
static void putpostingref(POSTING *p, char *pat);
static void putref(int seemore, char *file, char *func);
static void putsource(int seemore, FILE *output);
@@ -85,8 +87,79 @@
char *
findsymbol(char *pattern)
{
+ return find_symbol_or_assignment(pattern, NO);
+}
+
+ /* find the symbol in the cross-reference, and look for assignments */
+char *
+findassign(char *pattern)
+{
+ return find_symbol_or_assignment(pattern, YES);
+}
+
+ /* Test reference whether it's an assignment to the symbol found at
+ * (global variable) 'blockp' */
+static BOOL
+check_for_assignment(void)
+{
+ /* Do the extra work here to determine if this is an
+ * assignment or not Do this by examining the next character
+ * or two in blockp */
+ char *asgn_char = blockp;
+ int i = 1; /*skip any leading \n*/
+
+ while(1) {
+ if (asgn_char[i] == blockmark) {
+ /* get the next block when we reach the end of
+ * the current block */
+ asgn_char = readblock();
+ i=0;
+ }
+ while (isspace((unsigned char) asgn_char[i])) {
+ /* skip any whitespace or \n */
+ i++;
+ }
+ /* this next character better be one of the assignment
+ * characters, ie: =, +=, -=, *=, %=, /=, &=, |=, ^=,
+ * ~= if not, then its a notmatched case */
+ if ((asgn_char[i] != '=') &&
+ (asgn_char[i] != '+') &&
+ (asgn_char[i] != '-') &&
+ (asgn_char[i] != '*') &&
+ (asgn_char[i] != '/') &&
+ (asgn_char[i] != '%') &&
+ (asgn_char[i] != '&') &&
+ (asgn_char[i] != '|') &&
+ (asgn_char[i] != '^') &&
+ (asgn_char[i] != '~')) {
+ return NO;
+ } else {
+ /* if the first found character is = and the
+ * next found character is also =, then this
+ * is not an assignment. likewise if the
+ * first character is not = (i.e. one of the
+ * +,-,*,etc. chars and the next character is
+ * not =, then this is not an assignment */
+ if ((((asgn_char[i] == '=')
+ && (asgn_char[i+1] == '=')))
+ || ((asgn_char[i] != '=')
+ && (asgn_char[i+1] != '='))) {
+ return NO;
+ }
+ /* if we pass all these filters then this is
+ * an assignment */
+ return YES;
+ } /* else(operator char?) */
+ } /* while(endless) */
+}
+
+ /* The actual routine that does the work for findsymbol() and
+* findassign() */
+static char *
+find_symbol_or_assignment(char *pattern, BOOL assign_flag)
+{
char file[PATHLEN + 1]; /* source file name */
char function[PATLEN + 1]; /* function name */
char macro[PATLEN + 1]; /* macro name */
char symbol[PATLEN + 1]; /* symbol name */
@@ -242,8 +315,16 @@
/* match the rest of the symbol to the text pattern */
if (matchrest()) {
s = NULL;
matched:
+ /* if the assignment flag is set then
+ * we are looking for assignments and
+ * some extra filtering is needed */
+ if(assign_flag == YES
+ && ! check_for_assignment())
+ goto notmatched;
+
+
/* output the file, function or macro, and source line */
if (strcmp(macro, global) && s != macro) {
putref(0, file, macro);
}
diff -rU4 -N cscope-15.5/src/global.h cscope-15.5-findassign/src/global.h
--- cscope-15.5/src/global.h 2003-09-04 11:54:03.000000000 -0400
+++ cscope-15.5-findassign/src/global.h 2004-07-01 21:19:24.000000000 -0400
@@ -318,8 +318,9 @@
char *finddef(char *pattern);
char *findfile(char *dummy);
char *findinclude(char *pattern);
char *findsymbol(char *pattern);
+char *findassign(char *pattern);
char *findregexp(char *egreppat);
char *findstring(char *pattern);
char *inviewpath(char *file);
char *lookup(char *ident);
cscope-15.5-inverted.patch:
crossref.c | 11 +++++++----
1 files changed, 7 insertions(+), 4 deletions(-)
--- NEW FILE cscope-15.5-inverted.patch ---
--- cscope/src/crossref.c.orig 2003-04-29 10:08:45.000000000 -0400
+++ cscope/src/crossref.c 2004-10-05 10:37:19.958700472 -0400
@@ -95,10 +95,16 @@
int token; /* current token */
struct stat st;
+ filename = srcfile;
+ putfilename(srcfile); /* output the file name */
+ dbputc('\n');
+ dbputc('\n');
+
if (! ((stat(srcfile, &st) == 0)
&& S_ISREG(st.st_mode))) {
cannotopen(srcfile);
errorsfound = YES;
+ dbputc('\t');
return;
}
@@ -107,12 +113,9 @@
if ((yyin = myfopen(srcfile, "r")) == NULL) {
cannotopen(srcfile);
errorsfound = YES;
+ dbputc('\t');
return;
}
- filename = srcfile; /* save the file name for warning messages */
- putfilename(srcfile); /* output the file name */
- dbputc('\n');
- dbputc('\n');
/* read the source file */
initscanner(srcfile);
cscope-15.5-ocs-dash_s_fix.patch:
ocs | 2 +-
1 files changed, 1 insertion(+), 1 deletion(-)
--- NEW FILE cscope-15.5-ocs-dash_s_fix.patch ---
diff -Nur cscope-15.5-orig/contrib/ocs cscope-15.5/contrib/ocs
--- cscope-15.5-orig/contrib/ocs 2001-07-18 15:48:56.000000000 +0200
+++ cscope-15.5/contrib/ocs 2004-07-03 23:08:38.000000000 +0200
@@ -107,7 +107,7 @@
#
# Parse the command line
-set -- `getopt xfqdu $*`
+set -- `getopt xfqdus $*`
if [ $? -ne 0 ]
then
cscope-15.5-ocs.patch:
ocs | 14 +++++++++++++-
1 files changed, 13 insertions(+), 1 deletion(-)
--- NEW FILE cscope-15.5-ocs.patch ---
--- cscope-15.5/contrib/ocs 2001-07-18 09:48:56.000000000 -0400
+++ cscope-15.5.ocs-fix/contrib/ocs 2004-06-21 00:47:26.000000000 -0400
@@ -70,11 +70,23 @@
#
# Here is where we put things
CSCOPE=cscope
-SYSDIR=/usr/local/lib/cs
HOMEDIR=${HOME}/lib/cs
+#set the default value for SYSDIR
+if [ -z "${SYSDIR}" ]; then
+ SYSDIR=/var/lib/cs
+ echo setting default sysdir
+fi
+
+#check that SYSDIR exists
+if [ ! -d ${SYSDIR} ]; then
+ echo -n $SYSDIR does not exist.
+ echo Please create the directory and set SYSDIR appropriately
+ exit
+fi
+
# Check that cscope is in PATH
type cscope 1>/dev/null 2>&1
if [ $? -ne 0 ]
cscope-15.5-resize.patch:
command.c | 20 ++++++++++++++++++++
input.c | 12 ++++++++++--
main.c | 13 +++++++++++++
3 files changed, 43 insertions(+), 2 deletions(-)
--- NEW FILE cscope-15.5-resize.patch ---
--- cscope-15.5/src/command.c.orig 2004-11-26 21:21:46.523695928 -0500
+++ cscope-15.5/src/command.c 2004-11-26 21:30:35.322306320 -0500
@@ -80,6 +80,7 @@
FILE *file;
struct cmd *curritem, *item; /* command history */
char *s;
+ int lines, cols;
switch (commandc) {
@@ -405,6 +406,25 @@
entercurses();
break;
+ case KEY_RESIZE:
+ exitcurses();
+ initscr();
+ entercurses();
+#if TERMINFO
+ (void) keypad(stdscr, TRUE); /* enable the keypad */
+#ifdef HAVE_FIXKEYPAD
+ fixkeypad(); /* fix for getch() intermittently returning garbage */
+#endif
+#endif
+#if UNIXPC
+ standend(); /* turn off reverse video */
+#endif
+ dispinit(); /* initialize display parameters */
+ setfield(); /* set the initial cursor position */
+ postmsg(""); /* clear any build progress message */
+ display(); /* display the version number and input fields */
+ break;
+
case ctrl('L'): /* redraw screen */
#if TERMINFO
case KEY_CLEAR:
--- cscope-15.5/src/input.c.orig 2001-07-18 09:49:01.000000000 -0400
+++ cscope-15.5/src/input.c 2004-11-26 21:18:09.526684488 -0500
@@ -43,6 +43,7 @@
#endif
#include <setjmp.h> /* jmp_buf */
#include <stdlib.h>
+#include <errno.h>
#if HAVE_SYS_TERMIOS_H
#include <sys/termios.h>
#endif
@@ -91,8 +92,15 @@
c = prevchar;
prevchar = 0;
}
- else
- c = getch(); /* get a character from the terminal */
+ else {
+ c = -1;
+ while (c == -1) {
+ /* get a character from the terminal */
+ c = getch();
+ if((c == -1) && (errno != EINTR))
+ break;
+ }
+ }
}
else { /* longjmp to here from signal handler */
c = KEY_BREAK;
--- cscope-15.5/src/main.c.orig 2003-08-14 10:36:18.000000000 -0400
+++ cscope-15.5/src/main.c 2004-11-26 21:27:12.506139064 -0500
@@ -50,6 +50,7 @@
#endif
#include <sys/types.h> /* needed by stat.h */
#include <sys/stat.h> /* stat */
+#include <signal.h>
/* defaults for unset environment variables */
#define EDITOR "vi"
@@ -120,6 +121,11 @@
void fixkeypad();
#endif
+void sigwinch_handler(int sig, siginfo_t *info, void *unused)
+{
+ ungetch(KEY_RESIZE);
+}
+
int
main(int argc, char **argv)
{
@@ -131,12 +137,19 @@
int c, i;
pid_t pid;
struct stat stat_buf;
+ struct sigaction winch_action;
yyin = stdin;
yyout = stdout;
/* save the command name for messages */
argv0 = argv[0];
+ winch_action.sa_sigaction = sigwinch_handler;
+ sigemptyset(&winch_action.sa_mask);
+ winch_action.sa_flags = SA_SIGINFO;
+
+ sigaction(SIGWINCH,&winch_action,NULL);
+
/* set the options */
while (--argc > 0 && (*++argv)[0] == '-') {
/* HBB 20030814: add GNU-style --help and --version
cscope-15.5-tempsec.patch:
main.c | 16 ++++++++++++++--
1 files changed, 14 insertions(+), 2 deletions(-)
--- NEW FILE cscope-15.5-tempsec.patch ---
--- cscope-15.5/src/main.c.orig 2004-11-30 10:47:56.000000000 -0500
+++ cscope-15.5/src/main.c 2004-11-30 12:58:13.000000000 -0500
@@ -102,6 +102,7 @@
#endif
char temp1[PATHLEN + 1]; /* temporary file name */
char temp2[PATHLEN + 1]; /* temporary file name */
+char tempdirpv[PATHLEN +1]; /* private temp directory */
long totalterms; /* total inverted index terms */
BOOL trun_syms; /* truncate symbols to 8 characters */
char tempstring[8192]; /* use this as a buffer, instead of 'yytext',
@@ -138,6 +139,7 @@
pid_t pid;
struct stat stat_buf;
struct sigaction winch_action;
+ mode_t orig_umask;
yyin = stdin;
yyout = stdout;
@@ -344,9 +346,18 @@
}
/* create the temporary file names */
+ orig_umask = umask(S_IRWXG|S_IRWXO);
pid = getpid();
- (void) sprintf(temp1, "%s/cscope%d.1", tmpdir, pid);
- (void) sprintf(temp2, "%s/cscope%d.2", tmpdir, pid);
+ (void) sprintf(tempdirpv, "%s/cscope.%d", tmpdir, pid);
+ if(mkdir(tempdirpv,S_IRWXU))
+ {
+ fprintf(stderr, "cscope: Could not create private temp dir %s\n",tempdirpv);
+ myexit(1);
+ }
+ umask(orig_umask);
+
+ (void) sprintf(temp1, "%s/cscope.1", tempdirpv, pid);
+ (void) sprintf(temp2, "%s/cscope.2", tempdirpv, pid);
/* if running in the foreground */
if (signal(SIGINT, SIG_IGN) != SIG_IGN) {
@@ -848,6 +859,7 @@
if (temp1[0] != '\0') {
(void) unlink(temp1);
(void) unlink(temp2);
+ (void) rmdir(tempdirpv);
}
/* restore the terminal to its original mode */
if (incurses == YES) {
cscope-15.5-xcscope-man.patch:
Makefile.in | 2
xcscope.1 | 577 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 578 insertions(+), 1 deletion(-)
--- NEW FILE cscope-15.5-xcscope-man.patch ---
diff -rU4 -N -p cscope-15.5/doc/Makefile.in cscope-15.5-xcscope/doc/Makefile.in
--- cscope-15.5/doc/Makefile.in 2003-09-04 12:51:25.000000000 -0400
+++ cscope-15.5-xcscope/doc/Makefile.in 2004-07-20 13:49:11.000000000 -0400
@@ -129,9 +129,9 @@ sbindir = @sbindir@
sharedstatedir = @sharedstatedir@
sysconfdir = @sysconfdir@
target_alias = @target_alias@
-man_MANS = cscope.1
+man_MANS = cscope.1 xcscope.1
EXTRA_DIST = $(man_MANS)
subdir = doc
mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
CONFIG_HEADER = $(top_builddir)/config.h
diff -rU4 -N -p cscope-15.5/doc/xcscope.1 cscope-15.5-xcscope/doc/xcscope.1
--- cscope-15.5/doc/xcscope.1 1969-12-31 19:00:00.000000000 -0500
+++ cscope-15.5-xcscope/doc/xcscope.1 2004-07-20 13:47:48.000000000 -0400
@@ -0,0 +1,577 @@
+'\" t
+.\" The xcscope.el man page
+.\" Origionally written by Darryl Okahata, Apr 2000
+.\"
+.\" Converted to a man page July 20, 2004 by Neil Horman <nhorman at redhat.com>
+.\"
+
+.PU
+.TH XCSCOPE.EL "1" "April 2000" "Darryl Okahata"
+.SH NAME
+xcscope.el - xemacs cscope lisp support package
+.SH DESCRIPTION
+xcscope is a lisp package for use in integrating cscope
+functionality into xemacs
+.SH INSTALLATION
+.P
+ Installation steps:
+
+.P
+ 0. (It is, of course, assumed that cscope is already properly
+ installed on the current system.)
+.P
+ 1. Ensure that the location of cscope-indexer is located in your path
+
+.P
+ 2. Ensure that the location of xcscope.el is in the xemacs module load path
+
+.P
+ 3. Edit your ~/.emacs file to add the line:
+.P
+.BI (require 'xcscope)
+
+.P
+5. If you intend to use xcscope.el often you can optionally edit your
+~/.emacs file to add keybindings that reduce the number of keystrokes
+required. For example, the following will add "C-f#" keybindings,
+which are easier to type than the usual "C-c s" prefixed keybindings.
+Note that specifying "global-map" instead of "cscope:map" makes the
+keybindings available in all buffers:
+.nf
+ (define-key global-map [(ctrl f3)] 'cscope-set-initial-directory)
+ (define-key global-map [(ctrl f4)] 'cscope-unset-initial-directory)
+ (define-key global-map [(ctrl f5)] 'cscope-find-this-symbol)
+ (define-key global-map [(ctrl f6)] 'cscope-find-global-definition)
+ (define-key global-map [(ctrl f7)]
+ cscope-find-global-definition-no-prompting)
+ (define-key global-map [(ctrl f8)] 'cscope-pop-mark)
+ (define-key global-map [(ctrl f9)] 'cscope-next-symbol)
+ (define-key global-map [(ctrl f10)] 'cscope-next-file)
+ (define-key global-map [(ctrl f11)] 'cscope-prev-symbol)
+ (define-key global-map [(ctrl f12)] 'cscope-prev-file)
+ (define-key global-map [(meta f9)] 'cscope-display-buffer)
+ (define-key global-map [(meta f10)] 'cscope-display-buffer-toggle)
+.fi
+
+.P
+ 6. Restart (X)Emacs. That's it.
+
+
+.SH USING THIS MODULE
+
+.SS * Basic usage:
+
+.P
+ If all of your C/C++/lex/yacc source files are in the same
+ directory, you can just start using this module. If your files are
+ spread out over multiple directories, see "Advanced usage", below.
+
+.P
+ Just edit a source file, and use the pull-down or pop-up (button 3)
+ menus to select one of:
+
+.nf
+ Find symbol
+ Find global definition
+ Find called functions
+ Find functions calling a function
+ Find text string
+ Find egrep pattern
+ Find a file
+ Find files #including a file
+.fi
+
+.P
+The cscope database will be automatically created in the same directory
+as the source files (assuming that you've never used cscope before), and
+a buffer will pop-up displaying the results. You can then use button 2
+(the middle button) on the mouse to edit the selected file, or you can
+move the text cursor over a selection and press [Enter].
+
+.P
+Hopefully, the interface should be fairly intuitive.
+
+.SS * Locating the cscope databases:
+
+.P
+This module will first use the variable, `cscope-database-regexps',
+to search for a suitable database directory. If a database location
+cannot be found using this variable then a search is begun at the
+variable, `cscope-initial-directory', if set, or the current
+directory otherwise. If the directory is not a cscope database
+directory then the directory's parent, parent's parent, etc. is
+searched until a cscope database directory is found, or the root
+directory is reached. If the root directory is reached, the current
+directory will be used.
+
+.P
+A cscope database directory is one in which EITHER a cscope database
+file (e.g., "cscope.out") OR a cscope file list (e.g.,
+"cscope.files") exists. If only "cscope.files" exists, the
+corresponding "cscope.out" will be automatically created by cscope
+when a search is done. By default, the cscope database file is called
+"cscope.out", but this can be changed (on a global basis) via the
+variable, `cscope-database-file'. There is limited support for cscope
+databases that are named differently than that given by
+`cscope-database-file', using the variable, `cscope-database-regexps'.
+
+.P
+Note that the variable, `cscope-database-regexps', is generally not
+needed, as the normal hierarchical database search is sufficient
+for placing and/or locating the cscope databases. However, there
+may be cases where it makes sense to place the cscope databases
+away from where the source files are kept; in this case, this
+variable is used to determine the mapping. One use for this
+variable is when you want to share the database file with other
+users; in this case, the database may be located in a directory
+separate from the source files.
+
+.P
+Setting the variable, `cscope-initial-directory', is useful when a
+search is to be expanded by specifying a cscope database directory
+that is a parent of the directory that this module would otherwise
+use. For example, consider a project that contains the following
+cscope database directories:
+
+.nf
+ /users/jdoe/sources
+ /users/jdoe/sources/proj1
+ /users/jdoe/sources/proj2
+.fi
+
+.P
+If a search is initiated from a .c file in /users/jdoe/sources/proj1
+then (assuming the variable, `cscope-database-regexps', is not set)
+/users/jdoe/sources/proj1 will be used as the cscope data base directory.
+Only matches in files in /users/jdoe/sources/proj1 will be found. This
+can be remedied by typing "C-c s a" and then "M-del" to remove single
+path element in order to use a cscope database directory of
+/users/jdoe/sources. Normal searching can be restored by typing "C-c s A".
+
+
+
+.SS * Keybindings:
+
+.P
+All keybindings use the "C-c s" prefix, but are usable only while
+editing a source file, or in the cscope results buffer:
+
+.BI "C-c s s Find symbol."
+.TP
+.BI "C-c s d Find global definition."
+.TP
+.BI "C-c s g Find global definition (alternate binding)."
+.TP
+.BI "C-c s G Find global definition without prompting."
+.TP
+.BI "C-c s c Find functions calling a function."
+.TP
+.BI "C-c s C Find called functions (list functions called"
+.BI " from a function)."
+.TP
+.BI "C-c s t Find text string."
+.TP
+.BI "C-c s e Find egrep pattern."
+.TP
+.BI "C-c s f Find a file."
+.TP
+.BI "C-c s i Find files #including a file."
+
+.P
+These pertain to navigation through the search results:
+
+.P
+.BI "C-c s b Display *cscope* buffer."
+.TP
+.BI "C-c s B Auto display *cscope* buffer toggle."
+.TP
+.BI "C-c s n Next symbol."
+.TP
+.BI "C-c s N Next file."
+.TP
+.BI "C-c s p Previous symbol."
+.TP
+.BI "C-c s P Previous file."
+.TP
+.BI "C-c s u Pop mark."
+
+.P
+These pertain to setting and unsetting the variable,
+`cscope-initial-directory', (location searched for the cscope database
+directory):
+
+.P
+.BI "C-c s a Set initial directory."
+.TP
+.BI "C-c s A Unset initial directory."
+
+.P
+These pertain to cscope database maintenance:
+.P
+.BI "C-c s L Create list of files to index."
+.TP
+.BI "C-c s I Create list and index."
+.TP
+.BI "C-c s E Edit list of files to index."
+.TP
+.BI "C-c s W Locate this buffer's cscope directory"
+.BI " ("
+"W" --> "where"
+.BI ")."
+.TP
+.BI "C-c s S Locate this buffer's cscope directory."
+.BI " (alternate binding: "
+"S" --> "show"
+.BI ")."
+.TP
+.BI "C-c s T Locate this buffer's cscope directory."
+.BI " (alternate binding: "
+"T" --> "tell"
+.BI ")."
+.TP
+.BI "C-c s D Dired this buffer's directory."
+
+.P
+.SS * Advanced usage:
+
+.P
+If the source files are spread out over multiple directories,
+you've got a few choices:
+
+.P
+[ NOTE: you will need to have the script, "cscope-indexer",
+properly installed in order for the following to work. ]
+
+.P
+1. If all of the directories exist below a common directory
+(without any extraneous, unrelated subdirectories), you can tell
+this module to place the cscope database into the top-level,
+common directory. This assumes that you do not have any cscope
+databases in any of the subdirectories. If you do, you should
+delete them; otherwise, they will take precedence over the
+top-level database.
+
+.P
+If you do have cscope databases in any subdirectory, the
+following instructions may not work right.
+
+.P
+It's pretty easy to tell this module to use a top-level, common
+directory:
+
+.HP
+a. Make sure that the menu pick, "Cscope/Index recursively", is
+checked (the default value).
+
+.HP
+b. Select the menu pick, "Cscope/Create list and index", and
+specify the top-level directory. This will run the script,
+"cscope-indexer", in the background, so you can do other
+things if indexing takes a long time. A list of files to
+index will be created in "cscope.files", and the cscope
+database will be created in "cscope.out".
+
+.HP
+Once this has been done, you can then use the menu picks
+(described in "Basic usage", above) to search for symbols.
+
+.HP
+Note, however, that, if you add or delete source files, you'll
+have to either rebuild the database using the above procedure,
+or edit the file, "cscope.files" to add/delete the names of the
+source files. To edit this file, you can use the menu pick,
+"Cscope/Edit list of files to index".
+
+.P
+2. If most of the files exist below a common directory, but a few
+are outside, you can use the menu pick, "Cscope/Create list of
+files to index", and specify the top-level directory. Make sure
+that "Cscope/Index recursively", is checked before you do so,
+though. You can then edit the list of files to index using the
+menu pick, "Cscope/Edit list of files to index". Just edit the
+list to include any additional source files not already listed.
+
+.P
+Once you've created, edited, and saved the list, you can then
+use the menu picks described under "Basic usage", above, to
+search for symbols. The first time you search, you will have to
+wait a while for cscope to fully index the source files, though.
+If you have a lot of source files, you may want to manually run
+cscope to build the database:
+
+.nf
+ cd top-level-directory # or wherever
+ rm -f cscope.out # not always necessary
+ cscope -b
+.fi
+
+.P
+ 3. If the source files are scattered in many different, unrelated
+ places, you'll have to manually create cscope.files and put a
+ list of all pathnames into it. Then build the database using:
+
+.nf
+ cd some-directory # wherever cscope.files exists
+ rm -f cscope.out # not always necessary
+ cscope -b
+.fi
+
+.P
+Next, read the documentation for the variable,
+"cscope-database-regexps", and set it appropriately, such that
+the above-created cscope database will be referenced when you
+edit a related source file.
+
+.P
+Once this has been done, you can then use the menu picks
+described under "Basic usage", above, to search for symbols.
+
+.SS * Interesting configuration variables:
+
+.P
+.B "cscope-truncate-lines"
+.P
+This is the value of `truncate-lines' to use in cscope
+buffers; the default is the current setting of
+`truncate-lines'. This variable exists because it can be
+easier to read cscope buffers with truncated lines, while
+other buffers do not have truncated lines.
+
+.P
+.B "cscope-use-relative-paths"
+.P
+If non-nil, use relative paths when creating the list of files
+to index. The path is relative to the directory in which the
+cscope database will be created. If nil, absolute paths will
+be used. Absolute paths are good if you plan on moving the
+database to some other directory (if you do so, you'll
+probably also have to modify `cscope-database-regexps').
+Absolute paths may also be good if you share the database file
+with other users (you'll probably want to specify some
+automounted network path for this).
+
+.P
+.B "cscope-index-recursively"
+.P
+If non-nil, index files in the current directory and all
+subdirectories. If nil, only files in the current directory
+are indexed. This variable is only used when creating the
+list of files to index, or when creating the list of files and
+the corresponding cscope database.
+
+.P
+.B "cscope-name-line-width"
+.P
+The width of the combined "function name:line number" field in
+the cscope results buffer. If negative, the field is
+left-justified.
+
+.P
+.B "cscope-do-not-update-database"
+.P
+If non-nil, never check and/or update the cscope database when
+searching. Beware of setting this to non-nil, as this will
+disable automatic database creation, updating, and
+maintenance.
+
+.P
+.B "cscope-display-cscope-buffer"
+.P
+If non-nil, display the *cscope* buffer after each search
+(default). This variable can be set in order to reduce the
+number of keystrokes required to navigate through the matches.
+
+.P
+.B "cscope-database-regexps"
+.P
+List to force directory-to-cscope-database mappings.
+This is a list of `(REGEXP DBLIST [ DBLIST ... ])', where:
+
+.P
+.B "REGEXP"
+is a regular expression matched against the current buffer's
+current directory. The current buffer is typically some source file,
+and you're probably searching for some symbol in or related to this
+file. Basically, this regexp is used to relate the current directory
+to a cscope database. You need to start REGEXP with "^" if you want
+to match from the beginning of the current directory.
+
+.P
+.B "DBLIST"
+is a list that contains one or more of:
+
+.nf
+ ( DBDIR )
+ ( DBDIR ( OPTIONS ) )
+ ( t )
+ t
+.fi
+
+.P
+Here,
+.B DBDIR
+is a directory (or a file) that contains a cscope
+database. If DBDIR is a directory, then it is expected that the
+cscope database, if present, has the filename given by the variable,
+`cscope-database-file'; if DBDIR is a file, then DBDIR is the path
+name to a cscope database file (which does not have to be the same as
+that given by `cscope-database-file'). If only DBDIR is specified,
+then that cscope database will be searched without any additional
+cscope command-line options. If OPTIONS is given, then OPTIONS is a
+list of strings, where each string is a separate cscope command-line
+option.
+
+.P
+ In the case of "( t )", this specifies that the search is to use the
+ normal hierarchical database search. This option is used to
+ explicitly search using the hierarchical database search either before
+ or after other cscope database directories.
+
+.P
+ If "t" is specified (not inside a list), this tells the searching
+ mechanism to stop searching if a match has been found (at the point
+ where "t" is encountered). This is useful for those projects that
+ consist of many subprojects. You can specify the most-used
+ subprojects first, followed by a "t", and then followed by a master
+ cscope database directory that covers all subprojects. This will
+ cause the most-used subprojects to be searched first (hopefully
+ quickly), and the search will then stop if a match was found. If not,
+ the search will continue using the master cscope database directory.
+
+.P
+ Here, `cscope-database-regexps' is generally not used, as the normal
+ hierarchical database search is sufficient for placing and/or locating
+ the cscope databases. However, there may be cases where it makes
+ sense to place the cscope databases away from where the source files
+ are kept; in this case, this variable is used to determine the
+ mapping.
+
+.P
+ This module searches for the cscope databases by first using this
+ variable; if a database location cannot be found using this variable,
+ then the current directory is searched, then the parent, then the
+ parent's parent, until a cscope database directory is found, or the
+ root directory is reached. If the root directory is reached, the
+ current directory will be used.
+
+.P
+A cscope database directory is one in which EITHER a cscope database
+file (e.g., "cscope.out") OR a cscope file list (e.g.,
+"cscope.files") exists. If only "cscope.files" exists, the
+corresponding "cscope.out" will be automatically created by cscope
+when a search is done. By default, the cscope database file is called
+"cscope.out", but this can be changed (on a global basis) via the
+variable, `cscope-database-file'. There is limited support for cscope
+databases that are named differently than that given by
+`cscope-database-file', using the variable, `cscope-database-regexps'.
+
+.P
+Here is an example of `cscope-database-regexps':
+
+.nf
+ (setq cscope-database-regexps
+ '(
+ ( "^/users/jdoe/sources/proj1"
+ ( t )
+ ( "/users/jdoe/sources/proj2")
+ ( "/users/jdoe/sources/proj3/mycscope.out")
+ ( "/users/jdoe/sources/proj4")
+ t
+ ( "/some/master/directory" ("-d" "-I/usr/local/include") )
+ )
+ ( "^/users/jdoe/sources/gnome/"
+ ( "/master/gnome/database" ("-d") )
+ )
+ ))
+.fi
+
+.P
+If the current buffer's directory matches the regexp,
+"^/users/jdoe/sources/proj1", then the following search will be
+done:
+
+.TP
+1. First, the normal hierarchical database search will be used to
+locate a cscope database.
+
+.TP
+2. Next, searches will be done using the cscope database
+directories, "/users/jdoe/sources/proj2",
+"/users/jdoe/sources/proj3/mycscope.out", and
+"/users/jdoe/sources/proj4". Note that, instead of the file,
+"cscope.out", the file, "mycscope.out", will be used in the
+directory "/users/jdoe/sources/proj3".
+
+.TP
+3. If a match was found, searching will stop.
+
+.TP
+4. If a match was not found, searching will be done using
+"/some/master/directory", and the command-line options "-d"
+and "-I/usr/local/include" will be passed to cscope.
+
+.TP
+If the current buffer's directory matches the regexp,
+"^/users/jdoe/sources/gnome", then the following search will be
+done:
+
+.TP
+The search will be done only using the directory,
+"/master/gnome/database". The "-d" option will be passed to
+cscope.
+
+.TP
+If the current buffer's directory does not match any of the above
+regexps, then only the normal hierarchical database search will be
+done.
+
+.P
+.SS * Other notes:
+
+.P
+1. The script, "cscope-indexer", uses a sed command to determine
+what is and is not a C/C++/lex/yacc source file. It's idea of a
+source file may not correspond to yours.
+
+.P
+2. This module is called, "xcscope", because someone else has
+already written a "cscope.el" (although it's quite old).
+
+.SH KNOWN BUGS:
+
+.P
+1. Cannot handle whitespace in directory or file names.
+
+.P
+2. By default, colored faces are used to display results. If you happen
+to use a black background, part of the results may be invisible
+(because the foreground color may be black, too). There are at least
+two solutions for this:
+
+.TP
+.BI "2a. Turn off colored faces, by setting `cscope-use-face' to `nil', eg:"
+.TP
+.BI "(setq cscope-use-face nil)"
+
+.TP
+.BI " 2b. Explicitly set colors for the faces used by cscope. The faces are"
+
+.nf
+ cscope-file-face
+ cscope-function-face
+ cscope-line-number-face
+ cscope-line-face
+ cscope-mouse-face
+.fi
+
+.TP
+The face most likely to cause problems (e.g., black-on-black
+color) is `cscope-line-face'.
+
+.P
+3. The support for cscope databases different from that specified by
+`cscope-database-file' is quirky. If the file does not exist, it
+will not be auto-created (unlike files names by
+`cscope-database-file'). You can manually force the file to be
+created by using touch(1) to create a zero-length file; the
+database will be created the next time a search is done.
--- NEW FILE cscope.spec ---
Summary: C source code tree search and browse tool
Name: cscope
Version: 15.5
Release: 12
Source0: http://unc.dl.sourceforge.net/sourceforge/cscope/cscope-15.5.tar.gz
URL: http://cscope.sourceforge.net
License: BSD
Group: Development/Tools
BuildRoot: %{_tmppath}/%{name}-%{version}
BuildRequires: pkgconfig ncurses-devel flex bison m4
%define cscope_share_path %{_datadir}/cscope
%define xemacs_lisp_path %{_datadir}/xemacs/site-packages/lisp
%define emacs_lisp_path %{_datadir}/emacs/site-lisp
Patch0:cscope-15.5-ocs.patch
Patch1:cscope-15.5-findassign.patch
Patch2:cscope-15.5-ocs-dash_s_fix.patch
Patch3:cscope-15.5-xcscope-man.patch
Patch4:cscope-15.5-inverted.patch
Patch5:cscope-15.5-resize.patch
Patch6:cscope-15.5-tempsec.patch
%description
cscope is a mature, ncurses based, C source code tree browsing tool. It
allows users to search large source code bases for variables, functions,
macros, etc, as well as perform general regex and plain text searches.
Results are returned in lists, from which the user can select individual
matches for use in file editing.
%prep
%setup -q
%patch0 -p1
%patch1 -p1
%patch2 -p1
%patch3 -p1
%patch4 -p1
%patch5 -p1
%patch6 -p1
%build
%configure
make
%install
rm -rf $RPM_BUILD_ROOT %{name}-%{version}.files
make DESTDIR=$RPM_BUILD_ROOT install
mkdir -p $RPM_BUILD_ROOT/var/lib/cs
mkdir -p $RPM_BUILD_ROOT%{cscope_share_path}
cp -a contrib/xcscope/xcscope.el $RPM_BUILD_ROOT%{cscope_share_path}
cp -a contrib/xcscope/cscope-indexer $RPM_BUILD_ROOT%{_bindir}
for dir in %{xemacs_lisp_path} %{emacs_lisp_path} ; do
mkdir -p $RPM_BUILD_ROOT$dir
ln -s %{cscope_share_path}/xcscope.el $RPM_BUILD_ROOT$dir
touch $RPM_BUILD_ROOT$dir/xcscope.elc
echo "%ghost $dir/xcscope.el*" >> %{name}-%{version}.files
done
%clean
rm -rf $RPM_BUILD_ROOT
%files -f %{name}-%{version}.files
%defattr(-,root,root,-)
%{_bindir}/*
%dir %{cscope_share_path}
%{cscope_share_path}/xcscope.el
%{_mandir}/man1/*
%dir /var/lib/cs
%doc AUTHORS COPYING ChangeLog README TODO
%triggerin -- xemacs
ln -sf %{cscope_share_path}/xcscope.el %{xemacs_lisp_path}/xcscope.el
%triggerin -- emacs
ln -sf %{cscope_share_path}/xcscope.el %{emacs_lisp_path}/xcscope.el
%triggerun -- xemacs
[ $2 -gt 0 ] && exit 0
rm -f %{xemacs_lisp_path}/xcscope.el
%triggerun -- emacs
[ $2 -gt 0 ] && exit 0
rm -f %{emacs_lisp_path}/xcscope.el
%changelog
* Tue Nov 30 2004 Neil Horman <nhorman at redhat.com>
- added tempsec patch to fix bz140764/140765
* Mon Nov 29 2004 Neil Horman <nhorman at redhat.com>
- updated cscope resize patch to do less work in
signal handler and synced version nr. on dist.
* Mon Nov 22 2004 Neil Horman <nhorman at redhat.com>
- added cscope-1.5.-resize patch to allow terminal
resizing while cscope is running
* Tue Oct 5 2004 Neil Horman <nhorman at redhat.com>
- modified cscope-15.5.-inverted patch to be upstream
friendly
* Tue Sep 28 2004 Neil Horman <nhorman at redhat.com>
- fixed inverted index bug (bz 133942)
* Mon Sep 13 2004 Frank Ch. Eigler <fche at redhat.com>
- bumped release number to a plain "1"
* Fri Jul 16 2004 Neil Horman <nhorman at redhat.com>
- Added cscope-indexer helper and xcscope lisp addon
- Added man page for xcscope
- Added triggers to add xcscope.el pkg to (x)emacs
- Thanks to Ville, Michael and Jens for thier help :)
* Fri Jul 2 2004 Neil Horman <nhorman at redhat.com>
- Added upstream ocs fix
- Added feature to find symbol assignments
- Changed default SYSDIR directory to /var/lib/cs
- Incoproated M. Schwendt's fix for ocs -s
* Fri Jun 18 2004 Neil Horman <nhorman at redhat.com>
- built the package
--- NEW FILE sources ---
beb6032a301bb11524aec74bfb5e4840 cscope-15.5.tar.gz
More information about the fedora-cvs-commits
mailing list