Qucs - documentation

• Requirements

Qucs needs Qt® by Trolltech®. The current version is known to work with Qt 3.1 and later.

• Installation

Unpack the distribution tarball:

    $ tar xvzf qucs-<version>.tar.gz               (using GNU tar)
    $ gzip -cd qucs-<version>.tar.gz | tar xvf -   (using another tar)

Change into the source directory:

    $ cd qucs-<version>

Configure the source package for your system:

    $ ./configure

Now compile the package:

    $ make

Install Qucs:

    $ make install

You must have root privileges if you want to install the package in the standard location (/usr/local) or in any location that is only writable by root. For further information on installing the package, please consult the file INSTALL included in the distribution.

Please note: Users of the FreeBSD OS may use a GNU make (probably gmake) to compile and install the package.

• Requirements

• Autoconf version 2.57 (at least)
• GNU automake 1.7.0 (at least)
• flex 2.5.31 (but at least 2.5.9)
• GNU Bison 1.875d
• Qt installation >= version 3.1 (by Trolltech)
• GNU M4 (any version)
• GNU gperf 3.0.1
• adms 2.2.4 (at least)

• Building

For each of the CVS repositories it is necessary to:

        $ sh autogen.sh
        $ ./configure --enable-maintainer-mode --prefix=/installation/path

• Testing

For testing purposes the user has to install the package previously.

        $ make install
        $ cd /installation/path/bin

• Cygwin natively -- tested

This works out of the box very likely on a usual GNU/Linux system. Of course Qt® and the X-Server including development files must be installed.

• MinGW32 natively -- untested
• MinGW32 cross-compiling -- tested

This is the preferred method to build Qucs for Win32. On an Debian system the mingw32-cross compiler is available. The Q../Free version can be built using either cross-compiling or also natively. Once this has been accomplished it is possible to compile Qucs.

        $ QTDIR=/path/to/qt i386-mingw32-configure --prefix=/mingw
        $ make
        $ make install

• MSVC natively -- tested

CVS contains some extra *.ap files and a perl script which produces the appropriate project files (*.dsp and *.dsw).

        $ sh autodsp.sh

With the Q../Free version compiled using MSVC and setting QTDIR appropriately it is possible to use the qucs.dsw and qucscore.dsw files to compile Qucs with MSVC.

In order to build Qucs on a MacOSX you need to have Apple's X11 installed. Also a native build of Qt3/Mac is necessary. This will make the native Aqua widget set available for Qucs.

• Build Qt3/Mac

First download latest Qt3/Mac (version 3.3.8) from e.g. qt-mac-free-3.3.8.tar.gz. Then unpack it:

        $ cd /Developer
        $ tar xvzf ~/qt-mac-free-3.3.8.tar.gz
        $ mv qt-mac-free-3.3.8 qt3
        $ cd qt3

For MacOSX 10.5 (Leopard) you need to apply a patch.

        $ patch < ~/qt3-leopard.diff

Then configure and build Qt.

        $ export QTDIR=/Developer/qt3
        $ export PATH=$PATH:$QTDIR/bin
        $ export DYLD_LIBRARY_PATH=$DYLD_LIBRARY_PATH:$QTDIR/lib
        $ ./configure -shared -release -thread
        $ make

This takes some time now. After that you have a working Qt3/Mac on your computer.

• Build Qucs

In order to build and install Qucs you use now the previously built Qt3/Mac.

        $ tar xvzf qucs-<version>.tar.gz
        $ cd qucs-<version>
        $ ./configure --prefix=/usr/local
        $ make
        $ make install

Under MacOSX applications are actually directory structures where the binaries, icons, etc. are stored. These are created during the last Makefile install step from Qucs version 0.0.15 on.

Finally you can link the main Qucs application into your Applications folder by running the following command.

        $ ln -s /usr/local/bin/qucs.app /Applications/qucs.app

You're finally done!