README voor FTD Linux/FreeBSD client
====================================


Compileren :

	- Wat is er allemaal nodig?

	  Om de client te kunnen compileren zijn de volgende
	  componenten noodzakelijk.

		* libz >= 1.1.4

		  Deze zal ongetwijfeld reeds op je linux/bsd systeem aanwezig
		  zijn omdat deze voor een ongekende hoeveelheid applicaties vereist is.
		  FreeBSD heeft deze zelfs in het base systeem zitten.

		* glib >= 2.6.0

		* gtk  >= 2.4.0

		  glib 2 is een 'dependancy' van gtk2. Als je gtk2 op je systeem
		  hebt staan dan heb je ongetwijfeld ook glib2 op je systeem.
		  zie: www.gtk.org voor meer informatie omtrent glib/gtk2

		* libxml2 >= 2.2.5

		* libxslt >= 1.0.5

		  Zowel libxml als libxslt zijn bouwstenen die ook gebruikt worden
		  in de Gnome en KDE desktop omgevingen. Gebruik je Gnome of KDE dan
		  hoef je deze dus niet extra te installeren. Beschik je nog niet
		  over deze bibliotheken dan kun je deze hier downloaden :

				http://www.xmlsoft.org

		* pcre >= 5.0

		  Met PCRE is het mogelijk om reguliere expressies uit te voeren.
		  Dit wordt binnen FTD4Linux onder andere gebruikt om smilies te
		  kunnen tonen in de HTML pagina's.

		* mozilla (gecompileerd met gtk2 support)

		  Mozilla is de opensource browser die is voortgekomen uit het vrijgeven
		  van de netscape navigator source code.

		  Heb je geen mozilla, maar heb je wel de firefox variant geinstalleerd staan
		  dan kun je ook met de mozilla compatible onderdelen van firefox aan de gang.
		  Je hebt hier echter wel de header bestanden bij nodig. Controleer dus even of
		  jouw firefox installatie hiermee is geleverd. (gtkembedmoz/gtkmozembed.h)
		  Een 'locate gtkmozembed.h' zou hier snel genoeg uitsluitsel over moeten geven.

		* gtkhtml >= 3.4.0

		  GtkHTML is net zoals Mozilla een library die gebruikt wordt om HTML pagina's
		  te tonen. Sinds FTD4Linux Beta 2 hoeft alleen GtkHTML OF Mozilla geinstalleerd
		  te zijn (alhoewel beiden geen kwaad kan verder)

		* LibCURL >= 7.10.6

		  Deze library zorgt voor de communicatie met de FTD server. Op de meeste (recente)
		  distributie's is dit pakket al voorgeinstalleerd.

	  Optionele dependencies

		* DBUS >= 0.60

		  Deze library zorgt voor communicatie tussen programma's onderling.
		  Indien DBUS geinstalleerd is, zal een extra tooltje geinstalleerd
		  worden genaamd 'ftd4linux_open' waarbij je je webbrowser zo kan
		  aanpassen dat ftd:// links automatisch met FTD4Linux geopend kunnen worden.

		* libnotify >= 0.4.1

		  Indien libnotify geinstalleerd is kan de FTD4Linux Watcher notificaties
		  aanduiden via een popup venster.

		* libgnome/libgnomeui >= 2.0

		  Hiermee wordt er een extra koppeling gelegd tussen FTD4Linux en Gnome.
		  Dit heeft tot gevolg dat wanneer FTD4Linux mogelijk crasht, deze niet
		  spontaan verdwijnt, maar er een foutrapportage-programma opgestart wordt
		  (bug buddy). Hiermee valt genoeg informatie te verzamelen waardoor de
		  ontwikkelaars van FTD4Linux het probleem makkelijk kunnen verhelpen.

	  Weet je niet zeker of je een component geinstalleerd hebt, het configure script zal
          je vanzelf vertellen waneer je iets mist.



	- Aan de slag:

	  De snelste manier om aan de gang te gaan is om het volgende uit te voeren in de top
    	  van je FTD source distributie.

		./configure

	  Dit script zal controleren of je systeem aan de juiste voorwaarden voldoet om het
	  programma te kunnen compileren. Als het script daarmee klaar is, en geen foutmeldingen
	  laat zien kun je het compileren beginnen door in te tikken :

		make

	  De source code wordt nu gecompileerd (omgezet naar binaire data die de processor
 	  kan lezen). Dit kan even duren afhankelijk van je CPU snelheid/hardware.
	  Als laatste dient de gecompileerde code geinstalleerd te worden. Dit gebeurt door
	  in te tikken :

		make install

	  Het programma is nu op je systeem geinstalleerd.

	  Omdat niet alle systemen hetzelfde zijn, zijn er enkele opties die aan het
	  ./configure script kunnen worden meegegeven. Hieronder vind je alle mogelijkheden.

		./configure --with-mozilla_libraries=/pad/naar/mozilla-libs

		./configure --with-mozilla_headers=/pad/naar/mozilla-headers

		./configure --with-openssl_libraries=/pad/naar/openssl-libs

 	  Voor gebruikers van mozilla firefox kan het intressant zijn om de volgende
	  configure opties mee te geven. (ervan uitgaande dat firefox geinstalleerd is
          in /usr/X11R6/lib/firefox )

		./configure --with-mozilla_headers=/usr/X11R6/lib/firefox/include/mozilla-1.5 \
			    --with-mozilla_libraries=/usr/X11R6/lib/firefox/lib/mozilla-1.5


Gebruiken:

	- Opstarten

	  Het programma kan je opstarten door vanuit een terminal 'ftd' te draaien.
	  De eerste keer dat je het programma opstart zal gevraagd worden naar je FTD gebruikersnaam
	  en wachtwoord.


	- HTTP Auth Plugin

	  Om te kunnen communiceren met de FTD server dient er een speciale versleuteling toegepast
	  te worden. Deze versleuteling is het enige onderdeel van FTD4Linux dat niet open source is.
	  Tijdens de configure procedure zal een generic plugin uitgetest worden op jouw systeem.
	  Op de meeste Linux distributie's hoort deze generic plugin gewoon te werken. In dat geval
	  zal de plugin geintegreerd worden in het programma en heb je er verder geen omkijken meer
	  naar. Mislukt deze controle in de configure procedure (omdat je bijv. een MacOSX computer
	  hebt) dan dien je van de FTD4Linux website (http://www.ftd4linux.nl) een plugin voor
	  jouw distributie te downloaden en ergens op je harde schijf te plaatsen (maakt niet uit waar).
	  Als je FTD4Linux dan opstart en op de knop 'Config' klikt zal het configuratievenster
	  getoond worden. Hierin is een tabblad aanwezig genaamd 'Plugins' waar je de locatie van
	  de plugin kan opgeven. Is dit tabblad niet aanwezig, dan maakt jouw versie gebruik van
	  de generic plugin en heb je geen losse plugin meer nodig.


Melden van bugs :

          Op dit moment werken nog niet alle onderdelen van het programma. Voor preciese uitleg wat wel
          en wat niet werkt zie de 'ChangeLog' die meegeleverd is bij dit programma.

	  Heb je een bug in het programma gevonden? Dan horen we dat graag van je.
	  Meer informatie hierover valt te vinden op onze website, http://www.ftd4linux.nl

