@@ -523,10 +523,15 @@ Reader options
523523
524524`--extract-media=`*DIR*
525525
526−: Extract images and other media contained in a docx or epub container
527− to the path *DIR*, creating it if necessary, and adjust the images
528− references in the document so they point to the extracted files.
529− This option only affects the docx and epub readers.
526+: Extract images and other media contained in or linked from
527+ the source document to the path *DIR*, creating it if
528+ necessary, and adjust the images references in the document
529+ so they point to the extracted files. If the source format is
530+ a binary container (docx, epub, or odt), the media is
531+ extracted from the container and the original
532+ filenames are used. Otherwise the media is read from the
533+ file system or downloaded, and new filenames are constructed
534+ based on SHA1 hashes of the contents.
530535
531536`--abbreviations=`*FILE*
532537