-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.
-
-By default, webdvd generates PAL/SECAM video. If you wish to produce
-NTSC DVDs you can override this by adding the option "--video-std ntsc".
-
-If webdvd runs successfully you can use mkisofs to create a DVD image:
-
- mkisofs -dvd-video DIR > IMAGE
- rm -rf DIR
-
-Alternately you can write the filesystem directly to a writable DVD
-with growisofs or mkisofs plus a suitable version of cdrecord.
+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" 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>
+
+Video standards
+
+The encoding of analogue TV and video signals varies in many different
+ways between countries. Happily there are only two parameters that
+matter for standard-definition digital video, and two different pairs
+of values. You can choose between these with the --video-std option:
+
+Analogue parameters | Region of world | --video-std | Frame
+ | | argument | size
+----------------------+------------------------------+-------------+--------
+59.94 fields/second, | Americas except Argentina, | 525 | 720x576
+interlaced; | Paraguay, Uruguay; | or 525/60 |
+525 lines/frame | Japan; Laos; Myanmar; | or NTSC |
+(commonly called | Philippines; South Korea; | or ntsc |
+ NTSC) | Taiwan; some Pacific islands | |
+----------------------+------------------------------+-------------+--------
+50 fields/second, | Rest of world | 625 | 720x480
+interlaced; | | or 625/50 |
+625 lines/frame | | or PAL |
+(commonly called PAL) | | or pal |
+
+The default is to use "PAL" parameters.
+
+Currently
+
+Preview
+
+To get a rough preview of the menus, run "videolink --preview menu-url"
+where menu-url is the URL or filename of the first page to show.
+Currently videos cannot be displayed in this preview mode.
+
+Press T to go to the "top" (main) menu or Q to quit.
+
+Processing
+
+To create a DVD filesystem, run "videolink menu-url output-dir" where
+menu-url is the URL or filename of the top menu page and output-dir is
+the directory in which to create the filesystem (which should be
+either nonexistent or empty). VideoLink will automatically follow links
+to the other pages and to the video files.
+
+By default, VideoLink now calls ffmpeg to generate MPEG-2 streams for
+menus. If you want it to use mjpegtools as it previously did, you
+must add the option "--encoder mjpegtools". If you use mjpegtools
+1.6.2 or earlier you must instead use "--encoder mjpegtools-old".
+This is due to an incompatible change in the syntax of the ppmtoy4m
+command between versions 1.6.2 and 1.8.
+
+If this is successful you can then use mkisofs to create a DVD image
+from the output directory. Alternately you can write this directory
+directly to a writable DVD with growisofs or with mkisofs piped to a
+suitable version of cdrecord.
+
+Example
+-------
+
+A live example set of menus can currently be found at
+<http://womble.decadent.org.uk/software/debconf5-dvd/menus/main.html>.
+Note that this has large background images that will take some time to
+load.