#----------------------------------------------------------------------------
# build_docbook_4.txt - how to build the docbook_4 binaries and create folder and packages
#
# Creation   : 2018-03-12 holbru
# Last update: $Id$
#
# !!! this is not a script but an step-by-step howto !!!
#----------------------------------------------------------------------------
exit 1

### download the source code from the internet, e.g.
# http://        docbook_4

# docbook_4-4.5.tar.bz2

### extract file in a temporary location
tar -xf docbook_4-4.5.tar.bz2

# hbfl
# 2018 03 -12 -> docbook_4-4.5
# build with rpm Suse
# docbook_4-4.5-141.1.src.rpm

# hbfl
# 2020 04 -12 -> docbook_4-4.5
# build with rpm Suse
# docbook_4-4.5-143.3.src.rpm

cd docbook_4-4.5

### build

export CFLAGS='-O2 -march=i486'
export CXXFLAGS="${CFLAGS}"


./configure  \
--prefix=/usr  \
--build=i486-pc-linux-gnu  \
--host=i486-pc-linux-gnu

make
make check
make DESTDIR=/public/docbook_4 install

# strip files/binarys
for filename in $(find /public/docbook_4/usr/{bin/*,lib/*.so.*} -type f)
do
    echo $filename
    strip -R .note -R .comment "$filename"
done

# copy files
cp *** <svn-root>/lib/docbook_4/bin_**_docbook_4:4_5/***


#----------------------------------------------------------------------------

create folder

Um die Folder im Hauptverszeichnis zu erstellen gibt es das Script 'docbook_4-folder.sh'
unter docbook_4/_ADMIN/

mit
docbook_4-folder.sh -v 4.5 -w create

    wird die folder Struktur fuer die lib Version 4.5 erstellt

    nun koennen die files aus dem compilat eingefuegt werden.

mit
docbook_4-folder.sh -v 4.5 -w add

    wird ein svn add auf die erzeugten Folder durchgefuehrt.

mit
docbook_4-folder.sh -v 4.5 -w list

    wird fuer jeden Folder die files-list.txt erzeugt, add muss zwingend
    vorher ausgefuehrt worden sein


In den eis und eis_dev Foldern muessen keine Anpassungen vorgenommen werden.
Diese Anpassungen erfolgen beim packen der packages durch mktarball.sh
mit den _do_ Scripten unter _ADMIN automatisch.

In den Pack-Scripten unter _ADMIN muss dann noch die Pfadangabe geaendert werden,
auf den soeben erzeugten Pfad und ein commit ausgefuehrt werden.


Nach dem checkout auf eisler koennen nun die packages erzeugt werden.

die wichtigsten Parameter fuer mktarball.sh sind dann

 -setdate now
 -setversion ${version}
mktarball.sh - home -setdate now -setversion [version angeben] docbook_4 docbook_4-dev

duch die Angabe von -home  werden die packages in die
Folder Struktur /home/user/public_html/packages/ kopiert und koennen von da
direkt auf Pack-Eis geladen werden.

wichtig ist noch, dass unbedingt die 'lib' Version zuerst gebaut werden muss, da fuer
die 'dev' Version Informationen aus der 'lib' Info Datei gelesen werden.