[Cscope-cvs] CVS: cscope README,1.6,1.7 INSTALL,1.2,1.3

[Darryl O. <da...@us...>]

Update of /cvsroot/cscope/cscope
In directory usw-pr-cvs1:/tmp/cvs-serv28891

Modified Files:
	README INSTALL 
Log Message:
Cleaned up files.
Made more consistent with other open-source projects (moved build
instructions from README to INSTALL).


Index: README
===================================================================
RCS file: /cvsroot/cscope/cscope/README,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -r1.6 -r1.7
*** README	2001/06/29 10:52:27	1.6
--- README	2001/06/29 16:42:56	1.7
***************
*** 1,35 ****
! Cscope is a text screen based source browsing tool.
  
! It has been released by The Santa Cruz Operation, Inc as Open Source under
! the BSD license. Please look at COPYING for a detailed description of the
! license.
! 
! BUILDING:
! Try:
! 
! ./configure
! make
! 
! If the build fails contact pe...@us...
! 
! TIPS:
! 
! - Try to use flex as the lexical analyzer. There may be some problems
!   with using the native lex (due to some problems). The has been
!   reported as a problem on Solaris.
! 
! - On Linux systems (and possibly others) configure may fail if lex is
!   a synomyn for flex. To fix, do the following:
! 
! 	make distclean
! 	./configure --with-flex
! 	make
! 
! - On HP-UX 10.*, the default version of curses was observed to be broken. 
!   Get their "cumulative patches" and then compile like this, to work
!   around that bug:
! 
! 	make CURSES_LIBS=-lHcurses
! 
  
  Browse to http://cscope.sourceforge.net for more current information
--- 1,24 ----
! Cscope is a text screen based source browsing tool.  Although it is
! primarily designed to search C code (including lex and yacc files), it
! can also be used for C++ code.
! 
! Using cscope, you can easily search for where symbols are used and
! defined.  Cscope is designed to answer questions like:
! 
!         Where is this variable used?
!         What is the value of this preprocessor symbol?
!         Where is this function in the source files?
!         What functions call this function?
!         What functions are called by this function?
!         Where does the message "out of space" come from?
!         Where is this source file in the directory structure?
!         What files include this header file?
! 
! It has been released by The Santa Cruz Operation, Inc as Open Source
! under the BSD license.  Please look at COPYING for a detailed
! description of the license.
  
! For instructions on how to build and install cscope, see the file,
! "INSTALL".
  
  Browse to http://cscope.sourceforge.net for more current information

Index: INSTALL
===================================================================
RCS file: /cvsroot/cscope/cscope/INSTALL,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -r1.2 -r1.3
*** INSTALL	2000/04/27 16:33:47	1.2
--- INSTALL	2001/06/29 16:42:56	1.3
***************
*** 1,16 ****
  
! This program's build procedure is fairly standard...
  
! ./configure
! make
! make install
! 
! Options to the configure script are up to you... run
! ./configure --help
! for details.
  
  Please report build problems at:
  
! http://sourceforge.net/bugs/?func=addbug&group_id=4664
  
  (yes, even non-Linux problems).
--- 1,61 ----
+ ***** BUILDING:
  
! This program's build procedure is fairly standard.  Try:
  
! 	./configure
! 	make
! 	make install
  
+ Options to the configure script are up to you.  For details, run:
+ 
+ 	./configure --help
+ 
  Please report build problems at:
  
! 	http://sourceforge.net/bugs/?func=addbug&group_id=4664
  
  (yes, even non-Linux problems).
+ 
+ 
+ ***** TIPS AND PROBLEMS:
+ 
+ - Try to use flex as the lexical analyzer.  There may be some problems
+   with using the native lex (due to some problems).  The has been
+   reported as a problem on Solaris.
+ 
+   However, please note that the flex-generated scanner is significantly
+   slower than the lex scanner (database building is at least twice as
+   slow).  While flex appears to be more reliable, you might want to try
+   using lex.  This is true on HP-UX.
+ 
+ - On Linux systems (and possibly others) configure may fail if lex is
+   a synomyn for flex.  To fix, do the following:
+ 
+ 	make distclean
+ 	./configure --with-flex
+ 	make
+ 
+ - On HP-UX 10.20, the default version of curses was observed to be
+   broken.  Get their "cumulative libHcurses patch" (patch PHCO_10947)
+   and then compile like this, to work around that bug:
+ 
+ 	make CURSES_LIBS=-lHcurses
+ 
+   Also on other versions of HP-UX, if the build fails at link time with
+   errors like:
+ 
+ 	/usr/ccs/bin/ld: Unsatisfied symbols:
+ 	initscr (code)
+ 	wstandend (code)
+ 	...
+ 
+   you should delete the file, "config.cache", and re-run configure with
+   the option "--with-vcurses"; for example:
+ 
+ 	./configure --with-vcurses
+ 
+   Note, however, that you should never see this if you build using
+   "make CURSES_LIBS=-lHcurses".
+ 
+ 
+ Browse to http://cscope.sourceforge.net for more current information.