update for 1.1.0

1 files changed, 58 insertions, 15 deletions

diff --git a/doc/html/ru/documentation.html b/doc/html/ru/documentation.html
index 3b1fd24b..03af85e2 100644
--- a/doc/html/ru/documentation.html
+++ b/doc/html/ru/documentation.html
@@ -104,12 +104,12 @@
 
 <P>Первые четыре байта идетифицируют поток FLAC. Следующие за ними метаданные содержат информацию о потоке, затем идут сжатые аудиоданные.</P>
 
-<A NAME="metaflac">
+<A NAME="metadata">
 <H4>Метаданные</H4>
 
 <P>FLAC определяет несколько типов блоков метаданных (все они перечислены на странице <A HREF="format.html">формат</A>). Блоки метаданных могут быть любого размера, новые блоки могут быть легко добавлены. Декодер имеет возможность пропускать неизветные ему блоки метаданных. Обязателен только блок STREAMINFO. В нем содержится частота дискретизация, количество каналов и т.п., а также данные позволяющие декодеру настроить буфферы. Сюда также записывается подпись MD5 <I>несжатых</I> аудиоданных. Это полезно для проверки всего потока после его передачи.</P>
 
-<P>Другие блоки предназначены для резервирования места, хранения таблиц точек поиска, а также данных для конкретных приложений. Опции для добавления блоков PADDING или точек поиска приведены ниже. FLAC не нуждается в точках поиска, однако они позволяют значительно увеличить скорость доступа, а также могут быть использования для расстановки меток в аудио редакторах.</P>
+<P>Другие блоки предназначены для резервирования места, хранения таблиц точек поиска, тегов, список разметки аудиодисков а также данных для конкретных приложений. Опции для добавления блоков PADDING или точек поиска приведены ниже. FLAC не нуждается в точках поиска, однако они позволяют значительно увеличить скорость доступа, а также могут быть использования для расстановки меток в аудио редакторах.</P>
 
 <P>Если Вам нужен собственный блок метаданных, Вы можете определить его и запросить идентификатор <A HREF="id.html">здесь</A>. Вы можете зарезервировать блок PADDING необходимого размера и записать на его место свои данные после кодирования. Полученнный поток будет отвечать формату FLAC, декодеры распознающие эти блоки смогут их использовать, остальные будут их пропускать.</P>
 
@@ -169,13 +169,13 @@
 <P><B><TT>flac</TT></B> вызывается одним из четырех способов:</P>
 
 <BLOCKQUOTE><UL>
-    <LI>Кодирование:<BR><TT>flac [-s] [--skip #] [<I><A HREF="#format_options">&lt;настройки_формата&gt;</A></I>] [<I><A HREF="#encoding_options">&lt;опции_кодирования&gt;</A></I>] [входной_файл [...]]</TT></LI>
+    <LI>Кодирование:<BR><TT>flac [<I><A HREF="#general_options">&lt;основные_ключи&gt;</A></I>] [<I><A HREF="#format_options">&lt;настройки_формата&gt;</A></I>] [<I><A HREF="#encoding_options">&lt;опции_кодирования&gt;</A></I>] [входной_файл [...]]</TT></LI>
 
-    <LI>Декодирование:<BR><TT>flac -d [-s] [--skip #] [-F] [<I><A HREF="#format_options">&lt;настройки_формата&gt;</A></I>] [<I><A HREF="#encoding_options">&lt;опции_кодирования&gt;</A></I>] [входной_файл [...]]</TT></LI>
+    <LI>Декодирование:<BR><TT>flac -d [<I><A HREF="#general_options">&lt;основные_ключи&gt;</A></I>] [<I><A HREF="#format_options">&lt;настройки_формата&gt;</A></I>] [<I><A HREF="#encoding_options">&lt;опции_кодирования&gt;</A></I>] [файл_FLAC [...]]</TT></LI>
 
-    <LI>Тестирование:<BR><TT>flac -t [-s] [входной_файл [...]]</TT></LI>
+    <LI>Тестирование:<BR><TT>flac -t [<I><A HREF="#general_options">&lt;основные_ключи&gt;</A></I>] [файл_FLAC [...]]</TT></LI>
 
-    <LI>Анализ:<BR><TT>flac -a [-s] [--skip #] [<I><A HREF="#analysis_options">&lt;опции_анализа&gt;</A></I>] [входной_файл [...]]</TT></LI>
+    <LI>Анализ:<BR><TT>flac -a [<I><A HREF="#general_options">&lt;основные_ключи&gt;</A></I>] [<I><A HREF="#analysis_options">&lt;опции_анализа&gt;</A></I>] [файл_FLAC [...]]</TT></LI>
 </UL></BLOCKQUOTE></P>
 
 <P>В любом случае, если входной файл не указан, подразумевается стандартный ввод. Если указан только один входной файл, то это может быть "-" для стандартного ввода (stdin). Когда используется стандартный ввод, <B><TT>flac</TT></B> пишет в стандартный вывод (stdout).  В остальных случаях <B><TT>flac</TT></B> выполнит указанные действия для каждого входного файла и запишет результаты в файлы с аналогичными именами (при кодировании суффикс будет заменен на ".flac" или, если его не было, будет добавлен; при декодировании суффиксы также изменяются в соответствии с типом выходных данных.) Оригинал удаляется, только если указан ключ <TT>--delete-input-file</TT>.</P>
@@ -241,8 +241,22 @@
 <TR><TD><TT>--delete-input-file</TT></TD>
 <TD>После успешного окончания кодирования/декодирования входной файл будет удален. Если произойдет ошибка, исходный файл останется.</TD></TR>
 
-<TR><TD><TT>--skip=#</TT></TD>
-<TD>Пропустить первые <TT>#</TT> сэмплов входного файла. Работает для кодирования и декодирования, но не для тестирования.</TD></TR>
+<TR><TD><TT>--skip={#|mm:ss.ss}</TT></TD>
+<TD>Пропустить первые <TT>#</TT> сэмплов входного файла. Работает для кодирования и декодирования, но не для тестирования. Альтернативную форму mm:ss.ss можно использовать, чтобы указать минуты, секунды и сотые секунды.<BR>
+Например:<BR>
+<TT>--skip=123</TT> : пропустить первые 123 сэмпла входного файла<BR>
+<TT>--skip=1:23.45</TT> : пропустить 1 минуту 23.45 секунд
+</TD></TR>
+
+<TR><TD><TT>--until={#|[+|-]mm:ss.ss}</TT></TD>
+<TD>Остановиться на данном сэмпле входного файла. Работает для кодирования и декодирования, но не для тестирования. Сэмпл с указанным номером не включается в вывод. Альтернативную форму mm:ss.ss можно использовать, чтобы указать минуты, секунды и сотые секунды. Если впереди стоит знак <TT>+</TT>, то последний сэмпл берется от начальной точки воспроизведения, если - <TT>-</TT>, то последний сэмпл вычисляется от конца потока аудио.<BR>
+Например:<BR>
+<TT>--until=123</TT> : декодировать первые 123 сэмпла входного файла (сэмплы 0-122)<BR>
+<TT>--until=1:23.45</TT> : декодировать 1 минуту 23.45 секунд<BR>
+<TT>--skip=1:00 --until=+1:23.45</TT> : декодировать от 1:00.00 до 2:23.45<BR>
+<TT>--until=-1:23.45</TT> : декодировать все, кроме последней 1 минуты и 23.45 секунд<BR>
+<TT>--until=-0:00</TT> : декодировать весь ввод
+</TD></TR>
 
 <TR><TD><TT>--ogg</TT></TD>
 <TD><P>При кодировании генерируется вывод в формате Ogg-FLAC вместо "родного" FLAC. Потоки Ogg-FLAC представляют собой потоки FLAC обернутые в транспортный уровень Ogg. Полученный файл будет иметь суффикс '.ogg' и будет декодироваться утилитой <TT><B>flac</B></TT>.</P>
@@ -277,16 +291,26 @@
 <TR><TD><TT>--lax</TT></TD>
 <TD>Позволяет кодеру создавать файлы, отвечающие подмножеству формата FLAC. В результате работы будет получаться непотоковый файл, поэтому этот ключ следует использовать только для архивирования. Декодер будет поддерживать воспроизведение и поиск в таких файлах.</TD></TR>
 
+
+<TR><TD><TT>--replay-gain</TT></TD>
+<TD>Вычислить значения <A HREF="http://www.replaygain.org/">ReplayGain</A> и сохранить из в комментариях Vorbis, аналогично тому, как это делает <A HREF="http://packages.qa.debian.org/v/vorbisgain.html">VorbisGain</A>. Уровень записи и максимальные значения амплитуды будут вычислены для каждого входного файла. Кроме того будет рассчитаны значения для всего альбома (всех входных файлов). Для этого все файлы должны иметь одинакоыую частоту дискретизации, разрешение и число каналов. Допустимы только моно и стерео файлы, а частота дискретизации должна быть 8, 11.025, 12, 16, 22.05, 24, 32, 44.1 или 48 кГц. Обратите внимание на то, что для этой опции может понадобиться несколько дополнительных байтов в блоке PADDING, так как точный размер блока нельзя вычислить, пока не будут обработаны все файлы.<BR>
+Обратите внимание на то, что эту возможность нельзя использовать при кодировании в стандартный вывод.</TD></TR>
+
+<TR><TD><TT>--cuesheet=ИМЯ_ФАЙЛА</TT></TD>
+<TD>Импортировать указанный список разбиения аудиодиска и сохранить его в блоке метаданных <A HREF="format.html#def_CUESHEET">CUESHEET</A>. Эту опцию можно использовать только при кодировании одного файла. Точки поиска будут добавлены для каждого трека из списка в блок <A HREF="format.html#def_SEEKTABLE">SEEKTABLE</A>, если не будет указана опция <TT>--no-cued-seekpoints</TT>.<BR>
+Файл списка разбиения аудиодиска должен иметь такой же вид, в каком его создают программы <A HREF="http://www.goldenhawk.com/cdrwin.htm">CDRwin</A>, <A HREF="http://www.dcsoft.com/prod03.htm">CDRcue</A>, <A HREF="http://www.exactaudiocopy.de/">EAC</A> и т.д</TD></TR>
+
+
 <TR><TD><TT>--sector-align</TT></TD>
 <TD>
-<P>При кодировании нескольких WAVE файлов формата CD-Audio выравнивать их на границу сектора. Эта опция применима только для кодирования нескольких WAVE файлов, каждый из которых должен иметь частоту дискретизации 44.1 кГц и два канала. Если будет указана эта опция кодер выровняет потоки .flac так,
+<P>При кодировании нескольких WAVE файлов, полученных с аудиодиска, выравнивать их на границу сектора. Эта опция применима только для кодирования нескольких WAVE файлов, каждый из которых должен иметь частоту дискретизации 44.1 кГц и два канала. Если будет указана эта опция кодер выровняет потоки .flac так,
 что их длины будут кратны размеру сектора CD-Audio (равны 1/75 секундам или 588 сэмплам). Это осуществляется переносом части сектора в конце каждого WAVE файла в начало следующего. Последний поток будет дополнен до границы выравнивания нулями.</P>
-<P>Использование этой опции не приведет ни к чему, если файлы уже выровнены (например, если правильно скопированы с аудио-CD). <TT><B>flac</B></TT> может выровнять только несколько файлов за один вызов.</P>
+<P>Использование этой опции не приведет ни к чему, если файлы уже выровнены (например, если правильно скопированы с аудиодиска). <TT><B>flac</B></TT> может выровнять только несколько файлов за один вызов.</P>
 
 <P><B>ВНИМАНИЕ</B>: Порядок файлов имеет значение! Если вы сделаете следующий вызов '<TT>flac --sector-align *.wav</TT>', командный процессор может обработать шаблон не в том порядке, в каком вы рассчитываете. Поэтому лучше всего вызывать программу, явно указав список файлов, например, '<TT>flac --sector-align 8.wav 9.wav 10.wav</TT>'.
 </TD></TR>
 
-<TR><TD><TT>-S {#|X|#x}</TT>,<BR><TT>--seekpoint={#|X|#x}</TD>
+<TR><TD><TT>-S {#|X|#x|#s}</TT>,<BR><TT>--seekpoint={#|X|#x|#s}</TD>
 <TD>Добавляет точки для поиска в таблицу <TT>SEEKTABLE</TT>.
 
 <UL>
@@ -295,16 +319,18 @@
     <LI><TT>X&nbsp;</TT> : резервируемые точки (всегда помещаются в конце <TT>SEEKTABLE</TT>).</LI>
 
     <LI><TT>#x</TT> : # равномерно распределенных точек поиска, первая соответствует 0 сэмплу.</LI>
+    
+    <LI><TT>#s</TT> : точки поиски расставляются для каждых # секунд; номер не обязательно должен быть целым числом, например, <TT>-S 9.5s</TT> ознчает, что точки будут проставлены с промежутком 9.5 секунд</LI>
 </UL>
 
 <P>Опцию <TT>-S</TT> можно использовать несколько раз. В результате получится объединенная таблица, в которой будут присутствовать только уникальные значения.<BR>
-По умолчанию <B><TT>flac</TT></B> использует <TT>-S 100x</TT>. Если таблица поиска не нужна, укажите <TT>-S-</TT>.<BR>
-<B>ПРИМЕЧАНИЕ</B>: <TT>-S #x</TT> не будет работать, если кодер не сможет определить размер входного файла в начале работы.<BR>
+По умолчанию <B><TT>flac</TT></B> использует <TT>-S 10s</TT>. Если таблица поиска не нужна, укажите <TT>-S-</TT>.<BR>
+<B>ПРИМЕЧАНИЕ</B>: <TT>-S #x</TT> и <TT>-S #s</TT> не будут работать, если кодер не сможет определить размер входного файла в начале работы.<BR>
 <B>ПРИМЕЧАНИЕ</B>: если <I>#</I> больше или равен количеству сэмплов во входном файле, то точки добавлены не будут, если размер можно определить до кодирования, в противном случае будут записаны резервируемые точки.</P>
 </TD></TR>
 
 <TR><TD><TT>-P #</TT>, <TT>--padding</TT></TD>
-<TD>Кодер запишет блок метаданных <TT>PADDING</TT>, указанного размера (в байтах), после блока <TT>STREAMINFO</TT>. Ключи <TT>-P 0</TT> или <TT>-P-</TT> указывают, что блок <TT>PADDING</TT> не нужен (значение по умолчанию). Этот блок полезен, если вы собираетесь добавить тэг в файл позже. Вместо того, чтобы переписывать файл полностью, можно будет записать информацию вместо блока <TT>PADDING</TT>. Обратите внимание на то, что общий размер блока <TT>PADDING</TT> будет на 4 байта больше, так как 4 байта занимает заголовок.</TD></TR>
+<TD>Кодер запишет блок метаданных <TT>PADDING</TT>, указанного размера (в байтах), после блока <TT>STREAMINFO</TT>. Ключ <TT>--no-padding</TT> указывает, что блок <TT>PADDING</TT> не нужен (значение по умолчанию). Этот блок полезен, если вы собираетесь добавить тэг в файл позже. Вместо того, чтобы переписывать файл полностью, можно будет записать информацию вместо блока <TT>PADDING</TT>. Обратите внимание на то, что общий размер блока <TT>PADDING</TT> будет на 4 байта больше, так как 4 байта занимает заголовок.</TD></TR>
 
 <TR><TD><TT>-T ПОЛЕ=ЗНАЧЕНИЕ</TT>, <TT>--tag=ПОЛЕ=ЗНАЧЕНИЕ</TT></TD>
 <TD>Добавляет комментарии Vorbis, который должен соответствовать спецификации, т.е. ПОЛЕ должно содержать только определенные символы, завершающиеся знаком равенства. При необходимости не забывайте заключать комментарий в кавычки. Эту опцию можно использовать неоднократно для заполнения разных полей комментария. Все указанные значения будут применены ко всем кодируемым файлам.</TD></TR>
@@ -391,6 +417,9 @@
 <TR><TD><TT>--sign={signed|unsigned}</TT></TD>
 <TD>Определяет, должны ли быть сэмплы в файле без заголовка беззнаковые или знаковые (по умолчанию знаковые).</TD></TR>
 
+<TR><TD><TT>--force-aiff-format</TT></TD>
+<TD>Декодер будет записывать в формат AIFF. Эта опция не нужна, если имя выходного файла (указанное с помощью ключа <TT>-o</TT>) заканчиватся на .aiff.</TD></TR>
+
 <TR><TD><TT>--force-raw-format</TT></TD>
 <TD>Воспринимать входной (или выходной при декодировании) файл как поток сэмплов без заголовка вне зависимости от суффикса.</TD></TR>
 </TABLE>
@@ -424,7 +453,7 @@
 
 <P><B><TT>metaflac</TT></B> - это редактор метаданных, работающий из командной строки. Его можно использовать для удаления, вставки и вывода содержимого блоков во .flac файле, а также управления блоком<TT>PADDING</TT>, резервирующим место.</P>
 
-<P>Документация для <B><TT>metaflac</TT></B> сейчас переписывается, поэтому сейчас о возможностях можно узнать, дав команду: <TT>metaflac --help</TT>.
+<P>Документация для <B><TT>metaflac</TT></B> в формате HTML сейчас переписывается, поэтому сейчас о возможностях можно узнать, дав команду <TT>metaflac --help</TT> или ознакомиться со man-страницей.</P>
 
 <A NAME="plugins"><A NAME="xmms_plugin">
 <H3>Плагин для XMMS</H3>
@@ -446,6 +475,20 @@
 
 <P>Отслеживание ошибок ведется на <A HREF="http://sourceforge.net/bugs/?group_id=13478">этой</A> странице проекта, находящейся на SourceForge. Если Вы будете сообщать об ошибке, пожалуйста, оставьте e-mail для контакта.</P>
 
+<P>Ниже перечислены известные ошибки в текущей версии (1.1.0):</P>
+
+<BLOCKQUOTE><UL>
+	<LI>Нет известных ошибок.</LI>
+</UL></BLOCKQUOTE>
+
+<P>В версии 1.0.4 были следующие значимые ошибки:</P>
+
+<BLOCKQUOTE><UL>
+	<LI>Во всех декодерах до этой версии включительно была ошибка не позволяющая правильно пропускать неизвестные блоки метаданных. Файл FLAC, созданный кодером flac 1.1.0 и содержащий блок метаданных CUESHEET, не будет воспроизводиться более ранними версиями декодеров.</LI>
+	<LI>В <B><TT>metaflac</TT></B> была ошибка, возникающая при импортировании комметария в формате Vorbis, которая могла привести к повреждению файла FLAC.</LI>
+</UL></BLOCKQUOTE>
+
+
 <A NAME="monkey">
 <H3>monkey</H3>