Learn how easy it is to sync an existing GitHub or Google Code repo to a SourceForge project! See Demo

Close

Tree [4b6e05] Release-0_6_1 /
History



File Date Author Commit
admin 2001-07-29 Thomas Eschenbacher Thomas Eschenbacher [daa3dd] the new stuff from KDE2 cvs was too buggy - thr...
bin 2001-08-05 Thomas Eschenbacher Thomas Eschenbacher [e90846] 2001-08-05
doc 2001-09-01 Thomas Eschenbacher Thomas Eschenbacher [6231a0] v0.6.1-1
kwave 2001-08-31 Thomas Eschenbacher Thomas Eschenbacher [3e69fd] bugfix: Track produced duplicate entry in strip...
libgui 2001-08-24 Thomas Eschenbacher Thomas Eschenbacher [7cab56] many fixes and cleanups for the Makefiles, html...
libkwave 2001-08-31 Thomas Eschenbacher Thomas Eschenbacher [3e69fd] bugfix: Track produced duplicate entry in strip...
mt 2001-08-24 Thomas Eschenbacher Thomas Eschenbacher [7cab56] many fixes and cleanups for the Makefiles, html...
plugins 2001-09-01 Thomas Eschenbacher Thomas Eschenbacher [0d3c6e] v0.6.1-1
po 2001-08-24 Thomas Eschenbacher Thomas Eschenbacher [7cab56] many fixes and cleanups for the Makefiles, html...
CHANGES 2001-09-01 Thomas Eschenbacher Thomas Eschenbacher [0d3c6e] v0.6.1-1
GNU-LICENSE 1998-12-12 Martin Wilz Martin Wilz [429088] checkin of historic release 1998-12-13-v0.29-pre2
Hall-Of-Shame.txt 2001-03-09 Thomas Eschenbacher Thomas Eschenbacher [9a5b39] added
Makefile.am 2001-09-01 Thomas Eschenbacher Thomas Eschenbacher [e09da0] v0.6.1-1
Makefile.dist 2001-09-01 Thomas Eschenbacher Thomas Eschenbacher [6231a0] v0.6.1-1
README 2001-08-24 Thomas Eschenbacher Thomas Eschenbacher [7cab56] many fixes and cleanups for the Makefiles, html...
TODO 2001-08-31 Thomas Eschenbacher Thomas Eschenbacher [3e69fd] bugfix: Track produced duplicate entry in strip...
VERSION 2001-09-01 Thomas Eschenbacher Thomas Eschenbacher [0d3c6e] v0.6.1-1
acconfig.h 2001-08-19 Thomas Eschenbacher Thomas Eschenbacher [275f11] swap file support reached beta state
acinclude.m4 2001-07-27 Thomas Eschenbacher Thomas Eschenbacher [8efd04] fetched a new autoconf/automake environment fro...
config.h.in 2001-08-21 Thomas Eschenbacher Thomas Eschenbacher [bace19] fixed one more multithreading problem
configure.in 2001-09-01 Thomas Eschenbacher Thomas Eschenbacher [0d3c6e] v0.6.1-1
doxy.cfg.in 2001-05-20 Thomas Eschenbacher Thomas Eschenbacher [c5c04b] some \#include cleanups
install-sh 2000-07-12 Thomas Eschenbacher Thomas Eschenbacher [5113e1] version 0.5.4
kwave.kdevprj 2001-08-26 Thomas Eschenbacher Thomas Eschenbacher [f3df90] release-0.6.1
kwave.lsm 2001-09-01 Thomas Eschenbacher Thomas Eschenbacher [0d3c6e] v0.6.1-1
kwave.spec.in 2001-08-25 Thomas Eschenbacher Thomas Eschenbacher [21e757] some more fixes for the Makefiles to prevent re...
stamp-h.in 1998-12-12 Martin Wilz Martin Wilz [429088] checkin of historic release 1998-12-13-v0.29-pre2

Read Me

0. PREFACE:
==========

This is the "kwave" source distribution, a sound editor for KDE2.

 ----------------------------------------------------------------------------
| It is now hosted on SourceForge, so you are welcome to visit               |
| the Kwave homepage at: "http://kwave.sourceforge.net". Normally the        |
| informations you can get there are more up to date than the stuff          |
| you get in this file. This file is only intended for users who do          |
| not have the possibility or do not like to read online.                    |
|                                                                            |
| Please also take a look at the Kwave handbook. It is available in html     |
| and is also included in the source packages under "doc/en/index.html"      |
 ----------------------------------------------------------------------------

If you are interested what has been done and what has to be done, then
look at the files "CHANGES" and "TODO" included in this package.

The project is developed and published under the GNU GENERAL PUBLIC LICENSE
(Version 2, from June 1991), take a look at the file "GNU-LICENSE" included
in the source package.

1. COMPILING MANUALLY:
=====================

>>> NOTE: You don't have to do this on an rpm based system, you can
          easily build a rpm package of Kwave. Please skip this and
	  advance to section 2.

It's quite simple. First get the source archive, unpack it under your
favorite source-code directory (or under /tmp), change to this directory
and then type:

export KDEDIR=/opt/kde2
export QTDIR=/usr/lib/qt2
./configure
make
make install

(you might have to change the qt and kde paths above according
to your distribution)

2. RPM-SUPPORT:
==============

You can build nice binary and/or source rpm packages of kwave in one
of the following ways. Note: Either you do everything as root or you
must have write permissions in the following directories:

* /tmp
* /usr/src/packages/BUILD
* /usr/src/packages/RPMS
* /usr/src/packages/SOURCES
* /usr/src/packages/SPECS
* /usr/src/packages/SRPMS

Installing the rpm package normally requires root permissions.

2.1 Building a binary rpm from archive file:
-------------------------------------------

Simply get the source archive (for example kwave-0.6.0.tar.gz) and
then type:

export QTDIR=/usr/lib/qt2
export KDEDIR=/opt/kde2
rpm -ta kwave-0.6.0.tar.gz

If you want to build for a different architecture than your current, you
might want to add the parameter "--target=...", for example:

rpm -ta --target=i586 kwave-0.6.0.tar.gz

compiles for pentium architecture.

2.2 Building a source and binary rpm from the source tree (CVS):
---------------------------------------------------------

Assuming that you already have unpacked the source archive in some
directory you can simply type

export QTDIR=/usr/lib/qt2
export KDEDIR=/opt/kde2
make -f admin/Makefile.common
./configure
make src.rpm          (and you get only a source rpm)
make rpm              (and you get both, a binary and a source rpm)

Instructions on how to get the sources via CVS can be found in the
Kwave handbook and on the Kwave project homepage at SourceForge
(see "http://sourceforge.net/cvs/?group_id=6478").

3. RELOCATING THE BINARY RPM:
============================

The binary rpm package of kwave is "relocatable". This means that you can
build the package on a system with the KDE2 base directory set to some
location (like for example /usr/local) and install it on an other system
and/or into a different directory.

For example: you got the binary rpm from a friend who has a SuSE system
(where the KDE2 base dir is /opt/kde2) and want to install it on RedHat (where
the KDE2 base dir is /usr). Then just give a different prefix when installing
the rpm:

rpm -ivh --prefix=/usr kwave-0.6.0.i386.rpm

This modifies the path where the program is installed and it is strongly
recommended that this is a directory that is contained in the KDEDIRS
environment variable, otherwise Kwave would be unable to find it's menu
configuration, plugins, preset files and so on...

4. PENTIUM OPTIMIZATION:
=======================

Yes, you can compile the RPM packages for pentium and pentium pro by using
some defines in your rpmrc file. There are also some instructions on how to
build optimized for AMDs Athlon in the online documentation (The Kwave
Handbook).

You can either modify your system's /etc/rpmrc file or the .rpmrc file in
your home directory. There you can specify option lines like these:

optflags: i386 -O2 -m486 -DNDEBUG
optflags: i586 -O2 -march=pentium -DNDEBUG -fomit-frame-pointer
optflags: i686 -O2 -march=pentiumpro -DNDEBUG -fomit-frame-pointer

(found that at "http://www.keywarrior.net/duesti/rpmopt.en.html")

This means that on an i586 architecture the rpm package will be compiled
using -march=pentium and so on, you might extend or adapt these to your
own needs.

The options specified here are set into the environment variable 
RPM_OPT_FLAGS during compilation, so if you don't have an rpm based
environment and have to compile like in (1) you can set this variable
manually and get the same effect. For example:

export RPM_OPT_FLAGS="-O2 -march=pentium -fomit-frame-pointer"

Then go to chapter 1 and do ./configure / make / make install...

5. REQUIREMENTS FOR THE ONLINE HELP:
===================================

First of all, read the instructions there:
"http://i18n.kde.org/doc/install/index.html"

for SuSE 7.2:
-------------

* sgml-skel
* sp
* sp_libs
* jade_dsl
* sgmltool
* docbook-utils (contains jw)
* docbktls
* docbook-dsssl-stylesheets
* docbook-xsl-stylesheets
* docbook_3
* docbook_4
* html-dtd
* iso_ent

rpm -Uvh docbook-dtd31-sgml-1.0-6.noarch.rpm
rpm -Uvh sgml-common-0.6.1-1.noarch.rpm
rpm -Uvh docbook-dtd31-sgml-1.0-6.noarch.rpm
rpm -Uvh docbook-utils-0.6.6-1.noarch.rpm
rpm -Uvh docbook-style-dsssl-1.61-1.noarch.rpm

all other distributions:
------------------------

try to install the following packages,
e.g. from ftp://ftp.kde.org/pub/kde/devel/docbook/

* jade-1.2.1-6
* perl-SGMLSpm-1.03ii-3
* sgml-common-0.6.1-1
* sgmltool-1.0.9-278
* jadetex-2.20-6
* docbook-dtd31-sgml-1.0-6
* docbook-utils-0.6.6-1
* docbook-style-dsssl-1.61-1


6. REQUIREMENTS:
===============

For compilation you need a working autoconf/automake environment, a good
C/C++ compiler, the qt2 and the kde2 libraries. I am currently developing
under a SuSE-7.1 distribution (i386 architecture) using at least the
following packages:

* autoconf-2.13-283
* automake-1.4-278
* make-3.79.1-80
* gcc-2.95.3-73/gpp-2.95.3-73        (the C / C++ compiler)
* libgpp-2.95.3-73                   (C++ library, including STL)
* glibc-2.2-9                        (the GNU C library)
* gettext-0.10.35-132                (for internationalization)
* rpm-3.0.4-72                       (for rpm support)
* sed-3.02, awk-3.0.4, bash-2.03     (used by some scripts)

Nearly everything from ftp.kde.org, especially the following
packets should be sufficient for building:

* qt-2.3.0-13 + qt-devel-2.4.0-13    (the Qt-2 library)
* qt-designer-2.3.0-10               (for designing new-style dialogue windows)
* kdelibs-(devel-)2.1.2-0            (the KDE2 base libraries)
* kdemultimedia-(devel-)2.1.1-6      (multimedia/aRts support)
* kdesdk-2.1.1-7                     (some additional tools)

known distributions / architectures:
------------------------------------

* SuSE-7.1 / i386, i586
  [where I currently develop]

* SuSE-6.4 / i386, i586
  [still tested, but needs an update of rpm]

* SuSE-6.2 / i386, i586 
  [where I started to develop it, now untested]

* RedHat-6.1 (Halloween IV) / i386 
  [tested v0.5.x with it, but now no longer tested]

Compilation might also work on many other distributions and different 
versions of compilers and libraries, or even on different architectures.

So if you have success in compiling and using kwave under a different system, 
please let me know !

If the program does NOT compile, please let me know too - and/or consider
an update of your system if your packages are older than those mentioned
above.

You need at least glibc > 2.07 for pthreads support - earlier versions of
libpthread (included in glibc) seem to crash...

Not tested is libc5 with linuxthreads, if someone succeeds with this
combination please notify me !
(Note that linuxthreads has requirements for specific libc versions)

7. SOME HISTORY:
===============

This project has been started by Martin Wilz in summer 1998 and has been
developed and improved by him an some other people. In November 1999 I started
to fix some little bugs here and there and stepped into the source code of
the program deeper and deeper. Up to today I have extended, rewritten or 
revised nearly every component of the program and spend much time on it.
Since summer 1999 I have taken over the project leadership and I am still
working on it.

So good luck, and if not, keep me informed about bugs and wishes...

   Thomas Eschenbacher <Thomas.Eschenbacher@gmx.de>