German descriptions follows above
Deutsche Beschreibung im Anschluss
==================================
Directory "contrib":
This directory contains "ready to use" packages for quick install the
environment for compiling Harbour, HWGUI and CLLOG from source code distributions
on Windows 32 systems (also on Windows 64).
Tested with Windows 10 / 64 bit.
If you use the described default installation locations,
it is no need to modify the delivered environment script (pfad.bat).
Also no modifications at the Windows system are necessary.
The delivered installations are like a "portable" variant.
1. Unzip tool
=============
You need a suitable unzip tool, we
suggest "7zip" to install.
Get it from
https://www.7-zip.org/
2. MinGW
========
Read installation instructions of CLLOG,
to set the suitable environment
compiling Harbour, HWGUI and CLLOG
with the MinGW compiler on Windows.
We recommend the usage of the 32 bit release.
File: MinGW32.zip
-----------------
Unzip archive, so that the basic installation directory is
C:\MinGW32
Under this directory, you must find the following directories:
bin
doc
include
lib
libexec
mingw32
share
This file contains no source code.
Newest source code ist available from:
https://github.com/mirror/mingw-w64
and many other locations.
File: MinGW64.zip
-----------------
This file contains no source code.
Unzip archive, so that the basic installation directory is
C:\MinGW64
Directory structure simular to 32 bit release.
So the 64 bit version can be installed in parallel with the
32 bit release.
For most big applications, it not necessary, to use the 64bit version.
There is no speed advantage.
But for bugfixing or development purposes, the 64 bit release
could be helpful.
3. GNU make tool:
=================
File: make.zip
Unzip archive, so that the basic installation directory is
C:\make
Under this directory, you must find the following directories:
bin
contrib
man
manifest
share
This file contains no source code.
Newest source code is available from:
ftp.gnu.org/gnu/make
4. Harbour
==========
File: harbour.zip
Unzip archive, so that the basic installation directory is
C:\harbour\core-master
Under this directory, you must find the following directories:
addons
bin
config
contrib
debian
doc
extras
include
lib
package
src
tests
utils
This file contains the source code.
(Code snapshot from 25.11.2022 > DD.MM.YYYY)
Newest source code ist available from:
https://harbour.github.io/
5. Compile HWGUI and CLLOG
==========================
HWGUI:
Get newest code snapshot from:
https://sourceforge.net/projects/hwgui/
File: hwgui-code-rnnnn-trunk-hwgui.zip
(nnnn: the subversion revision number)
Unzip archive, so that the basic installation directory is
C:\hwgui\hwgui
Under this directory, you must find the following directories:
contrib
doc
image
include
lib
samples
source
test
utils
Before compiling HWGUI it now necessary to install the CLLOG code.
Get newest code snapshot from:
https://sourceforge.net/projects/cllog/
File: cllog-code-rnnnn-trunk.zip
(nnnn: the subversion revision number)
Unzip archive, so that the basic installation directory is
C:\CLLOG
Under this directory, you must find the following directories:
bat
bin
bin87
...
src
test
testdaten
update
For compile HWGUI:
- Run environment script:
C:\CLLOG\src\pfad.bat
- Read file "install.txt" of HWGUI for instructions.
2 alternative scripts:
- hbmk2 hwgui.hbp procmisc.hbp hbxml.hbp hwgdebug.hbp
- makemngw.bat
Compile and run CLLOG:
Read the file "Quick_Instructions.txt" and follow the instructions.
6. Troubleshooting
==================
Check for reachability of needed tools:
C:\hwgui\hwgui>make -v
GNU Make 3.81
Copyright (C) 2006 Free Software Foundation, Inc.
...
gcc --version
gcc (GCC) 4.6.2
Copyright (C) 2011 Free Software Foundation, Inc.
...
hbmk2
Harbour Make (hbmk2) 3.2.0dev (r2020-02-10 14:34)
Copyright (c) 1999-present, Viktor Szakats
...
7. Optional Recommended Tools for developers
============================================
Preferred tools for Windows.
7.1 Notepad++
https://notepad-plus-plus.org/
7.2 WinMerge
https://winmerge.org/?lang=en
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~ Deutsch ~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Verzeichnis "contrib":
Dieses Verzeichnis enthält fertig zu installierende Pakete,
um eine Übersetzungumgebung für die Erzeugung von HWGUI und CLLOG
aus dem Quellcode auf Windows 32 Systemen (auch Windows 64)
schnell einzurichten.
Getested auf Windows 10 / 64 bit.
Wenn Sie die hier aufgeführten Installationsorte verwenden,
kann das mitgelieferte Environment Skript (pfad.bat)
unverändert benutzt werden.
Auch Änderungen am Windows System entfallen hiermit.
Die vorgestellten Installationen sind mit einer "portablen" Variante
vergleichbar.
1. Unzip Tool
=============
Es wird ein brauchbares Unzip-Tool benötigt,
wir schlagen zur Installation "7zip" vor.
Zu bekommen von:
https://www.7-zip.org/
2. MinGW
========
Datei: MinGW32.zip
Packen Sie das Archiv so aus, dass das Basis-Installationverzeichnis wie folgt eingerichtet ist:
C:\MinGW32
Unter diesem Verzeichnis sollten Sie die folgenden Unterverzeichnisse vorfinden:
bin
doc
include
lib
libexec
mingw32
share
Dieses Archiv enthält keinen Quellcode.
Neueste Version des Quellcodes erhalten Sie unter:
https://github.com/mirror/mingw-w64
und vielen weiteren Adressen.
Datei MinGW64.zip
-----------------
Dieses Archiv enthält ebenfalls keinen Quellcode.
Packen Sie das Archiv so aus, dass das Basis-Installationverzeichnis wie folgt eingerichtet ist:
C:\MinGW64
Verzeichnis-Struktur analog zur to 32 bit Ausgabe.
Auf diese Weise kann die 64 bit Version parallel zur
32 bit Ausgabe installiert werden.
Für große Programme besteht vorerst keine Notwendigkeit,
64bit Version zu verwenden.
Es gibt kaum einen Geschwindigkeitsvorteil.
Für Programmierung und Fehlerbehebung könnte
die 64 bit Version von Vorteil sein.
3. GNU make Tool:
=================
Datei: make.zip
Packen Sie das Archiv so aus, dass das Basis-Installationverzeichnis wie folgt eingerichtet ist:
C:\make
Unter diesem Verzeichnis sollten Sie die folgenden Unterverzeichnisse vorfinden:
bin
contrib
man
manifest
share
Dieses Archiv enthält keinen Quellcode.
Neueste Version des Quellcodes erhalten Sie unter:
ftp.gnu.org/gnu/make
4. Harbour
==========
Datei: harbour.zip
Packen Sie das Archiv so aus, dass das Basis-Installationverzeichnis wie folgt eingerichtet ist:
C:\harbour\core-master
Unter diesem Verzeichnis sollten Sie die folgenden Unterverzeichnisse vorfinden:
addons
bin
config
contrib
debian
doc
extras
include
lib
package
src
tests
utils
Dieses Archiv enthält Quellcode.
(Code Snapshot vom 25.11.2022 > TT.MM.JJJJ)
Neueste Version des Quellcodes erhalten Sie unter:
https://harbour.github.io/
5. HWGUI und CLLOG übersetzen
=============================
HWGUI:
Neueste Version des Quellcodes holen Sie unter:
https://sourceforge.net/projects/hwgui/
Datei: hwgui-code-rnnnn-trunk-hwgui.zip
(nnnn: die Subversion Revisions-Nummer)
Packen Sie das Archiv so aus, dass das Basis-Installationverzeichnis wie folgt eingerichtet ist:
C:\hwgui\hwgui
Unter diesem Verzeichnis sollten Sie die folgenden Unterverzeichnisse vorfinden:
contrib
doc
image
include
lib
samples
source
test
utils
Vor der Übersetzung von HWGUI ist es unbedingt erforderlich, den CLLOG-Quellcode
zu installieren:
Neueste Version des Quellcodes holen Sie unter:
https://sourceforge.net/projects/cllog/
Datei: cllog-code-rnnnn-trunk.zip
(nnnn: die Subversion Revisions-Nummer)
Packen Sie das Archiv so aus, dass das Basis-Installationverzeichnis wie folgt eingerichtet ist:
C:\CLLOG
Unter diesem Verzeichnis sollten Sie die folgenden Unterverzeichnisse vorfinden:
bat
bin
bin87
...
src
test
testdaten
update
Schritte für Übersetzung von HWGUI:
- Starten Sie das Environment Skript in der Windows-Eingabeaufforderung:
C:\CLLOG\src\pfad.bat
- Lesen Sie in der Datei "install.txt" zu finden im HWGUI-Basisverzeichnis die
Installationsanweisungen (Englisch).
2 alternative Skripts laasen sich verwenden:
- hbmk2 hwgui.hbp procmisc.hbp hbxml.hbp hwgdebug.hbp
- makemngw.bat
Übersetzung und Start von CLLOG:
Folgen Sie dazu den Anweisungen in der Datei "Schnellanleitung.txt".
6. Fehlerermittlung
===================
Bei Fehlern überprüfen Sie die Erreichbarkeit der notwendigen Programme:
C:\hwgui\hwgui>make -v
GNU Make 3.81
Copyright (C) 2006 Free Software Foundation, Inc.
...
gcc --version
gcc (GCC) 4.6.2
Copyright (C) 2011 Free Software Foundation, Inc.
...
hbmk2
Harbour Make (hbmk2) 3.2.0dev (r2020-02-10 14:34)
Copyright (c) 1999-present, Viktor Szakats
...
7. Empfehlung optionaler Programme für Entwickler
=================================================
Bevorzugte Tools für Windows.
7.1 Notepad++
https://notepad-plus-plus.org/
7.2 WinMerge
https://winmerge.org/?lang=de
====================== EOF of Readme.txt ======================