[Lprof-devel] lprof README.NetBSD,NONE,1.1 README,1.5,1.6

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/lprof/lprof
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv30304

Modified Files:
	README 
Added Files:
	README.NetBSD 
Log Message:
README: add notes about things that are no longer relevant (qTiffIO,
1.10 building instructions).  Mark other questionable items.  Enhance
build instructions.

README.NetBSD: build instructions for NetBSD (doesn't work yet; I
believe SCons support for support libraries in other than /usr is
still not right).

Index: README
===================================================================
RCS file: /cvsroot/lprof/lprof/README,v
retrieving revision 1.5
retrieving revision 1.6
diff -C2 -d -r1.5 -r1.6
*** README	1 Nov 2005 19:45:44 -0000	1.5
--- README	30 Nov 2005 14:05:40 -0000	1.6
***************
*** 1,3 ****
! 

   THIS SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
--- 1,3 ----
! $Id$

   THIS SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
***************
*** 13,24 ****
   OF THIS SOFTWARE.

!  The lprof is distributed under

                  GNU GENERAL PUBLIC LICENSE

  Version 1.10.x includes the qtiffio library by Markus L. Noga 
  located here http://www.noga.de/markus/qtiffio/ Which is distributed under

  		GNU Lessor General Public License 

   As a special exception, Klas Kalass and Marti Maria gives permission to link 
--- 13,30 ----
   OF THIS SOFTWARE.

! lprof is distributed under

                  GNU GENERAL PUBLIC LICENSE

+ 
+ [XXX THIS SECTION PROBABLY SHOULD BE DELETED AS NO LONGER RELEVANT]
+ [NOTE: ALSO qTiffIO_LICEnSE should be deleted]
+ 
  Version 1.10.x includes the qtiffio library by Markus L. Noga 
  located here http://www.noga.de/markus/qtiffio/ Which is distributed under

  		GNU Lessor General Public License 
+ [END SECTION THAT PROBABLY SHOULD BE DELETED AS NO LONGER RELEVANT]
+ 

   As a special exception, Klas Kalass and Marti Maria gives permission to link 
***************
*** 50,58 ****
    In order to execute the profiling utilities, you will need:

!   - Trolltech's Qt installed (www.trolltech.com)
!   - Littlecms color engine installed (www.littlecms.com)
!   - GNU C compiler gcc or equivalent installed. MS VC++ 6 in Windows 
!     systems required in order to use Qt.
!   - A working make utility. (not required on windows)

     Version 1.11 and later needs TiffIO installed to be able to use 
--- 56,66 ----
    In order to execute the profiling utilities, you will need:

!   - Trolltech's Qt installed (www.trolltech.com) [XXX which version]
!   - Littlecms color engine installed (www.littlecms.com) [XXX which version]
!   - GNU C compiler gcc or equivalent installed. [XXX c99?  gcc version?]
!     MS VC++ 6 in Windows systems required in order to use Qt.
!   - A working make utility. (not required on windows) [XXX scons??]
! 
!   [XXX This readme is in cvs and thus should only apply to 1.11.]

     Version 1.11 and later needs TiffIO installed to be able to use 
***************
*** 62,65 ****
--- 70,75 ----
        http://artis.imag.fr/Software/TiffIO/  

+   [XXX scons for build]
+ 
    Additionally, in order to profile scanner or camera, you will 
    need an IT8 target.  These are available from here:
***************
*** 68,71 ****
--- 78,82 ----

+ [XXX THIS ALL SHOULD BE DELETED]

    Installation version 1.10.1
***************
*** 114,135 ****
    setting to install the software use those same setting when running uninstall.

!   Installing verions 1.11
    =======================

!   Unpack the tarball.  Verions 1.11 uses SCons to build and install the 
    software and data files.  You will need to install SCons if you do not 
    already have it on your system.  In addition scons requires python 1.53 
    or later to run.  You can download SCons from here http://www.scons.org/

!   In the root directory of the lprof source tree use the following commands:

!   scons PREFIX= your installation prefix

!   To override the default installation prefix.  Currently this will 
!   default to /usr/local.

!   scons install 

!   Will install the software and related datafiles to the correct locations 
    in PREFIX.  By default this will place the executable files in 
    /usr/local/bin and data files in /usr/local/share/lprof unless the user 
--- 125,153 ----
    setting to install the software use those same setting when running uninstall.

! 
! [END THIS ALL SHOULD BE DELETED]
! 
!   Building and Installing [delete verions 1.11 ]
    =======================

!   Lprof version 1.11 uses SCons to build and install the 
    software and data files.  You will need to install SCons if you do not 
    already have it on your system.  In addition scons requires python 1.53 
    or later to run.  You can download SCons from here http://www.scons.org/
+   [XXX move to prereq section, and separate build from runtime requuirements]

!   Unpack the tarball or obtain sources from CVS, and in the root
!   directory of the lprof source tree invoke

!   $ scons PREFIX=/where/to/install

!   to build lprof.  If PREFIX is not specified, it defaults to /usr/local.
!   Then (with adequate privileges to write to $PREFIX):

!   [XXX Add instructions about how to specify the location of QT]

!   $ scons install 
! 
!   to install lprof (executables, data, help) to the correct locations 
    in PREFIX.  By default this will place the executable files in 
    /usr/local/bin and data files in /usr/local/share/lprof unless the user 
***************
*** 138,162 ****
    home directory.

!   scons -c 

!   Will remove all files created while building the software from the build 
!   directories.

!   scons -c install 

!   Will do everything scons -c does plus remove any files that were installed 
!   by "scons install" into PREFIX.

!   Running scons will build two executable files which will end up in the build
!   directory for whatever platform you are building on.  For example on Linux the
!   executables will end up in:

    lprof/build/linux

!   The main executable is now named lprof.  It integrates the functionality 
!   of the four main programs that were build by earlier versions - 
!   qtmeasurementtool, qtmonitorprofiler, qtscannerprofiler and qtprofilechecker- 
!   into a single fully integrated piece of software.  icc2it8 is also part 
!   of version 1.11 and is unchanged from earlier versions.

--- 156,185 ----
    home directory.

!   To clean the working directory invoke

!   $ scons -c 

!   which will remove all files created while building the software from
!   the build directories.

!   To remove lprof from the system, invoke (with adequate privileges):

!   $ scons -c install 
! 
!   which will do everything scons -c does and also remove files installed 
!   by "scons install" (into PREFIX).
! 
!   Running scons will build two executable files which will end up in
!   the build directory for whatever platform you are building on.  For
!   example on Linux the executables will be created in:

    lprof/build/linux

!   The main executable is named lprof, and includes the functionality
!   of the four main programs that were built by earlier versions
!   (qtmeasurementtool, qtmonitorprofiler, qtscannerprofiler and
!   qtprofilechecker) into a single fully integrated piece of software.
!   icc2it8 is also part of version 1.11 and is unchanged from version
!   1.10.

***************
*** 182,185 ****
--- 205,209 ----
   yet use them. To begin translating lprof, run:

+  [XXX is this still true in the scons world?]  
       make translations-update

--- NEW FILE: README.NetBSD ---
#!/bin/sh

# $Id: README.NetBSD,v 1.1 2005/11/30 14:05:39 lexort Exp $

# This README is really a script to build lprof on NetBSD, assuming
# that pkgsrc packages are installed (in /usr/pkg).  One needs
# qt3-libs, qt3-tools, libtiff, lcms.  One should also need libtiffIO,
# the qt wrapper for tiff, but that isn't packaged yet.

# This does not yet work.

export QTDIR=/usr/pkg/qt3

scons \
  --debug=explain --cache-disable -n \
  qt_directory=/usr/pkg/qt3
  notiffio=1 PREFIX=/usr/pkg \
  # XXX \
  cflags="-I/usr/pkg/include -R/usr/pkg/lib -L/usr/pkg/lib" \
  CPPFLAGS=-I/usr/pkg/include LDFLAGS="-R/usr/pkg/lib -L/usr/pkg/lib"