/*****************************/
/***** English version *******/
/*****************************/

Kicad binaries exists for Linux and Windows (XP, 2000)
Files (schematic, boards, libraries) created on both systems are totally compatibles.

Used language:
Doc files are in french, english, spanish, portuguese_brazilian.
Kicad user interface is in french, english, spanish, portuguese_brazilian, italian
User interface is in English for other countries.
.It is easy to add a new translation with poedit.
Kicad can use this translation without any change.
(poedit is used to create the french translation).
See http://poedit.sourceforge.net.
See the doc file kicad/help/GUI_comment_traduire.sxw
Contact me for more details.

Installation form archives:
kicad-yyyy-mm-dd.zip and doc_components-yyyy-mm-dd.zip (Windows XP and 2000 (Window 98 not tested)
or
kicad-yyyy-mm-dd.tgz and doc_components-yyyy-mm-dd.tgz (Linux )

-yyyy-mm-dd is the version number (year-month-day)

Untar or unzip kicad
	- this will create the kicad tree in the current directory.
And install the documentation components (pdf files):
	- In kicad/library, untar or unzip doc_components.tar or .zip

***********************
**  Windows Install: **
***********************
Goto C:\ or D:\ (or other prefered directory).
Examples are for an install on C:\.
Unzip kicad-yyyy-mm-dd.zip
You must have created c:\kicad.
In kicad\library, unzip doc_components.zip
Windows executables are in c:\kicad\winexe.
The main program is kicad.exe and from it you can run other programs
(schematic, pcb, utilities: cvpcb, gerbview and other) )
I suggest you create a shortcut to c:\kicad\winexe\kicad.exe


***********************
**  Linux Install:   **
***********************
You do must have libc.so.6 (do not work with libc.so.5)
You must be "root".
goto /usr/local
Untar kicad-yyyy-mm-dd.tgz : tar zxvf kicad.-yyyy-mm-ddtgz (ou unzip kicad-yyyy-mm-dd.zip)
In kicad/library, untar doc_components-yyyy-mm-dd.tgz (or unzip doc_components-yyyy-mm-dd.zip)
The main program is /usr/local/kicad/linux/kicad
If you use KDE, users can copy the shortcut /usr/local/kicad/linux/kicad.desktop
in <user home directory>/Desktop and use it to run kicad.

3D modeler wings3D:
(Usefull only if you plan to create 3D shapes for Printed board modules)
Archive and doc files (Linux and windows ) are in ../kicad/wing3d
goto www.wings3d.com to have more details.
Pcbnew use the exported files in wrml (.wrl) format from wings3d (not the native .wings format).

Documentation:
Currenty in french, english, spanish, portuguese.
"On line" in html format.
source files (200 pages) are in OpenOffice (www.openoffice.org) format.
Can be read, printed and/or modified with OpenOffice.
See files in kicad/help/doc_src/*

Kicad tree:
kicad/winexe: windows (XP et 2000 compatible) binaries.
kicad/linux: linux  binaries (Mandrake 9.2 and 10.0 tested,
	probably work fine for distributions who have an recent libc)
kicad/library: libraries for schematic
kicad/library/doc: documentation files for schematic components (.pdf)
	(readable from schematic if you have acrobat ou Xpdf)
kicad/modules: module libraries for printed boards.
	files *.mod are the libraries,
	and files *.brd are printed board you can see with pcbnew
	files *.brd show the existing modules (and 3D shapes) in libraries. 
kicad/modules/packages3d: many 3D shapes (.wrl et .wings format) for existing modules

kicad/demos: Usefull...
kicad/internat: dictionnaires des langues (actuellement anglais->francais) pour les menus
kicad/help: On line help (in french)
kicad/help/doc_src: Documentation (in french) (source doc, 200 pages) under OpenOffice.

Warning:
Do not change the kicad tree, or the location of binary files,
or kicad will **not** be able to found other kicad files (configuration, libraries...)


/*******************************/
/***** version Francaise *******/
/*******************************/

Les executable kicad existent pour Linux et Windows (XP, 2000)
Les fichiers crees (Schematique, circuits imprimes, librairies) sous ces 2 systemes sont
totalement compatibles.

Installation a partir des archives
kicad.zip
ou
kicad.tgz

Le decompactage cree le repertoire kicad (et ses sous repertoires) a partir
du repertoire courant.

**Sous Windows:
se placer dans C:\ (ou D:\ ou tout disque et repertoire de son choix)
On supposera ici que l'on s'est plac dans c:\
Decompacter kicad.zip
dans kicad/library, dezzipper doc_components.zip
Crer un raccourci vers c:\kicad\winexe\kicad.exe
On pourra alors lancer le gestionnaire de projets kicad.exe

Sous Linux
On se placera de prfrence en /usr/local
Il faudra sans doute aussi etre "root"
Decompacter kicad.tgz
  - kicad.tgz: faire tar zxvf <chemin de kicad.tgz>/kicad.tgz
  - dans kicad/library, untar doc_components.tgz (ou unzip doc_components.zip)
On lancera kicad par /usr/local/kicad/linux/kicad
Sous KDE on pourra copier /usr/local/kicad/linux/kicad.desktop sur le bureau
de KDE comme raccourci.

Installation du modeleur 3D wings3D pour crer les formes 3D des modules du PCB:
Il est fourni dans ..kicad/wings3d pour Windows et Linux.
Se reporter au site du crateur pour tous dtails (www.wings3d.com)
Se reporter aussi a la doc de pcbnew pour la gnration des fichiers 3d

Documentation:
L'impression de la documentation (environ 200 pages) peut se faire
sous OpenOffice (www.openoffice.org) (magnifique logiciel libre de traitement de texte).

Principaux repertoires de Kicad:
kicad/winexe: executables sous windows (teste sous XP et 2000)
kicad/linux: executables sous linux (testes sous Mandrake 9.2 et 10.0)
kicad/library: fichiers libraires de composants schematiques
kicad/library/doc: fichiers documentation des composants schematiques (.pdf)
	(accessibles directement de la schematique si l'on a install acrobat ou Xpdf)
kicad/modules: fichiers de composants (modules) pour le circuit imprim
kicad/modules/packages3d: fichiers de formes 3D des modules

kicad/demos: C'est toujours utile...
kicad/internat: dictionnaires des langues (actuellement anglais->francais) pour les menus
kicad/help: fichiers d'aides en ligne
kicad/help/doc_src: fichiers d'aides (doc source, 200 pages) sous OpenOffice,
	a lire avant de se plaindre.


Complements:
-En cas de difficult:
Un problme peut surgir pour kicad lors de la recherche des fichiers utiles
comme fichiers de config, librairies, dictionnaire anglais->franais, docs...
Sous Windows:
	La recherche se fait l ou sont lus les executables.
	Il ne faut donc pas recopier les executables ailleurs que l ou ils sont.
	Toutefois, si cela ne marche pas, kicad cherche le repertoire c:\kicad
Sous linux:
	La recherche se fait sur /usr/local/kicad (installation conseille),
	ou dans le chemin des executables si /usr/local/kicad n'est pas trouv.

Uniquement en cas d'installation non standard (et en cas de difficult),
definir la variable d'environnement KICAD = <chemin de kicad>
ex: KICAD=/usr/local/cao/kicad
