Installation

Perform installation according to your specific target platform.

• Installing on Unix systems (tarball)
• Installing on Unix systems (RPM)
• Installing on Debian systems (deb)
• Installing on Windows systems
• Installing on Mac OS X

 

Installing on Unix systems (tarball)

The following is the general, platform independent install procedure.

• Unpack the distribution file:
  
  tar -xzvf cb2bib-1.4.9.tar.gz
  
  
• Move to cb2Bib directory:
  
  cd cb2bib-1.4.9
  
  
• Type the following commands:
  
  ./configure --prefix /usr/local
  make
  make install
  
  

Installation is now complete.

Note: If the ./configure step would fail while having the appropriate QT libraries and utilities installed, try qmake instead of ./configure, and configure manually the required file directories once cb2Bib first starts.

Note: ./configure has the --disable-cbpoll flag to disable clipboard polling. Polling is required to detect clipboard changes on non-Qt/KDE applications. If enabled, compilation depends on X11 headers.

To uninstall type make uninstall from within the cb2Bib compilation directory.

 

Installing on Unix systems (RPM)

To build an appropriate RPM for your platform, type, e. g.,

rpm --rebuild --target=i686 cb2bib-1.4.9-1.src.rpm

or a distro-dependend, equivalent command (perhaps rpmbuild). This will compile cb2Bib and build the required binary RPM (often placed at the /usr/src/packages/RPMS/i686 directory). See also Release Note cb2Bib 0.6.90 regarding QTDIR environment if having compilation problems. Once the binary RPM is build, installation is as follows.

To install your RPM binary, simply type

rpm -Uhv cb2bib-1.4.9-1.i686.rpm

To uninstall, type

rpm -e cb2bib-1.4.9

 

Installing on Debian systems (deb)

To install cb2Bib, first make sure that you are actually using the packages for the proper Debian suite, as configured in the /etc/apt/sources.list file.

Next, issue the following commands as root,

apt-get update

apt-get install cb2bib

to resolve all required dependencies and install the program.

 

Installing on Windows systems

On Windows platforms installation is simple. Just launch the Windows Installer

cb2bib-1.4.9-install.exe

and follow the installation wizard indications. To uninstall, click the 'Unistall' icon.

 

Installing on Mac OS X

To install cb2Bib from its sources, make sure you have the following build tools on your system:

• Qt toolkit version 4.4.0 or later (qt-mac-*.dmg) from Trolltech:
  
  ftp://ftp.trolltech.com/qt/source/
  
  
• XCode from Apple:
  
  https://developer.apple.com/technologies/tools/
  
  
• bin-utils via darwinports
  
  
  
• Buiding with make/Makefile:
  
  Type on a shell window:
  
  tar -xzvf cb2bib-1.4.9.tar.gz
  cd cb2bib-1.4.9
  ./configure --prefix /Applications/cb2Bib --qmakepath /Developer/Tools/Qt/qmake
  make
  make install
  
  
• Buiding with XCode:
  
  Type on a shell window:
  
  tar -xzvf cb2bib-1.4.9.tar.gz
  cd cb2bib-1.4.9
  /Developer/Tools/Qt/qmake cb2bib.pro -spec macx-xcode
  
  Open cb2bib.xcodeproj with XCode and build from there.
  
  

Notes:

• It has been reported that qmake does not make usable XCode projects from subdir qmake projects. It is possible to produce one-single .pro file for the whole project, by typing qmake -project -r to create a base .pro file. An example and detailed instructions can be found at ./qmake/cb2bib-osx.pro.

• The author does not have a MacOSX account where to test sources and scripts at development time. User feedback is, therefore, extremely important. Please, help to keep above description as much accurate and clear as possible.

 

See also:

Configuration