From 961aecd24669fa1e720a10aef40cad29d9f2d02f Mon Sep 17 00:00:00 2001 From: Moritz Bunkus Date: Sun, 30 Oct 2011 20:27:14 +0100 Subject: [PATCH] Use refsect2 for parameter type messages instead of normal para --- doc/man/mkvmerge.xml | 2472 +++++++++++++++++++++--------------------- 1 file changed, 1236 insertions(+), 1236 deletions(-) diff --git a/doc/man/mkvmerge.xml b/doc/man/mkvmerge.xml index 97337d41b..6b4560184 100644 --- a/doc/man/mkvmerge.xml +++ b/doc/man/mkvmerge.xml @@ -75,1251 +75,1250 @@ - - Global options: - + + Global options - - - , - - Increase verbosity. - - + + + , + + Increase verbosity. + + - - , - - Suppress status output. - - + + , + + Suppress status output. + + - - , file-name - - Write to the file file-name. If splitting is used then this parameter is treated a bit differently. See - the explanation for the option for details. - - + + , file-name + + Write to the file file-name. If splitting is used then this parameter is treated a bit differently. See + the explanation for the option for details. + + - - , - - Create a WebM compliant file. This is also turned on if the output file name's extension is "webm". This mode - enforces several restrictions. The only allowed codecs are VP8 video and Vorbis audio tracks. Neither chapters nor tags are - allowed. The DocType header item is changed to "webm". - - - + + , + + Create a WebM compliant file. This is also turned on if the output file name's extension is "webm". This mode + enforces several restrictions. The only allowed codecs are VP8 video and Vorbis audio tracks. Neither chapters nor tags are + allowed. The DocType header item is changed to "webm". + + + - - title - - Sets the general title for the output file, e.g. the movie name. - - + + title + + Sets the general title for the output file, e.g. the movie name. + + - - language-code - - Sets the default language code that will be used for all tracks unless overwritten with the option. The default language code is - 'und' for 'undefined'. - - - + + language-code + + Sets the default language code that will be used for all tracks unless overwritten with the option. The default language code is + 'und' for 'undefined'. + + + + - - Segment info handling: (global options) - + + Segment info handling (global options) - - - filename.xml - - - Read segment information from a XML file. This file can contain the segment family UID, segment - UID, previous and next segment UID elements. An example file and a DTD are included - in the MKVToolNix distribution. - - - + + + filename.xml + + + Read segment information from a XML file. This file can contain the segment family UID, segment + UID, previous and next segment UID elements. An example file and a DTD are included + in the MKVToolNix distribution. + + + - - SID1,SID2,... - - - Sets the segment UIDs to use. This is a comma-separated list of 128bit segment UIDs in the usual UID form: hex numbers with or without - the "0x" prefix, with or without spaces, exactly 32 digits. - + + SID1,SID2,... + + + Sets the segment UIDs to use. This is a comma-separated list of 128bit segment UIDs in the usual UID form: hex numbers with or without + the "0x" prefix, with or without spaces, exactly 32 digits. + - - Each file created contains one segment, and each segment has one segment UID. If more segment UIDs are specified than segments are - created then the surplus UIDs are ignored. If fewer UIDs are specified than segments are created then random UIDs will be created for - them. - - - - + + Each file created contains one segment, and each segment has one segment UID. If more segment UIDs are specified than segments are + created then the surplus UIDs are ignored. If fewer UIDs are specified than segments are created then random UIDs will be created for + them. + + + + + - - Chapter and tag handling: (global options) - + + Chapter and tag handling (global options) - - - language-code - - - Sets the ISO639-2 language code that is written for each chapter entry. Defaults to 'eng'. See the section about - chapters below for details. - + + + language-code + + + Sets the ISO639-2 language code that is written for each chapter entry. Defaults to 'eng'. See the section about + chapters below for details. + - - This option can be used both for simple chapter files and for source files that contain chapters but no information about the - chapters' language, e.g. MP4 and OGM files. - - - + + This option can be used both for simple chapter files and for source files that contain chapters but no information about the + chapters' language, e.g. MP4 and OGM files. + + + - - character-set - - - Sets the character set that is used for the conversion to UTF-8 for simple chapter files. See the section about text files and character sets for an explanation how &mkvmerge; converts between - character sets. - + + character-set + + + Sets the character set that is used for the conversion to UTF-8 for simple chapter files. See the section about text files and character sets for an explanation how &mkvmerge; converts between + character sets. + - - This switch does also apply to chapters that are copied from certain container types, e.g. Ogg/OGM and MP4 files. - See the section about chapters below for details. - - - + + This switch does also apply to chapters that are copied from certain container types, e.g. Ogg/OGM and MP4 files. + See the section about chapters below for details. + + + - - format - - - &mkvmerge; supports reading CUE sheets for audio files as the input for chapters. CUE sheets usually - contain the entries PERFORMER and TITLE for each index entry. &mkvmerge; uses these two strings - in order to construct the chapter name. With this option the format used for this name can be set. - + + format + + + &mkvmerge; supports reading CUE sheets for audio files as the input for chapters. CUE sheets usually + contain the entries PERFORMER and TITLE for each index entry. &mkvmerge; uses these two strings + in order to construct the chapter name. With this option the format used for this name can be set. + - - If this option is not given then &mkvmerge; defaults to the format '%p - %t' (the performer, followed by a space, a dash, - another space and the title). - + + If this option is not given then &mkvmerge; defaults to the format '%p - %t' (the performer, followed by a space, a dash, + another space and the title). + - - If the format is given then everything except the following meta characters is copied as-is, and the meta - characters are replaced like this: - + + If the format is given then everything except the following meta characters is copied as-is, and the meta + characters are replaced like this: + - - - %p is replaced by the current entry's PERFORMER string, - - - %t is replaced by the current entry's TITLE string, - - - %n is replaced by the current track number and - - - %N is replaced by the current track number padded with a leading zero if - it is < 10. - - - - + + + %p is replaced by the current entry's PERFORMER string, + + + %t is replaced by the current entry's TITLE string, + + + %n is replaced by the current track number and + + + %N is replaced by the current track number padded with a leading zero if + it is < 10. + + + + - - file-name - - - Read chapter information from the file file-name. See the section about chapters below for details. - - - + + file-name + + + Read chapter information from the file file-name. See the section about chapters below for details. + + + - - file-name - - - Read global tags from the file file-name. See the section about tags below - for details. - - - - + + file-name + + + Read global tags from the file file-name. See the section about tags below + for details. + + + + + - - General output control (advanced global options): - + + General output control (advanced global options) - - - FID1:TID1,FID2:TID2,... - - - This option changes the order in which the tracks for an input file are created. The argument is a comma separated list of pairs - IDs. Each pair contains first the file ID (FID1) which is simply the number of the file on the command line - starting at 0. The second is a track ID (TID1) from that file. If some track IDs are omitted then those tracks - are created after the ones given with this option have been created. - - - + + + FID1:TID1,FID2:TID2,... + + + This option changes the order in which the tracks for an input file are created. The argument is a comma separated list of pairs + IDs. Each pair contains first the file ID (FID1) which is simply the number of the file on the command line + starting at 0. The second is a track ID (TID1) from that file. If some track IDs are omitted then those tracks + are created after the ones given with this option have been created. + + + - - spec - - - Limit the number of data blocks or the duration of data in each cluster. The spec parameter can either be a - number n without a unit or a number d postfixed with 'ms'. - + + spec + + + Limit the number of data blocks or the duration of data in each cluster. The spec parameter can either be a + number n without a unit or a number d postfixed with 'ms'. + - - If no unit is used then &mkvmerge; will put at most n data blocks into each cluster. The maximum number of - blocks is 65535. - + + If no unit is used then &mkvmerge; will put at most n data blocks into each cluster. The maximum number of + blocks is 65535. + - - If the number d is postfixed with 'ms' then &mkvmerge; puts at most d - milliseconds of data into each cluster. The minimum for d is '100ms', and the maximum is - '32000ms'. - + + If the number d is postfixed with 'ms' then &mkvmerge; puts at most d + milliseconds of data into each cluster. The minimum for d is '100ms', and the maximum is + '32000ms'. + - - &mkvmerge; defaults to putting at most 65535 data blocks and 5000ms of data into a cluster. - + + &mkvmerge; defaults to putting at most 65535 data blocks and 5000ms of data into a cluster. + - - Programs trying to find a certain frame can only seek directly to a cluster and have to read the whole cluster afterwards. Therefore - creating larger clusters may lead to imprecise or slow seeking. - - - + + Programs trying to find a certain frame can only seek directly to a cluster and have to read the whole cluster afterwards. Therefore + creating larger clusters may lead to imprecise or slow seeking. + + + - - - - - Tells &mkvmerge; not to create and write the cue data which can be compared to an index in an AVI. &matroska; files can be played back - without the cue data, but seeking will probably be imprecise and slower. Use this only if you're really desperate for space or for - testing purposes. See also option which can be specified for - each input file. - - - + + + + + Tells &mkvmerge; not to create and write the cue data which can be compared to an index in an AVI. &matroska; files can be played back + without the cue data, but seeking will probably be imprecise and slower. Use this only if you're really desperate for space or for + testing purposes. See also option which can be specified for + each input file. + + + - - - - - Tells &mkvmerge; to create a meta seek element at the end of the file containing all clusters. See also the section about the - &matroska; file layout. - - - + + + + + Tells &mkvmerge; to create a meta seek element at the end of the file containing all clusters. See also the section about the + &matroska; file layout. + + + - - - - - Disables lacing for all tracks. This will increase the file's size, especially if there are many audio tracks. This option is not - intended for everyday use. - - - + + + + + Disables lacing for all tracks. This will increase the file's size, especially if there are many audio tracks. This option is not + intended for everyday use. + + + - - - - - Write durations for all blocks. This will increase file size and does not offer any additional value for players at the moment. - - - + + + + + Write durations for all blocks. This will increase file size and does not offer any additional value for players at the moment. + + + - - factor - - - Forces the timecode scale factor to factor. Valid values are in the range - 1000..10000000 or the special value -1. - + + factor + + + Forces the timecode scale factor to factor. Valid values are in the range + 1000..10000000 or the special value -1. + - - Normally &mkvmerge; will use a value of 1000000 which means that timecodes and durations will have a precision of - 1ms. For files that will not contain a video track but at least one audio track &mkvmerge; will automatically chose a timecode scale - factor so that all timecodes and durations have a precision of one audio sample. This causes bigger overhead but allows precise - seeking and extraction. - + + Normally &mkvmerge; will use a value of 1000000 which means that timecodes and durations will have a precision of + 1ms. For files that will not contain a video track but at least one audio track &mkvmerge; will automatically chose a timecode scale + factor so that all timecodes and durations have a precision of one audio sample. This causes bigger overhead but allows precise + seeking and extraction. + - - If the special value -1 is used then &mkvmerge; will use sample precision even if a video track is present. - - - - + + If the special value -1 is used then &mkvmerge; will use sample precision even if a video track is present. + + + + + - - File splitting, linking and appending (more global options): - + + File splitting, linking and appending (more global options) - - - specification + + + specification - - - Splits the output file after a given size or a given time. Please note that tracks can only be split right before a key frame. Due - to buffering &mkvmerge; will split right before the next key frame after the split point has been reached. Therefore the split point - may be a bit off from what the user has specified. - + + + Splits the output file after a given size or a given time. Please note that tracks can only be split right before a key frame. Due + to buffering &mkvmerge; will split right before the next key frame after the split point has been reached. Therefore the split point + may be a bit off from what the user has specified. + - - At the moment &mkvmerge; supports three different modes. - + + At the moment &mkvmerge; supports three different modes. + - - - - Splitting by size. - + + + + Splitting by size. + - - Syntax: size:dk|m|g - + + Syntax: size:dk|m|g + - - Examples: --split size:700m or --split 150000000 - + + Examples: --split size:700m or --split 150000000 + - - The parameter d may end with 'k', 'm' or 'g' to - indicate that the size is in KB, MB or GB respectively. Otherwise a size in bytes is assumed. After the current output file has - reached this size limit a new one will be started. - + + The parameter d may end with 'k', 'm' or 'g' to + indicate that the size is in KB, MB or GB respectively. Otherwise a size in bytes is assumed. After the current output file has + reached this size limit a new one will be started. + - - The 'size:' prefix may be omitted for compatibility reasons. - - + + The 'size:' prefix may be omitted for compatibility reasons. + + - - - Splitting after a duration. - + + + Splitting after a duration. + - - Syntax: duration:HH:MM:SS.nnnnnnnnn|ds - + + Syntax: duration:HH:MM:SS.nnnnnnnnn|ds + - - Examples: --split duration:00:60:00.000 or --split 3600s - + + Examples: --split duration:00:60:00.000 or --split 3600s + - - The parameter must either have the form HH:MM:SS.nnnnnnnnn for specifying the duration in up to nano-second - precision or be a number d followed by the letter 's' for the duration in - seconds. HH is the number of hours, MM the number of minutes, - SS the number of seconds and nnnnnnnnn the number of nanoseconds. Both the number of - hours and the number of nanoseconds can be omitted. There can be up to nine digits after the decimal point. After the duration of - the contents in the current output has reached this limit a new output file will be started. - + + The parameter must either have the form HH:MM:SS.nnnnnnnnn for specifying the duration in up to nano-second + precision or be a number d followed by the letter 's' for the duration in + seconds. HH is the number of hours, MM the number of minutes, + SS the number of seconds and nnnnnnnnn the number of nanoseconds. Both the number of + hours and the number of nanoseconds can be omitted. There can be up to nine digits after the decimal point. After the duration of + the contents in the current output has reached this limit a new output file will be started. + - - The 'duration:' prefix may be omitted for compatibility reasons. - - + + The 'duration:' prefix may be omitted for compatibility reasons. + + - - - Splitting after specific timecodes. - + + + Splitting after specific timecodes. + - - Syntax: timecodes:A,B,C... - + + Syntax: timecodes:A,B,C... + - - Example: --split timecodes:00:45:00.000,01:20:00.250,6300s - + + Example: --split timecodes:00:45:00.000,01:20:00.250,6300s + - - The parameters A, B, C etc must all have the same format as the - ones used for the duration (see above). The list of timecodes is separated by commas. After the input stream has reached the - current split point's timecode a new file is created. Then the next split point given in this list is used. - + + The parameters A, B, C etc must all have the same format as the + ones used for the duration (see above). The list of timecodes is separated by commas. After the input stream has reached the + current split point's timecode a new file is created. Then the next split point given in this list is used. + - - The 'timecodes:' prefix must not be omitted. - - - - + + The 'timecodes:' prefix must not be omitted. + + + + For this splitting mode the output filename is treated differently than for the normal operation. It may contain a printf like expression '%d' including an optional field width, e.g. '%02d'. If it does then the current file number will be formatted appropriately and inserted at that point in the filename. If there is no such pattern then a pattern of '-%03d' is assumed right before the file's extension: '-o output.mkv' would result in 'output-001.mkv' and so on. If there's no extension then '-%03d' will be appended to the name. - - - + + + - - - - - Link files to one another when splitting the output file. See the section on file linking - below for details. - - - + + + + + Link files to one another when splitting the output file. See the section on file linking + below for details. + + + - - segment-UID - - - Links the first output file to the segment with the segment UID given by the segment-UID parameter. See the - section on file linking below for details. - - - + + segment-UID + + + Links the first output file to the segment with the segment UID given by the segment-UID parameter. See the + section on file linking below for details. + + + - - segment-UID - - - Links the last output file to the segment with the segment UID given by the segment-UID parameter. See the - section on file linking below for details. - - - + + segment-UID + + + Links the last output file to the segment with the segment UID given by the segment-UID parameter. See the + section on file linking below for details. + + + - - mode - - - Determines how timecodes are calculated when appending files. The parameter mode can have two values: - 'file' which is also the default and 'track'. - + + mode + + + Determines how timecodes are calculated when appending files. The parameter mode can have two values: + 'file' which is also the default and 'track'. + - - When mkvmerge appends a track (called 'track2_1' from now on) from a second file (called - 'file2') to a track (called 'track1_1') from the first file (called 'file1') - then it has to offset all timecodes for 'track2_1' by an amount. For 'file' mode this amount is - the highest timecode encountered in 'file1' even if that timecode was from a different track than - 'track1_1'. In track mode the offset is the highest timecode of 'track1_1'. - + + When mkvmerge appends a track (called 'track2_1' from now on) from a second file (called + 'file2') to a track (called 'track1_1') from the first file (called 'file1') + then it has to offset all timecodes for 'track2_1' by an amount. For 'file' mode this amount is + the highest timecode encountered in 'file1' even if that timecode was from a different track than + 'track1_1'. In track mode the offset is the highest timecode of 'track1_1'. + - - Unfortunately mkvmerge cannot detect which mode to use reliably. Therefore it defaults to 'file' - mode. 'file' mode usually works better for files that have been created independently of each other; e.g. when - appending AVI or MP4 files. 'track' mode may work better for sources that are - essentially just parts of one big file, e.g. for VOB and EVO files. - + + Unfortunately mkvmerge cannot detect which mode to use reliably. Therefore it defaults to 'file' + mode. 'file' mode usually works better for files that have been created independently of each other; e.g. when + appending AVI or MP4 files. 'track' mode may work better for sources that are + essentially just parts of one big file, e.g. for VOB and EVO files. + - - Subtitle tracks are always treated as if 'file' mode were active even if 'track' mode actually - is. - - - + + Subtitle tracks are always treated as if 'file' mode were active even if 'track' mode actually + is. + + + - - SFID1:STID1:DFID1:DTID1,... - - - This option controls to which track another track is appended. Each spec contains four IDs: a file ID, a track ID, a second file ID - and a second track ID. The first pair, "source file ID" and "source track ID", identifies the track that is to be appended. The - second pair, "destination file ID" and "destination track ID", identifies the track the first one is appended to. - + + SFID1:STID1:DFID1:DTID1,... + + + This option controls to which track another track is appended. Each spec contains four IDs: a file ID, a track ID, a second file ID + and a second track ID. The first pair, "source file ID" and "source track ID", identifies the track that is to be appended. The + second pair, "destination file ID" and "destination track ID", identifies the track the first one is appended to. + - - If this option has been omitted then a standard mapping is used. This standard mapping appends each track from the current file to a - track from the previous file with the same track ID. This allows for easy appending if a movie has been split into two parts and both - file have the same number of tracks and track IDs with the command mkvmerge -o output.mkv part1.mkv +part2.mkv. - - - + + If this option has been omitted then a standard mapping is used. This standard mapping appends each track from the current file to a + track from the previous file with the same track ID. This allows for easy appending if a movie has been split into two parts and both + file have the same number of tracks and track IDs with the command mkvmerge -o output.mkv part1.mkv +part2.mkv. + + + - - - - - A single '+' causes the next file to be appended instead of added. The '+' can also be put in front of the next file name. Therefore - the following two commands are equivalent: - + + + + + A single '+' causes the next file to be appended instead of added. The '+' can also be put in front of the next file name. Therefore + the following two commands are equivalent: + - $ mkvmerge -o full.mkv file1.mkv + file2.mkv + $ mkvmerge -o full.mkv file1.mkv + file2.mkv $ mkvmerge -o full.mkv file1.mkv +file2.mkv - - + + - - - - - Normally mkvmerge looks for files in the same directory as an input file that have the same base name and only differ in their running - number (e.g. 'VTS_01_1.VOB', 'VTS_01_2.VOB', 'VTS_01_3.VOB' etc). This option, a single '=', causes mkvmerge not to look for those - additional files. - + + + + + Normally mkvmerge looks for files in the same directory as an input file that have the same base name and only differ in their running + number (e.g. 'VTS_01_1.VOB', 'VTS_01_2.VOB', 'VTS_01_3.VOB' etc). This option, a single '=', causes mkvmerge not to look for those + additional files. + - - The '=' can also be put in front of the next file name. Therefore the following two commands are equivalent: - + + The '=' can also be put in front of the next file name. Therefore the following two commands are equivalent: + - $ mkvmerge -o full.mkv = file1.mkv + $ mkvmerge -o full.mkv = file1.mkv $ mkvmerge -o full.mkv =file1.mkv - - - - - - Attachment support (more global options): - - - - - description - - - Plain text description of the following attachment. Applies to the next or option. - - - - - - - MIME type - - - MIME type of the following attachment. Applies to the next or option. A list of officially recognized - MIME types can be found e.g. at the IANA - homepage. The MIME type is mandatory for an attachment. - - - - - - name - - - Sets the name that will be stored in the output file for this attachment. If this option is not given then the name will be derived - from the file name of the attachment as given with the or the option. - - - - - - - file-name, - file-name - - - - Creates a file attachment inside the &matroska; file. The MIME type must have been set before this option can used. The - difference between the two forms is that during splitting the files attached with are attached to all - output files while the ones attached with are only attached to the first file created. If - splitting is not used then both do the same. - - - - &mkvextract; can be used to extract attached files from a &matroska; file. - - - - - - - Options that can be used for each input file: - - - - - , !n,m,... - - - Copy the audio tracks n, m etc. The numbers are track IDs which can be obtained with the - switch. They're not simply the track numbers (see - section track IDs). Default: copy all audio tracks. - - - - If the IDs are prefixed with ! then the meaning is reversed: copy everything but the IDs listed after the - !. - - - - - - , !n,m,... - - - Copy the video tracks n, m etc. The numbers are track IDs which can be obtained with the - switch. They're not simply the track numbers (see - section track IDs). Default: copy all video tracks. - - - - If the IDs are prefixed with ! then the meaning is reversed: copy everything but the IDs listed after the - !. - - - - - - , !n,m,... - - - Copy the subtitle tracks n, m etc. The numbers are track IDs which can be obtained with - the switch. They're not simply the track numbers (see - section track IDs). Default: copy all subtitle tracks. - - - - If the IDs are prefixed with ! then the meaning is reversed: copy everything but the IDs listed after the - !. - - - - - - , !n,m,... - - - Copy the button tracks n, m etc. The numbers are track IDs which can be obtained with - the switch. They're not simply the track numbers (see - section track IDs). Default: copy all button tracks. - - - - If the IDs are prefixed with ! then the meaning is reversed: copy everything but the IDs listed after the - !. - - - - - - !n,m,... - - - Copy the tags for tracks n, m etc. The numbers are track IDs which can be obtained with - the switch (see section track IDs). They're not simply the track numbers. Default: copy tags for all tracks. - - - - If the IDs are prefixed with ! then the meaning is reversed: copy everything but the IDs listed after the - !. - - - - - - , !n:all|first,m:all|first,... - - - Copy the attachments with the IDs n, m etc to all or only the first output file. Each ID - can be followed by either ':all' (which is the default if neither is entered) or ':first'. If - splitting is active then those attachments whose IDs are specified with ':all' are copied to all of the resulting - output files while the others are only copied into the first output file. If splitting is not active then both variants have the same - effect. - - - - The default is to copy all attachments to all output files. - - - - If the IDs are prefixed with ! then the meaning is reversed: copy everything but the IDs listed after the - !. - - - - - - , - - - Don't copy any audio track from this file. - - - - - - , - - - Don't copy any video track from this file. - - - - - - , - - - Don't copy any subtitle track from this file. - - - - - - , - - - Don't copy any button track from this file. - - - - - - , - - - Don't copy any track specific tags from this file. - - - - - - - - - Don't copy chapters from this file. - - - - - - , - - - Don't copy attachments from this file. - - - - - - - - - Don't copy global tags from this file. - - - - - - character-set - - - Sets the charset that is used for the conversion to UTF-8 for chapter information contained in the source file. See the section about - text files and character sets for an explanation how &mkvmerge; converts - between character sets. - - - - - - language-code - - - Sets the ISO639-2 language code that is written for each chapter entry. This option can be used for source files that contain - chapters but no information about the chapters' languages, e.g. for MP4 and OGM files. - - - - - - , TID:d,o/p - - - Adjust the timecodes of the track with the id TID by d ms. The track IDs are the same as - the ones given with (see section track IDs). - - - - o/p: adjust the timestamps by o/p to fix - linear drifts. p defaults to 1 if omitted. Both o and p can be - floating point numbers. - - - - Defaults: no manual sync correction (which is the same as d = 0 and - o/p = 1.0). - - - - This option can be used multiple times for an input file applying to several tracks by selecting different track IDs each time. - - - - - - TID:none|iframes|all - - - Controls for which tracks cue (index) entries are created for the given track (see section track - IDs). 'none' inhibits the creation of cue entries. For 'iframes' only blocks with - no backward or forward references ( = I frames in video tracks) are put into the cue sheet. 'all' causes - &mkvmerge; to create cue entries for all blocks which will make the file very big. - - - - The default is 'iframes' for video tracks and 'none' for all others. See also option which inhibits the creation of cue entries regardless of the - options used. - - - - This option can be used multiple times for an input file applying to several tracks by selecting different track IDs each time. - - - - - - TID:bool - - - Sets the 'default' flag for the given track (see section track IDs) if the optional argument - bool is not present. If the user does not explicitly select a track himself then the player should prefer the - track that has his 'default' flag set. Only one track of each kind (audio, video, subtitles, buttons) can have his 'default' flag set. - If the user wants no track to have the default track flag set then he has to set bool to 0 - for all tracks. - - - - This option can be used multiple times for an input file applying to several tracks by selecting different track IDs each time. - - - - - - TID:bool - - - Sets the 'forced' flag for the given track (see section track IDs) if the optional argument - bool is not present. A player must play all tracks for which this flag is set to 1. - - - - This option can be used multiple times for an input file applying to several tracks by selecting different track IDs each time. - - - - - - TID:level - - - Keep only the BlockAdditions up to the level level for the given track. The default is - to keep all levels. This option only affects certain kinds of codecs like WAVPACK4. - - - - - - TID:name - - - Sets the track name for the given track (see section track IDs) to - name. - - - - - - TID:language - - - Sets the language for the given track (see section track IDs). Both ISO639-2 language codes - and ISO639-1 country codes are allowed. The country codes will be converted to language codes automatically. All languages including - their ISO639-2 codes can be listed with the option. - - - - This option can be used multiple times for an input file applying to several tracks by selecting different track IDs each time. - - - - - - , TID:file-name - - - Read tags for the track with the number TID from the file file-name. See the section - about tags below for details. - - - - - - TID:0|1 - - - Tells &mkvmerge; that the track with the ID TID is SBR AAC (also known as - HE-AAC or AAC+). This options is needed if a) the source file is an AAC file - (not for a &matroska; file) and b) the AAC file contains SBR AAC data. The - reason for this switch is that it is technically impossible to automatically tell normal AAC data from SBR - AAC data without decoding a complete AAC frame. As there are several patent issues with AAC - decoders &mkvmerge; will never contain this decoding stage. So for SBR AAC files this switch is mandatory. The - resulting file might not play back correctly or even not at all if the switch was omitted. - - - - If the source file is a &matroska; file then the CodecID should be enough to detect SBR - AAC. However, if the CodecID is wrong then this switch can be used to correct that. - - - - If mkvmerge wrongfully detects that an AAC file is SBR then you can add - ':0' to the track ID. - - - - - - TID:file-name - - - Read the timecodes to be used for the specific track ID from file-name. These timecodes forcefully override - the timecodes that &mkvmerge; normally calculates. Read the section about external - timecode files. - - - - - - TID:x - - - Forces the default duration of a given track to the specified value. Also modifies the track's timecodes to match the default - duration. The argument x must be postfixed with 's', 'ms', - 'us', 'ns' or 'fps' to specify the default duration in seconds, milliseconds, - microseconds, nanoseconds or 'frames per second' respectively. The number x itself can be a floating point - number or a fraction. - - - - If the default duration is not forced then mkvmerge will try to derive the track's default duration from the container and/or codec - used. One case in which this option is of use is when adding AVC/h.264 elementary streams because - these do not contain information about their number of frames or a default duration for each frame. For such files &mkvmerge; will - assume a default duration of '25fps' unless overridden. - - - - This option can also be used to change the FPS of video tracks without having to use an external timecode file. - - - - - - TID:n - - - Forces the NALU size length to n bytes. This parameter is only used if the - AVC/h.264 elementary stream packetizer is used. If left out it defaults to 4 bytes, but there are - files that contain frames or slices that are all smaller than 65536 bytes. For such files you can use this parameter and decrease - the size to 2. - - - - - - TID:n - - - Selects the compression method to be used for the track. Note that the player also has to support this method. Valid values are - 'none', 'zlib', 'lzo'/'lxo1x', - 'bz2'/'bzlib' and 'mpeg4_p2'/'mpeg4p2'. The values - 'lzo'/'lxo1x' and 'bz2'/'bzlib' are only available if - &mkvmerge; has been compiled with support for the liblzo and bzlib compression libraries, - respectively. - - - The compression method 'mpeg4_p2'/'mpeg4p2' is a special compression method called - 'header removal' that is only available for MPEG4 part 2 video tracks. - - - The default for some subtitle tracks is 'zlib' compression. This compression method is also the one that most if - not all playback applications support. Support for other compression methods other than 'none' is not assured. - - - - - - - Options that only apply to video tracks: - - - - - , TID:FourCC - - - Forces the FourCC to the specified value. Works only for video tracks in the 'MS compatibility - mode'. - - - - - - TID:widthxheight - - - &matroska; files contain two values that set the display properties that a player should scale the image on playback to: display width - and display height. These values can be set with this option, e.g. '1:640x480'. - - - - Another way to specify the values is to use the or the option (see below). These options - are mutually exclusive. - - - - - - TID:ratio|width/height - - - &matroska; files contain two values that set the display properties that a player should scale the image on playback to: display width - and display height. With this option &mkvmerge; will automatically calculate the display width and display height based on the - image's original width and height and the aspect ratio given with this option. The ratio can be given either as a floating point - number ratio or as a fraction 'width/height', - e.g. '16/9'. - - - - Another way to specify the values is to use the or options (see above and below). These - options are mutually exclusive. - - - - - - TID:factor|n/d - - - Another way to set the aspect ratio is to specify a factor. The original aspect ratio is first multiplied with - this factor and used as the target aspect ratio afterwards. - - - - Another way to specify the values is to use the or options (see above). These options are - mutually exclusive. - - - - - - TID:left,top,right,bottom - - - Sets the pixel cropping parameters of a video track to the given values. - - - - - - TID:n|keyword - - - Sets the stereo mode for the video track with the track ID TID. The mode can either be a number - n between 0 and 14 or one of these keywords: - - - - 'mono', 'side_by_side_left_first', 'top_bottom_right_first', - 'top_bottom_left_first', 'checkerboard_right_first', - 'checkerboard_left_first', 'row_interleaved_right_first', - 'row_interleaved_left_first', 'column_interleaved_right_first', - 'column_interleaved_left_first', 'anaglyph_cyan_red', - 'side_by_side_right_first', 'anaglyph_green_magenta', - 'both_eyes_laced_left_first', 'both_eyes_laced_right_first'. - - - - - - - Options that only apply to text subtitle tracks: - - - - - TID:character-set - - - Sets the character set for the conversion to UTF-8 for UTF-8 subtitles for the given track ID. If not specified the charset will be - derived from the current locale settings. Note that a charset is not needed for subtitles read from &matroska; files or from Kate - streams, as these are always stored in UTF-8. See the section about text files and - character sets for an explanation how &mkvmerge; converts between character sets. - - - - This option can be used multiple times for an input file applying to several tracks by selecting different track IDs each time. - - - - - - - Other options: - - - - - , file-name - - - Will let &mkvmerge; probe the single file and report its type, the tracks contained in the file and their track IDs. If this option is - used then the only other option allowed is the filename. - - - - - - , file-name - - - Will let &mkvmerge; probe the single file and report its type, the tracks contained in the file and their track IDs. If this option is - used then the only other option allowed is the filename. - - - - This option causes &mkvmerge; to output additional information about the container and each track within. The extra information is - surronded by square brackets. It consists of space-saparated key/value pairs where keys and values are separated by a colon. - - - - Each value is escaped according to the rules described in the section about escaping special - characters in text. - - - - - - , - - - Lists supported input file types. - - - - - - - - - Lists all languages and their ISO639-2 code which can be used with the option. - - - - - - priority - - - Sets the process priority that &mkvmerge; runs with. Valid values are 'lowest', 'lower', - 'normal', 'higher' and 'highest'. If nothing is given then - 'normal' is used. On Unix like systems &mkvmerge; will use the - nice2 function. Therefore only the super user can - use 'higher' and 'highest'. On Windows all values are useable for every user. - - - - - - character-set - - - Sets the character set to convert strings given on the command line from. It defaults to the character set given by system's current - locale. This settings applies to arguments of the following options: , and . - - - - - - character-set - - - Sets the character set to which strings are converted that are to be output. It defaults to the character set given by system's - current locale. - - - - - - , file-name - - - Writes all messages to the file file-name instead of to the console. While this can be done easily with output - redirection there are cases in which this option is needed: when the terminal reinterprets the output before writing it to a file. - The character set set with is honored. - - - - - - code - - - Forces the translations for the language code to be used (e.g. 'de_DE' for the German - translations). It is preferable to use the environment variables LANG, LC_MESSAGES and - LC_ALL though. Entering 'list' as the code will cause &mkvmerge; to - output a list of available translations. - - - - - - options-file - - - Reads additional command line arguments from the file options-file. Lines whose first non-whitespace character - is a hash mark ('#') are treated as comments and ignored. White spaces at the start and end of a line will be - stripped. Each line must contain exactly one option. - - - - Several chars can be escaped, e.g. if you need to start a non-comment line with '#'. The rules are described in the section about escaping text. - - - - Note that backslashes must always be escaped. Hash marks ('#') must be escaped if they should not start a comment. - - - - The command line 'mkvmerge -o "my file.mkv" -A "a movie.avi" sound.ogg' could be converted into the following - option file: - - - # Write to the file "c:\Matroska\my file.mkv" on Windows. + + + + + + + Attachment support (more global options) + + + + description + + + Plain text description of the following attachment. Applies to the next or option. + + + + + + + MIME type + + + MIME type of the following attachment. Applies to the next or option. A list of officially recognized + MIME types can be found e.g. at the IANA + homepage. The MIME type is mandatory for an attachment. + + + + + + name + + + Sets the name that will be stored in the output file for this attachment. If this option is not given then the name will be derived + from the file name of the attachment as given with the or the option. + + + + + + + file-name, + file-name + + + + Creates a file attachment inside the &matroska; file. The MIME type must have been set before this option can used. The + difference between the two forms is that during splitting the files attached with are attached to all + output files while the ones attached with are only attached to the first file created. If + splitting is not used then both do the same. + + + + &mkvextract; can be used to extract attached files from a &matroska; file. + + + + + + + + Options that can be used for each input file + + + + , !n,m,... + + + Copy the audio tracks n, m etc. The numbers are track IDs which can be obtained with the + switch. They're not simply the track numbers (see + section track IDs). Default: copy all audio tracks. + + + + If the IDs are prefixed with ! then the meaning is reversed: copy everything but the IDs listed after the + !. + + + + + + , !n,m,... + + + Copy the video tracks n, m etc. The numbers are track IDs which can be obtained with the + switch. They're not simply the track numbers (see + section track IDs). Default: copy all video tracks. + + + + If the IDs are prefixed with ! then the meaning is reversed: copy everything but the IDs listed after the + !. + + + + + + , !n,m,... + + + Copy the subtitle tracks n, m etc. The numbers are track IDs which can be obtained with + the switch. They're not simply the track numbers (see + section track IDs). Default: copy all subtitle tracks. + + + + If the IDs are prefixed with ! then the meaning is reversed: copy everything but the IDs listed after the + !. + + + + + + , !n,m,... + + + Copy the button tracks n, m etc. The numbers are track IDs which can be obtained with + the switch. They're not simply the track numbers (see + section track IDs). Default: copy all button tracks. + + + + If the IDs are prefixed with ! then the meaning is reversed: copy everything but the IDs listed after the + !. + + + + + + !n,m,... + + + Copy the tags for tracks n, m etc. The numbers are track IDs which can be obtained with + the switch (see section track IDs). They're not simply the track numbers. Default: copy tags for all tracks. + + + + If the IDs are prefixed with ! then the meaning is reversed: copy everything but the IDs listed after the + !. + + + + + + , !n:all|first,m:all|first,... + + + Copy the attachments with the IDs n, m etc to all or only the first output file. Each ID + can be followed by either ':all' (which is the default if neither is entered) or ':first'. If + splitting is active then those attachments whose IDs are specified with ':all' are copied to all of the resulting + output files while the others are only copied into the first output file. If splitting is not active then both variants have the same + effect. + + + + The default is to copy all attachments to all output files. + + + + If the IDs are prefixed with ! then the meaning is reversed: copy everything but the IDs listed after the + !. + + + + + + , + + + Don't copy any audio track from this file. + + + + + + , + + + Don't copy any video track from this file. + + + + + + , + + + Don't copy any subtitle track from this file. + + + + + + , + + + Don't copy any button track from this file. + + + + + + , + + + Don't copy any track specific tags from this file. + + + + + + + + + Don't copy chapters from this file. + + + + + + , + + + Don't copy attachments from this file. + + + + + + + + + Don't copy global tags from this file. + + + + + + character-set + + + Sets the charset that is used for the conversion to UTF-8 for chapter information contained in the source file. See the section about + text files and character sets for an explanation how &mkvmerge; converts + between character sets. + + + + + + language-code + + + Sets the ISO639-2 language code that is written for each chapter entry. This option can be used for source files that contain + chapters but no information about the chapters' languages, e.g. for MP4 and OGM files. + + + + + + , TID:d,o/p + + + Adjust the timecodes of the track with the id TID by d ms. The track IDs are the same as + the ones given with (see section track IDs). + + + + o/p: adjust the timestamps by o/p to fix + linear drifts. p defaults to 1 if omitted. Both o and p can be + floating point numbers. + + + + Defaults: no manual sync correction (which is the same as d = 0 and + o/p = 1.0). + + + + This option can be used multiple times for an input file applying to several tracks by selecting different track IDs each time. + + + + + + TID:none|iframes|all + + + Controls for which tracks cue (index) entries are created for the given track (see section track + IDs). 'none' inhibits the creation of cue entries. For 'iframes' only blocks with + no backward or forward references ( = I frames in video tracks) are put into the cue sheet. 'all' causes + &mkvmerge; to create cue entries for all blocks which will make the file very big. + + + + The default is 'iframes' for video tracks and 'none' for all others. See also option which inhibits the creation of cue entries regardless of the + options used. + + + + This option can be used multiple times for an input file applying to several tracks by selecting different track IDs each time. + + + + + + TID:bool + + + Sets the 'default' flag for the given track (see section track IDs) if the optional argument + bool is not present. If the user does not explicitly select a track himself then the player should prefer the + track that has his 'default' flag set. Only one track of each kind (audio, video, subtitles, buttons) can have his 'default' flag set. + If the user wants no track to have the default track flag set then he has to set bool to 0 + for all tracks. + + + + This option can be used multiple times for an input file applying to several tracks by selecting different track IDs each time. + + + + + + TID:bool + + + Sets the 'forced' flag for the given track (see section track IDs) if the optional argument + bool is not present. A player must play all tracks for which this flag is set to 1. + + + + This option can be used multiple times for an input file applying to several tracks by selecting different track IDs each time. + + + + + + TID:level + + + Keep only the BlockAdditions up to the level level for the given track. The default is + to keep all levels. This option only affects certain kinds of codecs like WAVPACK4. + + + + + + TID:name + + + Sets the track name for the given track (see section track IDs) to + name. + + + + + + TID:language + + + Sets the language for the given track (see section track IDs). Both ISO639-2 language codes + and ISO639-1 country codes are allowed. The country codes will be converted to language codes automatically. All languages including + their ISO639-2 codes can be listed with the option. + + + + This option can be used multiple times for an input file applying to several tracks by selecting different track IDs each time. + + + + + + , TID:file-name + + + Read tags for the track with the number TID from the file file-name. See the section + about tags below for details. + + + + + + TID:0|1 + + + Tells &mkvmerge; that the track with the ID TID is SBR AAC (also known as + HE-AAC or AAC+). This options is needed if a) the source file is an AAC file + (not for a &matroska; file) and b) the AAC file contains SBR AAC data. The + reason for this switch is that it is technically impossible to automatically tell normal AAC data from SBR + AAC data without decoding a complete AAC frame. As there are several patent issues with AAC + decoders &mkvmerge; will never contain this decoding stage. So for SBR AAC files this switch is mandatory. The + resulting file might not play back correctly or even not at all if the switch was omitted. + + + + If the source file is a &matroska; file then the CodecID should be enough to detect SBR + AAC. However, if the CodecID is wrong then this switch can be used to correct that. + + + + If mkvmerge wrongfully detects that an AAC file is SBR then you can add + ':0' to the track ID. + + + + + + TID:file-name + + + Read the timecodes to be used for the specific track ID from file-name. These timecodes forcefully override + the timecodes that &mkvmerge; normally calculates. Read the section about external + timecode files. + + + + + + TID:x + + + Forces the default duration of a given track to the specified value. Also modifies the track's timecodes to match the default + duration. The argument x must be postfixed with 's', 'ms', + 'us', 'ns' or 'fps' to specify the default duration in seconds, milliseconds, + microseconds, nanoseconds or 'frames per second' respectively. The number x itself can be a floating point + number or a fraction. + + + + If the default duration is not forced then mkvmerge will try to derive the track's default duration from the container and/or codec + used. One case in which this option is of use is when adding AVC/h.264 elementary streams because + these do not contain information about their number of frames or a default duration for each frame. For such files &mkvmerge; will + assume a default duration of '25fps' unless overridden. + + + + This option can also be used to change the FPS of video tracks without having to use an external timecode file. + + + + + + TID:n + + + Forces the NALU size length to n bytes. This parameter is only used if the + AVC/h.264 elementary stream packetizer is used. If left out it defaults to 4 bytes, but there are + files that contain frames or slices that are all smaller than 65536 bytes. For such files you can use this parameter and decrease + the size to 2. + + + + + + TID:n + + + Selects the compression method to be used for the track. Note that the player also has to support this method. Valid values are + 'none', 'zlib', 'lzo'/'lxo1x', + 'bz2'/'bzlib' and 'mpeg4_p2'/'mpeg4p2'. The values + 'lzo'/'lxo1x' and 'bz2'/'bzlib' are only available if + &mkvmerge; has been compiled with support for the liblzo and bzlib compression libraries, + respectively. + + + The compression method 'mpeg4_p2'/'mpeg4p2' is a special compression method called + 'header removal' that is only available for MPEG4 part 2 video tracks. + + + The default for some subtitle tracks is 'zlib' compression. This compression method is also the one that most if + not all playback applications support. Support for other compression methods other than 'none' is not assured. + + + + + + + + Options that only apply to video tracks + + + + , TID:FourCC + + + Forces the FourCC to the specified value. Works only for video tracks in the 'MS compatibility + mode'. + + + + + + TID:widthxheight + + + &matroska; files contain two values that set the display properties that a player should scale the image on playback to: display width + and display height. These values can be set with this option, e.g. '1:640x480'. + + + + Another way to specify the values is to use the or the option (see below). These options + are mutually exclusive. + + + + + + TID:ratio|width/height + + + &matroska; files contain two values that set the display properties that a player should scale the image on playback to: display width + and display height. With this option &mkvmerge; will automatically calculate the display width and display height based on the + image's original width and height and the aspect ratio given with this option. The ratio can be given either as a floating point + number ratio or as a fraction 'width/height', + e.g. '16/9'. + + + + Another way to specify the values is to use the or options (see above and below). These + options are mutually exclusive. + + + + + + TID:factor|n/d + + + Another way to set the aspect ratio is to specify a factor. The original aspect ratio is first multiplied with + this factor and used as the target aspect ratio afterwards. + + + + Another way to specify the values is to use the or options (see above). These options are + mutually exclusive. + + + + + + TID:left,top,right,bottom + + + Sets the pixel cropping parameters of a video track to the given values. + + + + + + TID:n|keyword + + + Sets the stereo mode for the video track with the track ID TID. The mode can either be a number + n between 0 and 14 or one of these keywords: + + + + 'mono', 'side_by_side_left_first', 'top_bottom_right_first', + 'top_bottom_left_first', 'checkerboard_right_first', + 'checkerboard_left_first', 'row_interleaved_right_first', + 'row_interleaved_left_first', 'column_interleaved_right_first', + 'column_interleaved_left_first', 'anaglyph_cyan_red', + 'side_by_side_right_first', 'anaglyph_green_magenta', + 'both_eyes_laced_left_first', 'both_eyes_laced_right_first'. + + + + + + + + Options that only apply to text subtitle tracks + + + + TID:character-set + + + Sets the character set for the conversion to UTF-8 for UTF-8 subtitles for the given track ID. If not specified the charset will be + derived from the current locale settings. Note that a charset is not needed for subtitles read from &matroska; files or from Kate + streams, as these are always stored in UTF-8. See the section about text files and + character sets for an explanation how &mkvmerge; converts between character sets. + + + + This option can be used multiple times for an input file applying to several tracks by selecting different track IDs each time. + + + + + + + + Other options + + + + , file-name + + + Will let &mkvmerge; probe the single file and report its type, the tracks contained in the file and their track IDs. If this option is + used then the only other option allowed is the filename. + + + + + + , file-name + + + Will let &mkvmerge; probe the single file and report its type, the tracks contained in the file and their track IDs. If this option is + used then the only other option allowed is the filename. + + + + This option causes &mkvmerge; to output additional information about the container and each track within. The extra information is + surronded by square brackets. It consists of space-saparated key/value pairs where keys and values are separated by a colon. + + + + Each value is escaped according to the rules described in the section about escaping special + characters in text. + + + + + + , + + + Lists supported input file types. + + + + + + + + + Lists all languages and their ISO639-2 code which can be used with the option. + + + + + + priority + + + Sets the process priority that &mkvmerge; runs with. Valid values are 'lowest', 'lower', + 'normal', 'higher' and 'highest'. If nothing is given then + 'normal' is used. On Unix like systems &mkvmerge; will use the + nice2 function. Therefore only the super user can + use 'higher' and 'highest'. On Windows all values are useable for every user. + + + + + + character-set + + + Sets the character set to convert strings given on the command line from. It defaults to the character set given by system's current + locale. This settings applies to arguments of the following options: , and . + + + + + + character-set + + + Sets the character set to which strings are converted that are to be output. It defaults to the character set given by system's + current locale. + + + + + + , file-name + + + Writes all messages to the file file-name instead of to the console. While this can be done easily with output + redirection there are cases in which this option is needed: when the terminal reinterprets the output before writing it to a file. + The character set set with is honored. + + + + + + code + + + Forces the translations for the language code to be used (e.g. 'de_DE' for the German + translations). It is preferable to use the environment variables LANG, LC_MESSAGES and + LC_ALL though. Entering 'list' as the code will cause &mkvmerge; to + output a list of available translations. + + + + + + options-file + + + Reads additional command line arguments from the file options-file. Lines whose first non-whitespace character + is a hash mark ('#') are treated as comments and ignored. White spaces at the start and end of a line will be + stripped. Each line must contain exactly one option. + + + + Several chars can be escaped, e.g. if you need to start a non-comment line with '#'. The rules are described in the section about escaping text. + + + + Note that backslashes must always be escaped. Hash marks ('#') must be escaped if they should not start a comment. + + + + The command line 'mkvmerge -o "my file.mkv" -A "a movie.avi" sound.ogg' could be converted into the following + option file: + + + # Write to the file "c:\Matroska\my file.mkv" on Windows. -o c:\\Matroska\\my file.mkv # Set the title to '#65'. @@ -1329,82 +1328,83 @@ c:\\Matroska\\my file.mkv -A a movie.avi sound.ogg - - + + - - - - - Lists information about optional features that have been compiled in and exit. The first line output will be the version - information. All following lines contain exactly one word whose presence indicates that the feature has been compiled in. These - features are: - + + + + + Lists information about optional features that have been compiled in and exit. The first line output will be the version + information. All following lines contain exactly one word whose presence indicates that the feature has been compiled in. These + features are: + - - - - 'BZ2' -- the bzlib compression library. Affects the available compression methods for - the option. - - + + + + 'BZ2' -- the bzlib compression library. Affects the available compression methods for + the option. + + - - - 'LZO' -- the lzo compression library. Affects the available compression methods for - the option. - - + + + 'LZO' -- the lzo compression library. Affects the available compression methods for + the option. + + - - - 'FLAC' -- reading raw FLAC files and handling FLAC tracks in other containers, - e.g. Ogg or &matroska;. - - - - - + + + 'FLAC' -- reading raw FLAC files and handling FLAC tracks in other containers, + e.g. Ogg or &matroska;. + + + + + - - , - - - Show usage information and exit. - - - + + , + + + Show usage information and exit. + + + - - , - - - Show version information and exit. - - - + + , + + + Show version information and exit. + + + - - - - - Checks online for new releases by downloading the URL http://mkvtoolnix-releases.bunkus.org/latest-release.xml. Four lines - will be output in key=value style: the URL from where the information was retrieved (key - version_check_url), the currently running version (key running_version), the latest release's - version (key available_version) and the download URL (key download_url). - + + + + + Checks online for new releases by downloading the URL http://mkvtoolnix-releases.bunkus.org/latest-release.xml. Four lines + will be output in key=value style: the URL from where the information was retrieved (key + version_check_url), the currently running version (key running_version), the latest release's + version (key available_version) and the download URL (key download_url). + - - Afterwards the program exists with an exit code of 0 if no newer release is available, with 1 if a newer release is available and with - 2 if an error occured (e.g. if the update information could not be retrieved). - + + Afterwards the program exists with an exit code of 0 if no newer release is available, with 1 if a newer release is available and with + 2 if an error occured (e.g. if the update information could not be retrieved). + - - This option is only available if the program was built with support for libcurl. - - - - + + This option is only available if the program was built with support for libcurl. + + + + +