From: lam836@cs.cuhk.hk
Newsgroups: comp.os.linux.announce
Subject: dialog version 0.1
Date: 20 Dec 1993 01:57:17 +0200
Approved: linux-announce@tc.cornell.edu (Lars Wirzenius)
Message-ID: <2f2pot$dnl@klaava.Helsinki.FI>

I've uploaded to sunsite.unc.edu the files:

    /pub/Linux/Incoming/dialog-0.1.lsm
and /pub/Linux/Incoming/dialog-0.1.tar.gz

Here is the README:

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

dialog - Display dialog boxes in shell script (version 0.1)
===========================================================

This is a program that will enable you to present a variety of questions
or display messages using dialog boxes in a shell script. There are four
types of dialog boxes: yes/no box, menu box, input box, message box. The
reason for writing this program came from the fact that most questions
asked in a shell script (and many interactive programs as well) can be
classified into these few types:

1) One that requires the user to answer either yes or no.
2) One that presents a number of options for the user to choose.
3) One that requires the user to input a string.
4) One that displays a message and wait for a key press before continuing.

The program 'dialog' can, say for example, be called in a shell script to
present the first type of questions like this:

if dialog --yesno <question text> <height> <width>
then
  ...
fi

e.g. if dialog --yesno "Do you want to continue?" 7 51
     then
       echo "Continuing..."
     else
       echo "Aborting..."
     fi

I've included a sample shell script for each type of boxes in the directory
samples. The program requires ncurses to compile. Running 'dialog' without
arguments will display the usage.


FEATURES
	- Friendly dialog box interface with buttons, etc.
        - Auto wrap around of question text if it's too long to fit on
          one line.
        - "\n" can be inserted in question text to control line breaking
          explicitly.


INSTALLATION
	1. Edit Makefile and remove -DUSE_SHADOW from CFLAGS if you
           don't want shadowed dialog boxes.
	2. 'make install' will compile and install the binaries in
           /usr/local/bin (change BINDIR in Makefile if you want to
	   install elsewhere)


Comments and bug reports welcome.

- Savio Lam (lam836@cs.cuhk.hk)

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

Regards,
Savio Lam.
Email: lam836@cs.cuhk.hk

--
Mail submissions for comp.os.linux.announce to: linux-announce@tc.cornell.edu
PLEASE remember Keywords: and a short description of the software.
