Imported Upstream version 1.1.1+rev1355upstream/1.1.1+rev1355

2 files changed, 150 insertions, 0 deletions

diff --git a/util/alevt/README b/util/alevt/README
new file mode 100644
index 0000000..83985f0
--- /dev/null
+++ b/util/alevt/README
@@ -0,0 +1,72 @@
+Hi,
+
+this software is not just a program, it's moreover a legend.
+It is THE protagonist of all videotext applications under Linux.
+
+During the past 10 years the video standards, the APIs, the kernel
+have seen lots of changes.
+But unfortunately this program has NOT seen much maintenance.
+The results of that misfit appearance are:
+
+1. lots of forks flying around in the Internet
+2. lots of patches flying around, some good, some disgusting, some out of time
+3. lots of cruft which is completely outdated or obsolete for other reasons
+
+To handle all that in one big effort I decided to redesign the program
+completely, enlarging its capabilities for DVB-S at the same time.
+
+So here are the changes:
+
+1. Erasure of old help pages and rename / reorganize / update the rest
+-> redesign of the online help system / implying alevt-date and alevt-cap
+
+2. Erasure of old outdated integers, functions, parameters:
+
+- bell, big_buf, debug, display, editor, erc, fine_tune, newbttv,
+- oldbttv
+
+3. Coding style cleanups (no superfluous comments, not more than
+   80 characters per column, no uncommented code.
+
+4. No strange characters in the outfile, latin alphabet in purity instead.
+
+5. Alevt can be started in 4 modes now if you are running it in DVB mode:
+
+- by service id (sid)
+- by teletext pid (ttpid)
+- by channel name
+- without parameter
+
+6. Starting it in DVB mode on the command line it presents you
+a table with human readable values such as sid, teletext pid,
+PMT (Program Map Table), provider name, service name, language, service type.
+This makes it easier for you to start multiple teletext windows
+in multiple console sessions manually.
+
+If working with a script and the option -o (outfile) you can
+also start multiple teletext windows of all channels in a transponder.
+I develop a GUI using TCL / TK 8.5 and Iwidgets 4.01 to do that and other
+tasks graphically (i. e. by mouse click).
+
+7. If you install the program on the command line by typing "make &
+   make install" there is an uninstaller now to revert the installation:
+   "make uninstall".
+
+ENJOY IT!
+
+Uwe Bugla, February 11th, 2010.
+
+External dependencies
+
+AleVT needs some system libraries to be installed in your system.
+They are zlib, libX11, libpng and libzvbi.
+
+Credits go to:
+- Andreas Rottmann from debian.org for compiler fixes and
+  other kinds of investigation.
+- Francesco Lavra for supplying a kernel patch to avoid kernel demux
+  incompatibilities with kernels >= 2.6.32
+- Andy Walls for helpful investigation in kernelspace
+- Edgar Toernig for providing the source version 1.6.2 and doing all the
+  development for the basic versions
+- Tom Zoerner for the implementation of libzvbi
diff --git a/util/alevt/README.OLD b/util/alevt/README.OLD
new file mode 100644
index 0000000..4fb0e41
--- /dev/null
+++ b/util/alevt/README.OLD
@@ -0,0 +1,78 @@
+Hi,						Menden, 21 Sep 2000
+
+    This program decodes and displays Videotext/Teletext from a
+    /dev/vbi device.
+
+
+COMPILE & INSTALL:
+
+    There's nothing to configure.  A simple 'make' is all.
+    If you do not want png support remove the WITH_PNG in
+    the Makefile.  Additionally, if you want a smaller font
+    uncomment the "FONT=neep9" line.
+
+    It gives you 'alevt', 'alevt-date', and 'alevt-cap' and
+    their man pages 'alevt.1x', 'alevt-date.1', and 'alevt-cap.1'.
+
+    You can install them where ever you want (i.e. /usr/local/bin).
+    The programs are self-contained and require no other files.
+
+    NOTE: Be careful with 'make install'.  It's just for me :-)
+
+
+PROBLEMS:
+
+    If you have a lot of decoding errors (lot of these lightning symbols)
+    you may try pressing the 'f' and 'F' key.  This allows fine tuning of
+    the decoder circuit.  There's also a -finetune command line option.
+    This should only be necessary on really bad signals.
+
+    Maybe, I add autotuning later...
+
+    UPDATE: added autotuning.  It's the default.  If you add -debug the
+    the actions of the pll are printed to stdout.
+
+    To get the old (pre finetune) behaviour start it with -finetune 0.
+
+    UPDATE: disabled autotuning *g*  sometimes it's too jumpy...
+
+
+ALEVT-DATE:
+    I added a little tool to set the system time from the videotext
+    time.  The date is not interpreted (not even transmitted on some
+    channels).  So it allows only adjustment of +/-12 hours.
+    The default allowed adjustment is limited to +/-2 hours (use
+    -delta to change).  Without the -set option it just display
+    the date in the format of the date command.  Look at strftime(3)
+    for possible control sequences you may use in the -format option.
+
+
+HACKING:
+
+    If you want to play with the font size, you may resize it with
+    xv (xv font1.xbm).  Just make sure, that its width is a multiple of
+    32 and its height a multiple of 8.  A simple make will create
+    a version of AleTV with the new font.  Warning: a make clean
+    will erase font1.xbm.  The next make will recreate font.xbm from
+    vtxt.bdf.
+
+    AleVT has a built in page editor.  If you start it with -editor
+    you may press 'E' to invoke it.  For the usage you have to consult
+    the sources.  (It's very crude!)
+
+
+TODO: (no specific order)
+
+    - Error correction in alevt-cap
+    - Better language support.  Internal 16-bit charset.
+    - Separated graphics.
+    - Rewrite the whole stuff.  A networked teletext daemon and clients
+      that connect to it for display, capture, cgi, ...
+
+
+NEWER VERSIONS:
+
+    The primary site of AleVT is http://goron.de/~froese
+
+Have fun,
+Edgar Toernig (froese@gmx.de)