README

Gtkdialog - A small utility for fast and easy GUI building

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

Downloading the Source Code
===========================

Get it from here:
    https://github.com/puppylinux-woof-CE/gtkdialog/releases

Get the latest revision from git (always stable):
    https://github.com/puppylinux-woof-CE/gtkdialog.git

Get an older revision from git:
    # clone the repo
    git clone https://github.com/puppylinux-woof-CE/gtkdialog.git
    
    # checkout. Use any 7 digit hash in the log
    git checkout 78f7ab3 # this is from 2022-01-24

Compilation and Installation
============================

Using Meson
-----------

    meson [configure-options] build
    ninja -C build
    ninja -C build install

From a Source Package Using Autotools
-------------------------------------

    ./configure [configure-options]
    make
    make install

From git Using Autotools
------------------------

    ./autogen.sh [configure-options]
    make
    make install

The doc/reference/* and examples/* don't install by default so you might
like to copy them somewhere.

Support for using Glade generated user interfaces is very old and I'd
rather not encourage folk to create Gtkdialog applications in this way.

VTE
---
Gtkdialog's configure script will compile-in support for the Virtual
Terminal Emulator if it finds libvte and its development headers.
libvte source package -> http://ftp.gnome.org/pub/GNOME/sources/vte/

ARM
---
A problem was encountered when compiling on the ARM platform whereby the
widgets were being packed in the wrong order and I have applied a fix for
this wrapped in an #ifdef __arm__ preprocessor macro in automaton.c.

Contacting Us
=============

https://github.com/puppylinux-woof-CE/gtkdialog

2022-03-20