From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 19763 invoked by alias); 21 Feb 2002 01:51:22 -0000 Mailing-List: contact sourcenav-help@sources.redhat.com; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: sourcenav-owner@sources.redhat.com Received: (qmail 19706 invoked from network); 21 Feb 2002 01:51:21 -0000 Received: from unknown (HELO shell4.bayarea.net) (209.128.82.1) by sources.redhat.com with SMTP; 21 Feb 2002 01:51:21 -0000 Received: from modrick (209-128-79-218.BAYAREA.NET [209.128.79.218]) by shell4.bayarea.net (8.9.3/8.9.3) with SMTP id RAA12668 for ; Wed, 20 Feb 2002 17:51:21 -0800 (envelope-from supermo@bayarea.net) Date: Wed, 20 Feb 2002 18:00:00 -0000 From: Mo DeJong To: sourcenav Subject: [Patch] Fixup install/build notes and VC++ build instructions. Message-Id: <20020220175013.18a9cdb1.supermo@bayarea.net> Organization: House of Mirth X-Mailer: Sylpheed version 0.4.99cvs6 (GTK+ 1.2.7; i686-pc-linux-gnu) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-SW-Source: 2002-q1/txt/msg00087.txt.bz2 Here is a small patch that fixes up the README.TXT and INSTALL.TXT files so that they actually tell the user how to build with VC++ (imagine that). This patch also changes the suggested default install location to /opt/sourcenav. Since this is a small change I assume it will be covered by the "Small changes can be accepted without a copyright assignment form on file" text from the contrib webpage. cheers Mo 2002-02-20 Mo DeJong * INSTALL.TXT: Indicate that users should install into /opt/sourcenav by default so as to avoid version conflicts in supporting packages. Add note about -MD in the CFLAGS and --host=windows32 on the configure line when compiling with VC++. * README.TXT: Mention INSTALL.TXT not INSTALL. Index: INSTALL.TXT =================================================================== RCS file: /cvs/sourcenav/src/snavigator/INSTALL.TXT,v retrieving revision 1.1 diff -u -r1.1 INSTALL.TXT --- INSTALL.TXT 2002/02/04 19:05:25 1.1 +++ INSTALL.TXT 2002/02/21 01:42:57 @@ -1,7 +1,7 @@ Binary Install: To install a binary release of Source-Navigator, extract the -files from the archive and add the sourcenav-5.0.1/bin +files from the archive and add the sourcenav-5.X.X/bin directory to your PATH. There is no need to run an installer. You can run Source-Navigator from the command line using the snavigator script. Windows users can also double-click on @@ -12,11 +12,6 @@ These build/install instructions assume that you have already downloaded and extracted the files from the zip or tar file. -We suggest building outside of the source directory. This way, all -build related files for a specific architecture are stored outside -of the source directory. This makes it easy to build multiple -executables from a single source tree. - We suggest building outside of the src directory, this might be a new concept for most users, but it is really quite simple once you get the hang of it. With a build dir, all build @@ -24,16 +19,25 @@ of the src directory, so you can build multiple executables from the same source tree. +We also suggest installing into a directory other than /usr +or /usr/local. Some users have reported version conflicts +between already installed packages like Tcl, Tk, Itcl, and +Tix and the versions of these packages that sourcenav depends +on. By installing into an application specific directory +like /opt/sourcenav, these problems can be avoided. + UNIX Build: To build under a UNIX system, simply create a build directory and run the configure script. The following commands assume the release is 5.0.1 and that the user wants to install -into a non-default location (/usr/sourcenav). +into a non-default location (/opt/sourcenav) that is owned +by root. % mkdir snbuild ; cd snbuild -% ../sourcenav-5.0.1/configure --prefix=/usr/sourcenav +% ../sourcenav-5.0.1/configure --prefix=/opt/sourcenav % make +(become root) % make install Windows Build (VC++): @@ -53,18 +57,18 @@ shell, run the following commands. % export CC=cl -% export CFLAGS="-Z7 -Od" +% export CFLAGS="-Z7 -Od -MD" You can now run the configure script in the normal way. Of course, there are a couple of things to take note of. First, the configure script must be run with a relative path (../sourcenav-5.0.1/configure). Second, the --prefix path must be passed as a fully qualified Windows -style path containing forward slashes (like D:/Cygwin/usr/sourcenav). -The following example shows how /usr/sourcenav mounted at -D:/Cygwin/usr/sourcenav would be passed. +style path containing forward slashes (like D:/Cygwin/opt/sourcenav). +The following example shows how a patch like /opt/sourcenav mounted +at D:/Cygwin/opt/sourcenav would be passed. % mkdir snbuild ; cd snbuild -% ../sourcenav-5.0.1/configure --prefix=D:/Cygwin/usr/sourcenav +% ../sourcenav-5.0.1/configure --host=windows32 --prefix=D:/Cygwin/opt/sourcenav % make % make install Index: README.TXT =================================================================== RCS file: /cvs/sourcenav/src/snavigator/README.TXT,v retrieving revision 1.1 diff -u -r1.1 README.TXT --- README.TXT 2002/02/04 19:05:25 1.1 +++ README.TXT 2002/02/21 01:42:57 @@ -16,5 +16,5 @@ One can find Source-Navigator documentation in the snavigator/doc/html directory. Documentation is available in HTML format only. -Consult the INSTALL file to learn how to build and install +Consult the INSTALL.TXT file to learn how to build and install binaries of Source-Navigator.