Imported Debian patch 2010.12.09-1

[youtubedl] / debian / youtube-dl.pod

diff --git a/debian/youtube-dl.pod b/debian/youtube-dl.pod
index db8eb672b381329add6b571fe9fcaeacb7f32014..34cdc06bbf5d7995edf4682b51155835a81e7b6b 100644 (file)
--- a/debian/youtube-dl.pod
+++ b/debian/youtube-dl.pod
@@ -38,6 +38,10 @@ Print help text and exit.
 
 Print program version and exit.
 
+=item -U, --update
+
+Update this program to the latest stable version.
+
 =item -i, --ignore-errors
 
 Ignore errors during download and continue processing.
@@ -46,6 +50,20 @@ Ignore errors during download and continue processing.
 
 Limit the download speed to the specified maximum B<L> (e.g., 50k or 44.6m).
 
+=item -R B<R>, --retries=B<R>
+
+Number B<R> of retries for a given download (default is 10).
+
+=item --playlist-start=B<N>
+
+The number B<N> of the video in a playlist where we should start downlading
+(default is 1).
+
+=item --playlist-end=B<N>
+
+The number B<N> of the video in a playlist where we should stop downloading
+(default is -1, which stands for the last video in the playlist).
+
 =item -u B<UN>, --username=B<UN>
 
 Specify the youtube account username B<UN>. Some videos require an
@@ -59,27 +77,55 @@ Like the username, specifies the account password to be B<PW>.
 =item -n, --netrc 
 
 Get authentication data from the standard unix .netrc file on the user's
-home directory. The machine name is youtube in regarding this usage.
+home directory. The machine name is youtube regarding this usage.
+
+=item -f B<FMT>, --format=B<FMT>
+
+Specify the video format (quality) in which to download the video.
+
+For youtube.com, in particular, the meaning of the format codes is given as:
+
+=over
+
+=item WebM video at 480p: 43
+
+=item WebM video at 720p: 45
+
+=item H264 video in MP4 container at 480p: 18
+
+=item H264 video in MP4 container at 720p: 22
 
-=item -f FMT, --format=FMT
+=item H264 video in MP4 container at 1080p: 37
 
-Specify the video format (quality) in which to download the video. Note
-that not all videos are available in all formats.
+=item H264 video in FLV container at 360p: 34
+
+=item H264 video in FLV container at 480p: 35
+
+=item H263 video at 240p: 5
+
+=item 3GP video: 17
+
+=back
+
+Note that not all videos are available in all formats.
 
 =item -b, --best-quality
 
-Download the best video quality available for the video(s) specified by
-the user.
+This option is deprecated, does nothing currently, and is expected to be
+removed in a next release, as it is the current behavior of youtube-dl.
 
 =item -m, --mobile-version
 
 Synonymous to the option "-f 17", to download videos playable on some
 mobile phones.
 
-=item -d, --high-def
+=item --all-formats
+
+Downloads all formats for which a video may be available.
+
+=item --max-quality=B<FMT>
 
-Synonymous to the option "-f 37", to download videos in HD quality
-(1080p).
+Limit the maximum quality of the videos to downloads to B<FMT>.
 
 =item -q, --quiet
 
@@ -102,6 +148,20 @@ wget or aria2c.
 Simulate the operation, like quiet mode, but show the title of the video
 that would be downloaded.
 
+=item --get-thumbnail
+
+Simulate the operation, like quiet mode, but print the URL of of the video's
+thumbnail.
+
+=item --get-description
+
+Simulate the operation, like quiet mode, but print the description of the
+video.
+
+=item --no-progress
+
+Do not print the progress bar during downloads.
+
 =item -t, --title
 
 Use the title of the video in the file name used to download the video.
@@ -112,6 +172,11 @@ Use the literal title of the video in file name used to download the
 video. Can contain "weird" characters that are not filtered like with
 the -t option.
 
+=item -A, --auto-number
+
+When downloading multiple videos from a playlist, automatically number them,
+in sequence, starting from 00000.
+
 =item -o B<TPL>, --output=B<TPL>
 
 Specify a template B<TPL> for the names of the files to be created when
@@ -189,7 +254,7 @@ like C<%(title)s-%(id)s.%(ext)s>. You can specify your own.
 =head1 AUTHOR
 
 youtube-dl was written by Ricardo Garcia Gonzalez and many contributors
-from all around the internet.  This manpage was written by Rogério Brito
+from all around the internet.  This manpage was written by Rogerio Brito
 <rbrito@users.sf.net>.
 
 =cut