aboutsummaryrefslogtreecommitdiffstats
path: root/util/alevt/README
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--util/alevt/README72
-rw-r--r--util/alevt/README.OLD78
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)