CLLOG Files

German descriptions follows above
Deutsche Beschreibung im Anschluss
==================================

Contents:
=========


1.   External open source software
1.1. Unzip tool
1.2. MinGW
1.3. GNU make tool
1.4. Harbour
1.5. libpcre 3
2.   Compile HWGUI and CLLOG
3.   Troubleshooting
4.   Optional Recommended Tools for developers
4.1  Notepad++
4.2  WinMerge


German text following at end of english text.

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 and 11 / 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. External open source software
--------------------------------

1.1. Unzip tool
===============

You need a suitable unzip tool, we
suggest "7zip" to install.
Get it from
https://www.7-zip.org/


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



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


 
1.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. 
(Tested with code snapshot from 25.11.2022 > DD.MM.YYYY)
Newest source code ist available from:
https://github.com/harbour/core
Press green button "<> Code",
then "Download ZIP"
The archive has the fix name  
core-master.zip

Deprecated:
https://harbour.github.io/
(do not use the download archive at this adress at this time,
 or check the date. Goto yellow box, press
 after text "Source Snapsot" ==> .zip ) 


1.5. libpcre 3
==============

License: THE "BSD" LICENCE

This package is needed for substitute the 
not available install package on Raspberry Pi 4 and 5 (64bit)

See instructions for Raspberry Pi to install
libpcre from this source package in file
RaspberryPi_EN.txt
or in:
RaspberryPi_DE.txt





1.6. GTK2
=========

File: gtk+-2.24.33.tar.xz

License:
 Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
 GNU Library General Public
 License as published by the Free Software Foundation; either
 version 2 of the License, or (at your option) any later version.

This archive contains the source code of GTK2,
which is needed for Knoppix 9.1
by Dipl.-Ing. Klaus Knopper.
(V9.1 2021-01-25DE).

The libraries for GTK2 are available on the system,
but not the belonging -dev package.

So the GTK2 of the system must be substituted by
this source installation, needed to create HWGUI and
related HWGUI applications like CLLOG.
 
For detailed instructions see file
 Install_Knoppix_EN.txt
or in german language:
 Install_Knoppix_DE.txt

placed in the root directory of the CLLOG archive. 


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



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



4. Optional Recommended Tools for developers
============================================
Preferred tools for Windows.

4.1 Notepad++
-------------

https://notepad-plus-plus.org/


4.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 und 11 / 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.

Inhalt:

1.   Externe Open Source Software
1.1. Unzip Tool
1.2. MinGW
1.3. GNU make Tool
1.4. Harbour
1.5. libpcre 3
1.6. GTK2
2.   HWGUI und CLLOG übersetzen
3.   Fehlerermittlung
4.   Empfehlung optionaler Programme für Entwickler
4.1  Notepad++
4.2  WinMerge



1.   Externe Open Source Software
=================================

1.2 Unzip Tool
==============

Es wird ein brauchbares Unzip-Tool benötigt,
wir schlagen zur Installation "7zip" vor.
Zu bekommen von:
https://www.7-zip.org/


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




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


1.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.
(Getestet mit Code Snapshot vom 25.11.2022 > TT.MM.JJJJ) 
Neueste Version des Quellcodes erhalten Sie unter:
https://github.com/harbour/core

Dann grüner Knopf "<> Code",
dann "Download ZIP"
Das Archiv hat den festen Namen:
core-master.zip

Veraltet:
https://harbour.github.io/ 
(bitte zur Zeit nicht verwenden)


1.5. libpcre 3
==============

Lizenz: THE "BSD" LICENCE

Dieses Paket wird benötigt,
um das nicht verfügbare Installationspaket
für Raspberry Pi 4 und 5 (64 Bit) zu ersetzen.

Anleitung zur Installation von libpcre
aus diesem Quellpaket für Raspberry Pi
finden Sie hier:
RaspberryPi_DE.txt
oder in:
RaspberryPi_EN.txt


1.6. GTK2
=========

Datei: gtk+-2.24.33.tar.xz

Lizenz:
 Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
 GNU Library General Public
 License as published by the Free Software Foundation; either
 version 2 of the License, or (at your option) any later version.

Dieses Archiv enthält den Quellcode von GTK2,
dieses wird für 
Knoppix 9.1 von Dipl.-Ing. Klaus Knopper benötigt.
(V9.1 2021-01-25DE)
 
Dieses Archiv enthält den Quellcode von GTK2,
welches für Knoppix benötigt wird.
Die Libraries für GTK2 sind auf dem System
vefügbar, jedoch fehlen die dazugehörigen
-dev Pakete.
 
So muss die GTK2-Installation auf dem System durch
diese Quellcode-Installation ersetzt werden,
um HWGUI zu erstellen und davon abhängige
Programme wie CLLOG bauen zu können.  

 
Für detailierte Aneweisung 
schaue in Datei
 Install_Knoppix_DE.txt
oder in englischer Sprache:
 Install_Knoppix_EN.txt
 
Diese Dateien befinden sich im Hauptverzeichnis
des CLLOG-Archivs.


2. 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".



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


4. Empfehlung optionaler Programme für Entwickler
=================================================

Bevorzugte Tools für Windows.

4.1 Notepad++
=============

https://notepad-plus-plus.org/


4.2 WinMerge
============

https://winmerge.org/?lang=de
    

====================== EOF of Readme.txt ======================