Amicygnix-sdk-lite

This is a lightweight developer kit (SDK) for the first release of my X-Window
package for AmigaOS 4 "AmiCygnix". You need to install the official OS4 SDK
before. Together with this package you can compile software, which is written
for the following GUI toolkits:

* GTK+ 2.6.9
* GTK+ 1.2.10
* Athena Widgets (R6.3)

A lot of programs can be compiled with only a few changes. The utility library
"libaos4util" offers set of unix functions not available in Newlib. Because of
this, it also makes sense to compile commandline tools for AmiCygnix as well.
Some of these functions like fork(), execl() etc. are only dummy functions, to
make it possible to link a first (limited) binary.


Content:
--------

  * Binaries / unix shell scripts from the X11 distribution:

    imake         makedepend    makestrs      mkdirhier
    lndir         makeg         mergelib      xmkmf

  * Other binaries:

    audiofile-config   autopoint          awk                envsubst
    esd-config         freetype-config    gawk               gdk-pixbuf-config
    gdk-pixbuf-csource gettext            gettext.sh         gettextize
    glib-config        glib-genmarshal    glib-gettextize    glib-mkenums
    gobject-query      gtk-config         iconv              igawk
    libpng-config      libpng12-config    msgattrib          msgcat
    msgcmp             msgcomm            msgconv            msgen
    msgexec            msgfilter          msgfmt             msggrep
    msginit            msgmerge           msgunfmt           msguniq
    ngettext           pcre-config        pcregrep           pcretest
    pgawk              pspell-config      recode-sr-latin    xft-config
    xgettext           xml2-config        xmllint            xslt-config
    xsltproc

  * libraries from the X11 distribution:

    libfont.a      libFS.a      libICE.a     liblbxutil.a   liboldX.a
    libPEX5.a      libSM.a      libX11.a     libXau.a       libXaw.a
    libXbae.a      libXdmcp.a   libXext.a    libXi.a        libXIE.a
    libxkbfile.a   libXmu.a     libXp.a      libXt.a        libXtst.a

  * Other libraries:

    libXaw3d.a                 Three-D Athena Widgets (Xaw3d) 1.5
    libXpm.a                   XPM (Pixmap) version 3.4i

    libao.a                    libao-0.8.6
    libaspell.a                aspell-0.60.5
    libasprintf.a              gettext-0.16
    libatk-1.0.a               atk-1.10.3
    libaudiofile.a             audiofile-0.2.6
    libbz2.a                   bzip2-1.0.4
    libcairo.a                 cairo-1.4.10
    libcharset.a               libiconv-1.9.2
    libenchant.a               enchant-1.3.0
    libesd.a                   esound-0.2.17
    libexpat.a                 expat-2.0.0
    libexslt.a                 libxslt-1.1.14
    libfontconfig.a            fontconfig-2.3.2
    libfreetype.a              freetype-2.1.10
    libgdk.a                   gtk+-1.2.10
    libgdk_pixbuf-2.0.a        gtk+-2.6.9
    libgdk_pixbuf_xlib-2.0.a   gtk+-2.6.9
    libgdk_pixbuf.a            gdk-pixbuf-0.22.0
    libgdk-x11-2.0.a           gtk+-2.6.9
    libgettextlib.a            gettext-0.16
    libgettextpo.a             gettext-0.16
    libgettextsrc.a            gettext-0.16
    libglib-2.0.a              glib-2.12.4
    libglib.a                  glib-1.2.10
    libgmodule-2.0.a           glib-2.12.4
    libgmodule.a               glib-1.2.10
    libgobject-2.0.a           glib-2.12.4
    libgthread-2.0.a           glib-2.12.4
    libgthread.a               glib-1.2.10
    libgtk.a                   gtk+-1.2.10
    libgtk-x11-2.0.a           gtk+-2.6.9
    libgucharmap.a             gucharmap-1.10.1
    libhangul.a                libhangul-0.0.9
    libiconv.a                 libiconv-1.9.2
    libintl.a                  gettext-0.16
    libjpeg.a                  jpeg-6b
    libpango-1.0.a             pango-1.16.5
    libpangocairo-1.0.a        pango-1.16.5
    libpangoft2-1.0.a          pango-1.16.5
    libpangox-1.0.a            pango-1.16.5
    libpangoxft-1.0.a          pango-1.16.5
    libpcre.a                  pcre-7.1
    libpcrecpp.a               pcre-7.1
    libpcreposix.a             pcre-7.1
    libpng.a                   libpng-1.2.13
    libpspell.a                aspell-0.60.5
    libregex.a                 libregex-4.4bsd-lite
    libsigc-2.0.a              libsigc++-2.0.17
    libtiff.a                  tiff-v3.4
    libungif.a                 libungif-4.1.0
    libXft.a                   xft-2.1.1
    libxml2.a                  libxml2-2.6.19
    libXrender.a               xrender-0.8.3
    libxslt.a                  libxslt-1.1.14
    libz.a                     zlib-1.2.3

  * GTK2 theme engines:

    libclearlooks.a            clearlooks-0.5
    libexperience.a            gtk-engine-experience-0.10.4
    libpixmap.a                gtk+-2.6.9
    libxfce.a                  gtk-xfce-engine-2.2.1

  * GTK1 theme engines:

    libxfce.a                  xfce-3.8.16

  * GTK2 input modules:

    libim-am-et.a              gtk+-2.6.9
    libim-cedilla.a            gtk+-2.6.9
    libim-cyrillic-translit.a  gtk+-2.6.9
    libim-inuktitut.a          gtk+-2.6.9
    libim-ipa.a                gtk+-2.6.9
    libim-thai-broken.a        gtk+-2.6.9
    libim-ti-er.a              gtk+-2.6.9
    libim-ti-et.a              gtk+-2.6.9
    libim-viqr.a               gtk+-2.6.9
    libim-xim.a                gtk+-2.6.9
    libim-classicalgreek.a     im-classicalgreek-0.1.1
    libim-hangul.a             imhangul-0.9.14
    libim-tim.a                wenju-1.6

  * Special libraries:

    libaos4util-newlib.a  A special utility library for missing unix functions.
    libdl.a               Works as a glue library to statically linked modules.

  * All include files from the included packages.


Basic rules
-----------

  AmiCygnix is an alien system. AmiCygnix is independent to the Amiga system
  in most cases. Because of this, you should follow some rules to get a stable
  software:

  * Do not use the libraries and includes included in the "Local" drawer of the
    OS4 SDK! If you need a library not included in this SDK, you must compile it
    especially for AmiCygnix.

  * Normally GCC searches for libs in "SDK:Local" first, even if you add an own
    library path to the options. To prevent this, you could rename the according
    libs (not recommended) or you use an own specs file while compiling and
    linking. You can find a special specs file in "Cygnix:CygnixPPC/lib/gcc"
    called "amicygnix-specs". To use it, add this to your GCC options:

    -specs=/Cygnix/CygnixPPC/lib/gcc/amicygnix-specs

  * Remove all dependencies to the unix assigns USR:, ETC:, BIN: etc.. Use paths
    relative to the "Cygnix:" assign.


Example projects
----------------

  In the directory "Cygnix:Development" you can find the complete package of
  "gpicview-0.1.9". Here you can test, if you're able to configure and compile
  an AmiCygnix project.

  Additionally some simple examples for GTK-1, GTK-2 and X11 are located in
  the drawer "Cygnix/Development/AmiCygnix-SDK/Examples".


More informations
-----------------

  More informations you can find in the amigaguide files "AmiCygnix-SDK.guide"
  and "libaos4util-2.guide" located in the directory "Cygnix/Development/
  AmiCygnix-SDK".


Installation
------------

  The X11 environment AmiCygnix version V1.0 (or higher) and the OS4 SDK V53.15
  (or higher) must be installed before! AmiCygnix is available on OS4-depot
  (http://os4depot.net).

  To install the package, just click on the "Install"-icon. The data will be
  installed into the AmiCygnix package.


Donations
---------

  If you like to support my work, you can make a donation by using paypal:

   http://www.schwan-clan.de/amiga/Donate.html

  Thanks!


Thanks to...
------------

  ... Hans Verkuil for his initial port of X11R6.3 to OS 3.x
  ... Michael Christoph (Beta-Test)