Version 0.6vdr-0.6

- Added support for LIRC remote control (thanks to Carsten Koch!).
  There are now three different remote control modes: KBD (PC-Keyboard), RCU
  and LIRC. See the INSTALL file for information on how to enable either of
  these modes. The default mode is now KBD, not RCU as before (to make it
  work immediately even if there is no actual remote control).
- Fixed small bug in dvbapi.c that was causing some channels (many on hotbird)
  not to be correctly tuned (thanks to Plamen Ganev!).
- Now clearing the replay buffer in search forward/back, which results in
  faster reaction.
- The 'Recordings' menu is now listed alphabetically (thanks to Carsten Koch!).
- The new 'epg2timers' tool (thanks to Carsten Koch!) can be used to convert
  an EPG "merkliste" page (http://www.tvtv.de) to vdr timer entries.
- The new 'xtvrc2vdr' tool (thanks to Plamen Ganev!) can be used to convert
  'xtvrc' channel files into 'vdr' format.
- When more than one timer matches at the same time, the first one in the list
  with the highest 'Priority' is selected.
- The MANUAL section on "Programming the Timer" has been filled in.
- The year in the "Recordings" menu as well as in the progress display during
  replay has been reduced to 2 digits to allow more space for the recording's
  title. In the internal file structure the year is still stored with 4 digits,
  so there will be no problem at the next turn of the century ;-)
- Channel names and timer filenames can now contain blanks. To avoid problems
  with file names that contain blanks, all blanks in recording file names are
  converted to underscores.
- The polarization can now be given in uppercase or lowercase characters in
  channels.conf.
- Fixed buffer initialization to work with DVB driver version 0.6.
- Implemented the "Simple Video Disk Recorder Protocol" (SVDRP) to control
  the VDR over a network connection.
- Implemented command line option handling.
- The program can now run in full background mode by using the --daemon option.
- Added a "summary" field to the timers (thanks to Carsten Koch!).
  This field can contain a descriptive text of the programme and will be
  displayed when the "Blue" key is pressed on a recording that was created by
  this timer. If the text contains the special character '|', a newline will
  be inserted at that place.  When pressing "Ok" on a timer that contains a
  summary field, the summary will be displayed. To edit such a timer the "Red"
  key must be pressed. Timers without a summary still go into Edit mode when
  pressing "Ok".  The summary field can only be filled in directly by editing
  the 'timers.conf' file with a text editor, or by defining/modifying the timer
  via the SVDRP interface.

1 files changed, 45 insertions, 2 deletions

diff --git a/MANUAL b/MANUAL
index cea3946..c9b71a3 100644
--- a/MANUAL
+++ b/MANUAL
@@ -41,7 +41,11 @@ Video Disk Recorder User's Manual
   by pressing the "Right" button (which puts brackets around the current
   character as in "[R]TL"), selecting the desired character position with
   "Left" and "Right", and changing the character with the "Up" and "Down"
-  keys. "Ok" then confirms the changes.
+  keys. "Ok" then confirms the changes. The special character '^' can be used
+  to "cut off" a string at this position. When this character is visible in the
+  brackets (as in abc[^]), the next press to the "Left" or "Ok" button will
+  actually cut off the string. Using "Up" and/or "Down" brings back the
+  original rest of the string (unless you have pressed "Left" or "Ok").
   
   The "Red", "Green", "Yellow" and "Blue" buttons have special meanings
   in various menus and are listed at the bottom of the on-screen-display.
@@ -108,4 +112,43 @@ Video Disk Recorder User's Manual
 * Programming the Timer
 
   Use the "Timer" menu to maintain your list of timer controlled recordings.
-
+  The parameters in the "Edit Timer" menu have the following meanings:
+
+  Active:    Defines whether the timer will be processed (set it to 'no' to
+             temporarily desable a timer).
+  Channel:   The channel to be recorded (as defined in the "Channels" list).
+             Any changes made in the "Channels" list (like renaming or
+             reordering channels) will be automatically reflected in the
+             timers settings.
+  Day:       The day on which this timer shall start. This can be either a
+             "day of month" (1..31), which allows programming a "single shot"
+             timer that hits once and is deleted after it ends. Single shot
+             timers can be programmed up to one month into the future.
+             Another option here are "repeating timers" which are defined
+             by listing the days of the week on which they shall record.
+             For example, a timer that shall record every monday and wednesday
+             would have a Day setting of "M-W----".
+  Start:     The start time of the timer in hh:mm as 24 hour ("military") time.
+  Stop:      The stop time of the timer.
+  Priority:  The Priority (0..99) is used to decide which timer shall be
+             started in case there are two or more timers with the exact same
+             start time. The first timer in the list with the highest Priority
+             will be used. This value is also stored with the recording and is
+             later used to decide which recording to remove from disk in order
+             to free space for a new recording. If the disk is full and a new
+             recording needs more space, an existing recording with the lowest
+             Priority (and which has exceeded its guaranteed Lifetime) will be
+             removed.
+  Lifetime:  The number of days (0..99) a recording made through this timer is
+             guaranteed to remain on disk before it is automatically removed
+             to free up space for a new recording. Note that setting this
+             parameter to very high values for all recordings may soon fill up
+             the entire disk and cause new recordings to fail due to low disk
+             space.
+  File:      The name under which a recording created through this timer will
+             be stored on disk (the actual name will also contain the date and
+             time, so it is possible to have a "repeating timer" store all its
+             recordings under the same name; they will be distinguishable by
+             their date and time).
+             If this field is left blank, the channel name will be used to form
+             the name of the recording.