From fe9499ba901f5c32dd0b3841a2b6e599fefc144f Mon Sep 17 00:00:00 2001
From: Klaus Schmidinger <kls (at) cadsoft (dot) de>
Date: Sun, 24 Nov 2002 18:00:00 +0100
Subject: =?UTF-8?q?Version=201.1.17=20-=20Added=20new=20entries=20to=20'ca?=
 =?UTF-8?q?.conf'.=20-=20Fixed=20closing=20unused=20PID=20handles=20(thank?=
 =?UTF-8?q?s=20to=20Stefan=20Schluenss=20for=20reporting=20this=20=20=20on?=
 =?UTF-8?q?e).=20-=20Added=20more=20examples=20to=20'diseqc.conf'=20(thank?=
 =?UTF-8?q?s=20to=20Oliver=20Endriss).=20-=20Fixed=20disabling=20multiple?=
 =?UTF-8?q?=20recordings=20on=20a=20single=20DVB=20card=20(comment=20out?=
 =?UTF-8?q?=20the=20definition=20=20=20of=20the=20macros=20DO=5FREC=5FAND?=
 =?UTF-8?q?=5FPLAY=5FON=5FPRIMARY=5FDEVICE=20and=20DO=5FMULTIPLE=5FRECORDI?=
 =?UTF-8?q?NGS=20in=20=20=20dvbdevice.c).=20-=20Plugins=20can=20now=20have?=
 =?UTF-8?q?=20their=20very=20own=20OSD=20setup=20in=20the=20object=20they?=
 =?UTF-8?q?=20return=20from=20=20=20a=20call=20to=20cPlugin::MainMenuActio?=
 =?UTF-8?q?n().=20In=20order=20to=20implement=20this,=20the=20return=20typ?=
 =?UTF-8?q?e=20=20=20of=20cPlugin::MainMenuAction()=20had=20to=20be=20chan?=
 =?UTF-8?q?ged=20from=20(cOsdMenu=20*)=20to=20(cOsdObject=20*).=20=20=20So?=
 =?UTF-8?q?=20in=20case=20you=20are=20compiling=20an=20existing=20plugin?=
 =?UTF-8?q?=20with=20this=20version=20of=20VDR=20and=20you=20=20=20get=20a?=
 =?UTF-8?q?n=20error=20message,=20simply=20change=20cOsdMenu=20to=20cOsdOb?=
 =?UTF-8?q?ject=20in=20the=20plugin's=20source=20=20=20for=20the=20MainMen?=
 =?UTF-8?q?uAction()=20function.=20=20=20Plugin=20authors=20who=20have=20s?=
 =?UTF-8?q?o=20far=20(ab)used=20the=20cControl=20mechanism=20to=20implemen?=
 =?UTF-8?q?t=20their=20=20=20own=20raw=20OSD=20should=20take=20a=20look=20?=
 =?UTF-8?q?at=20the=20new=20demo=20plugin=20'osddemo'.=20It=20implements?=
 =?UTF-8?q?=20=20=20a=20very=20primitive=20game=20that=20shows=20how=20a?=
 =?UTF-8?q?=20plugin=20can=20have=20its=20own=20raw=20OSD.=20Especially=20?=
 =?UTF-8?q?=20=20look=20into=20cLineGame=20and=20see=20how=20it=20implemen?=
 =?UTF-8?q?ts=20the=20Show()=20function.=20See=20also=20=20=20the=20chapte?=
 =?UTF-8?q?r=20on=20"User=20interaction"=20in=20PLUGINS.html.=20-=20Added?=
 =?UTF-8?q?=20three=20new=20fields=20to=20the=20lines=20in=20'channels.con?=
 =?UTF-8?q?f':=20NID,=20TID=20and=20RID.=20NID=20and=20=20=20TID=20are=20t?=
 =?UTF-8?q?he=20Network=20and=20Transport=20Stream=20IDs,=20respectively.?=
 =?UTF-8?q?=20RID=20is=20an=20additional=20ID=20=20=20that=20can=20be=20us?=
 =?UTF-8?q?ed=20to=20tell=20apart=20channels=20that=20would=20otherwise=20?=
 =?UTF-8?q?be=20indistinguishable.=20=20=20This=20is=20typically=20the=20c?=
 =?UTF-8?q?ase=20with=20radio=20channels,=20which=20may=20have=20the=20sam?=
 =?UTF-8?q?e=20NID,=20TID=20=20=20and=20SID,=20but=20different=20"radio=20?=
 =?UTF-8?q?IDs".=20This=20new=20field=20is=20therefore=20called=20RID=20("?=
 =?UTF-8?q?radio=20=20=20ID").=20Currently=20NID=20and=20TID=20are=20not?=
 =?UTF-8?q?=20yet=20used=20by=20VDR=20and=20should=20always=20be=200.=20Th?=
 =?UTF-8?q?e=20=20=20RID=20is=20actually=20used=20when=20building=20the=20?=
 =?UTF-8?q?"unique=20channel=20ID",=20so=20if=20you=20have=20channels=20?=
 =?UTF-8?q?=20=20in=20your=20'channels.conf'=20file=20that=20cause=20error?=
 =?UTF-8?q?=20messages=20when=20loading,=20you=20can=20set=20=20=20the=20R?=
 =?UTF-8?q?IDs=20of=20these=20channels=20to=20different=20values.=20=20=20?=
 =?UTF-8?q?When=20reading=20an=20old=20'channels.conf'=20these=20new=20fie?=
 =?UTF-8?q?lds=20will=20be=20automatically=20=20=20initialized=20to=200=20?=
 =?UTF-8?q?and=20once=20the=20file=20is=20written=20back=20to=20disk=20the?=
 =?UTF-8?q?y=20will=20be=20appended=20=20=20to=20the=20channel=20definitio?=
 =?UTF-8?q?ns.=20=20=20Thanks=20to=20R=C3=A9gis=20Bossut=20for=20pointing?=
 =?UTF-8?q?=20out=20that=20with=20some=20providers=20the=20channels=20can?=
 =?UTF-8?q?=20=20=20only=20be=20distinguished=20through=20the=20RID.=20-?=
 =?UTF-8?q?=20The=20"unique=20channel=20ID"=20now=20contains=20an=20option?=
 =?UTF-8?q?al=205th=20part=20(the=20RID).=20See=20man=20vdr(5).=20-=20Upda?=
 =?UTF-8?q?ted=20'channels.conf.cable'=20and=20made=20some=20channels=20un?=
 =?UTF-8?q?ique=20using=20the=20new=20RID=20=20=20(thanks=20to=20Andreas?=
 =?UTF-8?q?=20Kool=20for=20pointing=20out=20the=20problems).=20-=20Made=20?=
 =?UTF-8?q?some=20channels=20unique=20in=20'channels.conf.terr'=20using=20?=
 =?UTF-8?q?the=20new=20RID.=20-=20Extended=20the=20'-l'=20option=20to=20al?=
 =?UTF-8?q?low=20logging=20to=20LOG=5FLOCALn=20(n=3D0..7)=20by=20writing,?=
 =?UTF-8?q?=20for=20=20=20instance,=20'-l=203.7'=20(suggested=20by=20J?=
 =?UTF-8?q?=C3=BCrgen=20Schmidt).=20-=20Now=20deleting=20stale=20lock=20fi?=
 =?UTF-8?q?les=20if=20they=20have=20a=20time=20stamp=20that=20is=20outside?=
 =?UTF-8?q?=20the=20window=20=20=20'now=20+/-=20LOCKFILESTALETIME'.=20This?=
 =?UTF-8?q?=20improves=20things=20in=20cases=20where=20the=20system=20time?=
 =?UTF-8?q?=20=20=20makes=20far=20jumps,=20so=20that=20a=20lock=20file=20m?=
 =?UTF-8?q?ight=20end=20up=20with=20a=20time=20stamp=20that=20lies=20=20?=
 =?UTF-8?q?=20in=20the=20distant=20future=20(thanks=20to=20Oliver=20Endris?=
 =?UTF-8?q?s).?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 vdr.5 | 25 ++++++++++++++++++-------
 1 file changed, 18 insertions(+), 7 deletions(-)

(limited to 'vdr.5')

diff --git a/vdr.5 b/vdr.5
index 9720a65..02b5b64 100644
--- a/vdr.5
+++ b/vdr.5
@@ -8,9 +8,9 @@
 .\" License as specified in the file COPYING that comes with the
 .\" vdr distribution.
 .\"
-.\" $Id: vdr.5 1.12 2002/11/10 10:10:15 kls Exp $
+.\" $Id: vdr.5 1.14 2002/11/24 16:36:48 kls Exp $
 .\"
-.TH vdr 5 "10 Nov 2002" "1.2.0" "Video Disk Recorder Files"
+.TH vdr 5 "24 Nov 2002" "1.2.0" "Video Disk Recorder Files"
 .SH NAME
 vdr file formats - the Video Disk Recorder Files
 .SH DESCRIPTION
@@ -38,7 +38,7 @@ The given number must be larger than the number of any previous channel
 A \fBchannel definition\fR is a line with channel data, where the fields
 are separated by ':' characters. Example:
 
-\fBRTL:12188:h:S19.2E:27500:163:104:105:0:12003\fR
+\fBRTL:12188:h:S19.2E:27500:163:104:105:0:12003:0:0:0\fR
 
 The line number of a channel definition (not counting group separators,
 and based on a possible previous '@...' parameter)
@@ -119,16 +119,27 @@ l l.
 .TE
 .TP
 .B SID
-The service ID of this channel.
+The Service ID of this channel.
+.TP
+.B NID
+The Network ID of this channel (for future use, currently always 0).
+.TP
+.B TID
+The Transport stream ID of this channel (for future use, currently always 0).
+.TP
+.B RID
+The Radio ID of this channel (typically 0, may be used to distinguish channels where
+NID, TID and SID are all equal).
 .PP
 A particular channel can be uniquely identified by its \fBchannel\ ID\fR,
 which is a string that looks like this:
 
-\fBS19.2E-0-12188-12003\fR
+\fBS19.2E-0-12188-12003-0\fR
 
 The components of this string are the \fBSource\fR (S19.2E), \fBFrequency\fR
-(12188, MHz) and \fBSID\fR (12003) as defined above. The part that is currently
-\fB0\fR is reserved for future use.
+(12188, MHz) and \fBSID\fR (12003) as defined above. The parts that are currently
+\fB0\fR are reserved for future use (the last part can be omitted if it is \fB0\fR,
+so the above example could also be written as \fBS19.2E-0-12188-12003\fR).
 .br
 The \fBchannel\ ID\fR is used in the \fItimers.conf\fR and \fIepg.data\fR
 files to properly identify the channels.
-- 
cgit v1.2.3