Made various small improvements.

diff --git a/videolink.1 b/videolink.1
index 6e65f2fff4a25fe6a216108867c82977c24cd77a..fcb2579c5f597929c84367d6e37b4183849317e1 100644 (file)
--- a/videolink.1
+++ b/videolink.1
@@ -22,33 +22,43 @@ videolink \- assembles a DVD video filesystem from HTML pages and video files
 .SH DESCRIPTION
 .LP
 VideoLink converts an interlinked set of HTML pages and video files
-into a DVD.  Starting from a main menu page, it follows links and
-encodes all linked pages as video files.  It uses \fBdvdauthor\fR(1)
-to assemble a DVD video filesystem containing the encoded pages and
-other video files they link to.
+into a DVD.  Starting from a main menu page at \fImenu-url\fR, it
+follows links and encodes all linked pages as video files.  It uses
+\fBdvdauthor\fR(1) to assemble a DVD video filesystem in
+\fIoutput-dir\fR containing the encoded pages and other video files
+they link to.
+.LP
+There are some restrictions on the content of the HTML pages, detailed
+in \fBREADME.gz\fR.  The existing video files are not converted and
+therefore must conform to the DVD video specifications.
 .SH OPTIONS
 .TP
 .B \-\-preview
 .RS
 Selects preview mode.  In preview mode, the pages are displayed in a
-browser roughly as they will appear on a DVD player.
+browser roughly as they will appear on a DVD player.  No conversion
+is done.
 .RE
 .TP
 .BI \-\-video-std " standard"
 .RS
 Selects the target video standard.  This should match the standard
-used for the video files.  It affects the frame size and the frame
-rate specified when encoding pages as video.  The two standards can be
-specified as "525", "525/60", "NTSC" or "ntsc" and as "625", "625/50",
-"PAL" or "pal" respectively.
+used for the existing video files.  It affects the frame size and the
+frame rate specified when encoding pages as video.  The standard of
+525-line frames and 59.94\ Hz interlaced fields, commonly called NTSC,
+can be specified as "525", "525/60", "NTSC" or "ntsc".  The standard
+of 625-line frames and 50\ Hz interlaced fields, commonly called PAL,
+can be specified as "625", "625/50", "PAL" or "pal"; this is the
+default.
 .RE
 .TP
 .BI \-\-encoder " encoder"
 .RS
 Selects the program(s) used to encode pages to video.  By default
 VideoLink calls \fBffmpeg\fR(1), but it can alternately use programs
-from mjpegtools.  The \fIencoder\fR can be "ffmpeg", "mjpegtools", or
-"mjpegtools-old" for versions of mjpegtools prior to 1.8.
+from mjpegtools and netpbm.  The \fIencoder\fR can be "ffmpeg",
+"mjpegtools", or "mjpegtools-old" for versions of mjpegtools prior to
+1.8.
 .RE
 .SH AUTHOR
 Ben Hutchings <ben@decadent.org.uk>.