/*****************************/
/*** Installation notes ******/
/*****************************/

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...)

