Merge commit 'upstream/2011.09.27'

[youtubedl] / debian / youtube-dl.pod

diff --git a/debian/youtube-dl.pod b/debian/youtube-dl.pod
index 34cdc06bbf5d7995edf4682b51155835a81e7b6b..ae2d2f04c79765ff993e74893fb9670d88c8853d 100644 (file)
--- a/debian/youtube-dl.pod
+++ b/debian/youtube-dl.pod
@@ -64,6 +64,11 @@ The number B<N> of the video in a playlist where we should start downlading
 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 --dump-user-agent
+
+Display how youtube-dl will identify itself (the User-Agent string) to the
+remote server.
+
 =item -u B<UN>, --username=B<UN>
 
 Specify the youtube account username B<UN>. Some videos require an
@@ -107,17 +112,9 @@ For youtube.com, in particular, the meaning of the format codes is given as:
 
 =back
 
-Note that not all videos are available in all formats.
-
-=item -b, --best-quality
-
-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.
+Note that not all videos are available in all formats and that other
+sites supported by B<youtube-dl> may have different conventions for
+their video formats.
 
 =item --all-formats
 
@@ -158,10 +155,19 @@ thumbnail.
 Simulate the operation, like quiet mode, but print the description of the
 video.
 
+=item --get-filename
+
+Simulate the operation, like quiet mode, but print the output filename.
+
 =item --no-progress
 
 Do not print the progress bar during downloads.
 
+=item --console-title
+
+If possible, set the title of the console window with the progress of the
+download.
+
 =item -t, --title
 
 Use the title of the video in the file name used to download the video.
@@ -198,6 +204,28 @@ Do no overwrite already existing files.
 
 Resume partially downloaded files.
 
+=item --cookies=B<F>
+
+Store the received cookies to file B<F> (the "cookie jar").
+
+=item --no-part
+
+Do not append the I<.part> suffix do files that have not yet been completed.
+
+=item --no-mtime
+
+Do not use the I<Last-modified> header to set the file modification time.
+
+=item --extract-audio
+
+Create an audio-only file extracted from the video downloaded. Requires that
+ffmpeg and ffprobe be installed.
+
+=item --audio-format=B<FORMAT>
+
+Set the audio format to be used for the extraction. Possible values are
+I<best>, I<aac>, I<mp3>, with I<best> being the default.
+
 =back
 
 =head1 OUTPUT TEMPLATE