#----------------------------------------------------------------------------
# build_docboob2x.txt - how to build the docboob2x binaries and create folder and packages
#
# Creation   : 2019-05-19 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://        docboob2x

# docboob2x-0.8.8.tar.bz2

### extract file in a temporary location
tar -xf docboob2x-0.8.8.tar.bz2

# hbfl
# 2019-05-19 -> docbook2x-0.8.8
# build with rpm suse
# docbook2x-0.8.8-126.3.src.rpm

# hbfl
# 2021-09-27 -> docbook2x-0.8.8
# build with rpm suse -> gcc-10 -> glibc-2.33
# docbook2x-0.8.8-127.8.src.rpm

cd docboob2x-0.8.8

### 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/docboob2x install

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

# copy files
cp *** <svn-root>/lib/docboob2x/bin_**_docboob2x:0_8_8/***


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

create folder

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

mit
docboob2x-folder.sh -v 0.8.8 -w create

    wird die folder Struktur fuer die lib Version 0.8.8 erstellt

    nun koennen die files aus dem compilat eingefuegt werden.

mit
docboob2x-folder.sh -v 0.8.8 -w add

    wird ein svn add auf die erzeugten Folder durchgefuehrt.

mit
docboob2x-folder.sh -v 0.8.8 -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] docboob2x docboob2x-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.