-Run "webdvd URL DIR" where URL is the URL for the page that is to be
-the top menu of the DVD and DIR is the directory in which to create
-the DVD filesystem (which should be missing or empty). It will
-automatically follow links to other pages and to video files,
-rendering each page. You must be careful not to link to pages that
-you do not want to appear on the disc, such as normal web sites.
+Design your DVD menus as a series of HTML pages linking to each other
+and to MPEG-1/2 videos that are suitable for use on a DVD. You must
+be careful not to link to pages that you do not want to appear on the
+disc, such as normal web sites. Also note the limitations listed
+below.
+
+Linking to video
+
+You can link directly to local MPEG video files whose names end in
+".mpeg", ".mpeg2", ".mpg" or ".vob". If you wish to combine multiple
+files into a single video sequence ("title" in DVD terminology) or to
+add chapter marks to a video sequence, create and link to a VOB-list
+file (explained below) whose name ends in ".voblist".
+
+VOB-lists
+
+A VOB-list file is an XML file with the document element <vob-list>
+and containing <vob> elements as described in the dvdauthor manual
+page. The file names in a VOB-list file are resolved relative to the
+directory containing the list file. For example:
+
+ <vob-list>
+ <vob file="main.vob" chapters="0:00,4:55,12:13,17:45"/>
+ <vob file="credits.vob"/>
+ </vob-list>
+
+This will result in a title with the following chapters:
+
+ 1: main.vob 0:00- 4:55
+ 2: main.vob 4:55-12:13
+ 3: main.vob 12:13-17:45
+ 4: main.vob 17:45- end
+ 5: credits.vob
+
+You can link to the start of a chapter by adding "#" and the chapter
+number after the VOB-list's file name. For example:
+
+ <a href="movie.voblist#1">Chapter 1</a><br>
+ <a href="movie.voblist#2">Chapter 2</a><br>
+ <a href="movie.voblist#3">Chapter 3</a><br>
+ <a href="movie.voblist#4">Chapter 4</a>