joachim99@2: KDiff3-Readme joachim99@2: ============= joachim99@2: joachim99@2: Author: Joachim Eibl (joachim.eibl@gmx.de) joachim99@12: Copyright: (C) 2002-2003 by Joachim Eibl joachim99@53: KDiff3-Version: 0.9.81 joachim99@2: joachim99@2: joachim99@2: KDiff3 is a program that joachim99@53: - compares and merges two or three input files or directories, joachim99@2: - shows the differences line by line and character by character (!), joachim99@2: - provides an automatic merge-facility and joachim99@2: - an integrated editor for comfortable solving of merge-conflicts joachim99@53: - has support for KDE-KIO (ftp, sftp, http, fish, smb) joachim99@53: - and has an intuitive graphical user interface. joachim99@53: joachim99@53: joachim99@53: Do you want help translating? Read the README in the po-subdirectory! joachim99@2: joachim99@2: joachim99@2: Licence: joachim99@2: GNU GENERAL PUBLIC LICENSE, Version 2, June 1991 joachim99@2: This program is free software; you can redistribute it and/or modify joachim99@2: it under the terms of the GNU General Public License as published by joachim99@2: the Free Software Foundation; either version 2 of the License, or joachim99@2: (at your option) any later version. joachim99@2: joachim99@2: This program is distributed in the hope that it will be useful, joachim99@2: but WITHOUT ANY WARRANTY; without even the implied warranty of joachim99@2: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the joachim99@2: GNU General Public License for more details. joachim99@2: joachim99@2: You should have received a copy of the GNU General Public License joachim99@2: along with this program; if not, write to the Free Software joachim99@2: Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA joachim99@2: joachim99@2: For details see file "COPYING". joachim99@2: joachim99@12: Exception from the GPL: joachim99@12: As a special exception, the copyright holder Joachim Eibl gives permission joachim99@12: to link this program with the Qt-library (commercial or non-commercial edition) joachim99@12: from Trolltech (www.trolltech.com), and he permits to distribute the resulting joachim99@12: executable, without including the source code for the Qt-library in the joachim99@12: source distribution. joachim99@12: joachim99@2: joachim99@2: Requirements & Installation: joachim99@53: Version 0.9.81 provides special support for KDE3, but it can also be joachim99@12: built without KDE3 if the Qt-libraries are available. joachim99@12: (I also tested the program under Windows.) joachim99@2: joachim99@12: You always need joachim99@53: - kdiff3-0.9.81.tar.gz joachim99@2: joachim99@12: For building the KDE3-version joachim99@12: - KDE>=3.1 and QT>=3.1-libraries. joachim99@12: - gcc, g++ with version >=3.2 joachim99@12: joachim99@12: For building the Qt-only-version joachim99@53: - QT-libraries (version >=3.1.0). joachim99@12: (www.trolltech.com) joachim99@12: - for Un*x: gcc, g++ with version >=3.2 joachim99@12: - for Windows: VC6 joachim99@12: joachim99@2: joachim99@2: Installation for KDE3: joachim99@2: - Make sure your shell-variable QTDIR is correct. (echo $QTDIR). joachim99@2: If it doesn't contain the correct path, type joachim99@2: export QTDIR=your_path_to_qt (e.g. /usr/lib/qt3) joachim99@53: - cd into the directory kdiff3-0.9.81 and type joachim99@12: - ./configure --prefix=/opt/kde3 (your KDE3 directory here) joachim99@12: - (make clean) (Required if you already compiled once.) joachim99@12: - make (Run compilation) joachim99@12: - make install (You must have root-rights for this step.) joachim99@2: joachim99@2: For details also see the generic instructions in file "INSTALL". joachim99@2: joachim99@12: If some icons are not visible or don't seem right, probably the prefix joachim99@12: was wrong. Check where your KDE3 installation is located and joachim99@12: use that directory with the prefix-option of configure. joachim99@12: For SuSE and most distributions the prefix usually is /opt/kde3. joachim99@12: For Redhat and Mandrake the prefix usually is /usr. joachim99@12: For a local installation, that doesn't need root rights try joachim99@12: - ./configure --prefix=$KDEHOME ($KDEHOME probably is the same as $HOME/.kde) joachim99@12: - make joachim99@12: - make install (Installs everything in $KDEHOME. No root rights required.) joachim99@12: - Run $KDEHOME/bin/kdiff3. ($KDEHOME/bin is probably not in your path.) joachim99@12: Warning: If a local installation and a global installation exist, the local joachim99@12: menu, toolbar, help etc. will be used, even if you start the global joachim99@12: executable. To avoid confusion, better remove the local version then. joachim99@12: (rm -R `find $KDEHOME -name "*kdiff3*" -not -name "kdiff3*rc"`) joachim99@12: joachim99@53: Upgrading KDiff3 for KDE: joachim99@53: If you already installed an older version or KDiff3 and you have the joachim99@53: impression, that the new version doesn't work as described, you should try to joachim99@53: remove all files belonging to KDiff3 before reinstalling. joachim99@53: Try this search command to locate KDiff3-related files: joachim99@53: find $HOME/.kde /usr /opt -iname "*kdiff3*" joachim99@53: (Will take a few minutes.) joachim99@53: joachim99@53: joachim99@12: joachim99@12: Installation for the Qt-only-platforms for Un*x: joachim99@12: (for Qt >=3.1.0) joachim99@12: - Make sure your shell-variable QTDIR is correct. (echo $QTDIR). joachim99@12: If it doesn't contain the correct path, type joachim99@12: export QTDIR=your_path_to_qt (e.g. /usr/lib/qt) joachim99@53: - cd into the directory kdiff3-0.9.81/src and type joachim99@12: - make -f Makefile.qt joachim99@12: - make -f Makefile.qt install (You must have root-rights for this step.) joachim99@12: (copies the files into /usr/local/bin and /usr/local/share/doc/kdiff3) joachim99@12: - Note: The file kdiff3.pro was used to generate the Makefile.qt: joachim99@12: qmake kdiff3.pro -o Makefile.qt joachim99@12: joachim99@12: joachim99@12: joachim99@12: Build for Windows: joachim99@53: Use qmake and kdiff3.pro to generate joachim99@12: an appropriate Makefile. joachim99@12: qmake kdiff3.pro -o Makefile joachim99@12: joachim99@12: joachim99@12: Build for Mac: joachim99@12: - I couldn't test this, so you might have to experiment a bit. joachim99@12: - Start by generating a Makefile with joachim99@12: - qmake kdiff3.pro -o Makefile joachim99@12: - If you succeed, I'd like to know how so I can document it here. joachim99@12: joachim99@53: joachim99@2: Start from commandline: joachim99@2: - Comparing 2 files: kdiff3 file1 file2 joachim99@2: - Merging 2 files: kdiff3 file1 file2 -o outputfile joachim99@2: - Comparing 3 files: kdiff3 file1 file2 file3 joachim99@2: - Merging 3 files: kdiff3 file1 file2 file3 -o outputfile joachim99@2: Note that file1 will be treated as base of file2 and file3. joachim99@2: joachim99@12: If all files have the same name but are in different directories, you can joachim99@12: reduce typework by specifying the filename only for the first file. E.g.: joachim99@12: - Comparing 3 files: kdiff3 dir1/filename dir2 dir3 joachim99@12: (This also works in the open-dialog.) joachim99@12: joachim99@2: If you start without arguments, then a dialog will appear where you can joachim99@2: select your files via a filebrowser. joachim99@2: joachim99@2: For more documentation, see the help-menu or the subdirectory doc. joachim99@2: joachim99@2: Have fun!