Updated Russian man page. Thanks to ITriskTI for translation.

doc/ru/aria2c.1

@@ -1,10 +1,10 @@
 .\" t
 .\"     Title: aria2c
-.\"    Author: Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
+.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\"      Date: 05/21/2011
+.\"      Date: 06/21/2011
 .\"    Manual: Aria2 Manual
-.\"    Source: Aria2 1.11.2
+.\"    Source: Aria2 1.12.0
 .\"  Language: English
 .\"
 .\"*******************************************************************
@@ -12,7 +12,7 @@
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH ARIA2C 1 05/21/2011 "Aria2 1\&.11\&.2" "Руководство по Aria2"
+.TH ARIA2C 1 06/21/2011 "Aria2 1\&.12\&.0" "Руководство по Aria2"
 .ie  \n(.g .ds Aq \(aq
 .el       .ds Aq '
 .\" -----------------------------------------------------------------
@@ -33,7 +33,7 @@
 .\" * MAIN CONTENT STARTS HERE *
 .\" -----------------------------------------------------------------
 .SH НАЗВАНИЕ
-aria2c \- Ультра быстрая утилита загрузки
+aria2c \- сверхбыстрая утилита загрузки
 .SH СИНТАКСИС
 .sp
 aria2c [\fIПАРАМЕТРЫ\fP] [\fIURI\fP | \fIMAGNET\-ССЫЛКА\fP | \fITORRENT\-ФАЙЛ\fP |
@@ -47,7 +47,7 @@ HTTP(S), FTP, BitTorrent и Metalink\&. Для загрузки файла, aria
 HTTP(S)/FTP и BitTorrent одновременно, пока данные загружаются по
 HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent\-рой\&. Используя
 контрольные суммы блока данных для Metalink, aria2 автоматически проверяет
-куски данных, которые загружаются по BitTorrent\&.
+части данных, которые загружаются по BitTorrent\&.
 .SH ПАРАМЕТРЫ
 .SS "Основные параметры"
 .PP
@@ -340,6 +340,23 @@ IP\-адреса\&.
 умолчанию: \fI5\fP
 .RE
 .PP
+\fB\-\-stream\-piece\-selector\fP=SELECTOR
+.RS 4
+Укажите алгоритм выбора блока, который используется в
+HTTP/FTP\-загрузке\&. Блок \- означает сегмент фиксированной длины, который
+загружается параллельно, в  разделенной на части, загрузке\&. Если задано
+\fIdefault\fP, то aria2 выберет блок так, чтобы это уменьшило количество
+установленных подключений\&. Это разумное поведение по умолчанию, поскольку
+установка подключения очень затратная операция\&. Если задано \fIinorder\fP, то
+aria2 выберет блок, который имеет минимальный индекс\&. Index=0 означает
+первый из файла\&. Это будет полезно при просмотре фильма, в то время как он
+загружается\&.  Параметр \fB\-\-enable\-http\-pipelining\fP может быть полезен для
+снижения накладных расходов при повторном подключении\&. Обратите внимание,
+что aria2 принимает на обработку параметр \fB\-\-min\-split\-size\fP, так что
+необходимо будет указать разумное значение параметра
+\fB\-\-min\-split\-size\fP\&. По умолчанию: \fIdefault\fP
+.RE
+.PP
 \fB\-t\fP, \fB\-\-timeout\fP=SEC
 .RS 4
 Задать время ожидания в секундах\&. По умолчанию: \fI60\fP
@@ -1067,6 +1084,12 @@ aria2 использует один из них\&. Используйте пар
 умолчанию: \fIfalse\fP
 .RE
 .PP
+\fB\-\-pause\fP[=\fItrue\fP|\fIfalse\fP]
+.RS 4
+Приостановка загрузки после добавления\&. Этот параметр действенен только,
+когда задан \fB\-\-enable\-rpc\fP=\fItrue\fP\&. По умолчанию: \fIfalse\fP
+.RE
+.PP
 \fB\-\-rpc\-listen\-all\fP[=\fItrue\fP|\fIfalse\fP]
 .RS 4
 Слушать входящие JSON\-RPC/XML\-RPC запросы на всех сетевых
@@ -1221,14 +1244,15 @@ Content\-Disposition\&. Если контрольный файл существ
 предварительное резервирование места для файла перед началом загрузки\&. Это
 может продолжаться некоторое время, в зависимости от размера файла\&. Если
 вы используете новые файловые системы, наподобие ext4 (с поддержкой
-экстентов), btrfs или xfs, тогда лучше выбрать \fIfalloc\fP\&. Так как они
+экстентов), btrfs, xfs или NTFS (только сборка MinGW) тогда лучше выбрать
-резервируют место под большие (на несколько Гигабайт) файлы почти
+\fIfalloc\fP\&. Так как они резервируют место под большие (на несколько
-мгновенно\&. Не используйте \fIfalloc\fP вместе с наследными файловыми
+Гигабайт) файлы почти мгновенно\&. Не используйте \fIfalloc\fP вместе с
-системами, такими как ext3 потому, что это будет продолжаться почти столько
+наследными файловыми системами, такими как ext3 и FAT32, потому что это
-же времени, как и \fIprealloc\fP, а также полностью заблокирует aria2, пока не
+будет продолжаться почти столько же времени, как и \fIprealloc\fP, а также
-окончится резервирование места\&. \fIfalloc\fP может быть недоступным, если
+полностью заблокирует aria2, пока не закончится резервирование
-ваша система не содержит функцию \fBposix_fallocate\fP()\&. Возможные значения:
+места\&. \fIfalloc\fP может быть недоступным, если ваша система не содержит
-\fInone\fP, \fIprealloc\fP, \fIfalloc\fP\&. По умолчанию: \fIprealloc\fP
+функцию \fBposix_fallocate\fP()\&. Возможные значения: \fInone\fP, \fIprealloc\fP,
+\fIfalloc\fP\&. По умолчанию: \fIprealloc\fP
 .RE
 .PP
 \fB\-\-human\-readable\fP[=\fItrue\fP|\fIfalse\fP]
@@ -1457,7 +1481,9 @@ IP\-адрес (например, 192.168.0.12), имя хоста (наприм
 передать этот выходной файл aria2c с параметром \fB\-i\fP при
 перезапуске\&. Обратите внимание, что загрузки добавленные через RPC\-методы
 \fBaria2\&.addTorrent\fP, \fBaria2\&.addMetalink\fP и чьи метаданные не могут быть
-сохранены как файл, не будут сохраняться\&.
+сохранены как файл, не будут сохраняться\&. Загрузки удаленные с
+использованием \fBaria2\&.remove\fP и \fBaria2\&.forceRemove\fP не будут
+сохранены\&.
 .RE
 .PP
 \fB\-\-stop\fP=SEC
@@ -1466,6 +1492,12 @@ IP\-адрес (например, 192.168.0.12), имя хоста (наприм
 \fI0\fP, эта возможность будет отключена\&. По умолчанию: \fI0\fP
 .RE
 .PP
+\fB\-\-truncate\-console\-readout\fP[=\fItrue\fP|\fIfalse\fP]
+.RS 4
+Укорачивать консольный вывод, чтобы он поместился в одну строку\&. По
+умолчанию: \fItrue\fP
+.RE
+.PP
 \fB\-v\fP, \fB\-\-version\fP
 .RS 4
 Вывести номер версии, информацию об авторских правах, конфигурации и
@@ -3053,6 +3085,30 @@ URI\&. Эти дополнительные строки должны начин
 \fBmetalink\-base\-uri\fP
 .RE
 .sp
+.RS 4
+.ie  n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fBpause\fP
+.RE
+.sp
+.RS 4
+.ie  n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+
+\fBstream\-piece\-selector\fP
+.RE
+.sp
 Эти параметры имеют точно такой же смысл, что параметры командной строки, но
 это применимо только к URI, к которым они принадлежат\&. Обратите внимание,
 что параметры во входном файле не должны иметь префикс "\-\-"\&.
@@ -3544,8 +3600,8 @@ BitTorrent\-трекером\&.
 все значения\&. Это полезно, если вы хотите использовать определенные
 параметры, чтобы исключить множество пересылок\&. Например,
 \fBaria2\&.tellStatus\fP("1", ["gid", "status"]) возвратит \fIgid\fP и
-\fIstatus\fP\&. Ответ имеет тип структура и содержит следующие поля\&. Поля
+\fIstatus\fP\&. Ответ имеет тип структура и содержит следующие поля\&. Поле
-имеют тип строка\&.
+имеет тип строка\&.
 .PP
 gid
 .RS 4
@@ -4497,6 +4553,85 @@ URI, если одинаковые URI существуют в загрузке,
 .nr an-break-flag 1
 .br
 .ps +1
+\fBaria2.getGlobalStat ()\fP
+.RS 4
+.sp
+Этот метод возвращает глобальную статистику по скорости загрузки и скорости
+отдачи\&. Ответ имеет тип структура и содержит следующие поля\&. Поле имеет
+тип строка\&.
+.PP
+downloadSpeed
+.RS 4
+Общая скорости загрузки (байт/сек)\&.
+.RE
+.PP
+uploadSpeed
+.RS 4
+Общая скорости отдачи (байт/сек)\&.
+.RE
+.PP
+numActive
+.RS 4
+Количество активных загрузок\&.
+.RE
+.PP
+numWaiting
+.RS 4
+Количество ожидающих загрузок\&.
+.RE
+.PP
+numStopped
+.RS 4
+Количество остановленных загрузок\&.
+.RE
+.sp
+.if  n \{\
+.RS 4
+.\}
+.nf
+>>> import urllib2, json
+>>> from pprint import pprint
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
+\&.\&.\&.                       \*(Aqmethod\*(Aq:\*(Aqaria2\&.getGlobalStat\*(Aq})
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
+>>> pprint(json\&.loads(c\&.read()))
+{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq,
+ u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq,
+ u\*(Aqresult\*(Aq: {u\*(AqdownloadSpeed\*(Aq: u\*(Aq21846\*(Aq,
+             u\*(AqnumActive\*(Aq: u\*(Aq2\*(Aq,
+             u\*(AqnumStopped\*(Aq: u\*(Aq0\*(Aq,
+             u\*(AqnumWaiting\*(Aq: u\*(Aq0\*(Aq,
+             u\*(AquploadSpeed\*(Aq: u\*(Aq0\*(Aq}}
+.fi
+.if  n \{\
+.RE
+.\}
+.sp
+.if  n \{\
+.RS 4
+.\}
+.nf
+>>> import xmlrpclib
+>>> from pprint import pprint
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
+>>> r = s\&.aria2\&.getGlobalStat()
+>>> pprint(r)
+{\*(AqdownloadSpeed\*(Aq: \*(Aq23136\*(Aq,
+ \*(AqnumActive\*(Aq: \*(Aq2\*(Aq,
+ \*(AqnumStopped\*(Aq: \*(Aq0\*(Aq,
+ \*(AqnumWaiting\*(Aq: \*(Aq0\*(Aq,
+ \*(AquploadSpeed\*(Aq: \*(Aq0\*(Aq}
+.fi
+.if  n \{\
+.RE
+.\}
+.RE
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
 \fBaria2.purgeDownloadResult ()\fP
 .RS 4
 .sp
@@ -6144,14 +6279,8 @@ General Public License во всех отношениях для всего ис
 это\&. Если вы не хотите сделать это, удалите это заявление об исключении из
 вашей версии\&. Если вы удалите это заявление об исключении из всех исходных
 файлов в программе, то удалить его и здесь\&.
-.SH АВТОР
-.PP
-\fBTatsuhiro Tsujikawa\fP <\&t\-tujikawa@users\&.sourceforge\&.net\&>
-.RS 4
-Автор.
-.RE
 
 .SH "АВТОР ПЕРЕВОДА"
 ITriskTI <ITriskTI@gmail.com>
-.SH "ПРИМЕЧАНИЕ
+.SH "ПРИМЕЧАНИЕ"
 Эта страница руководства может содержать не обязательно самую последнюю информацию. Если есть некоторые противоречия между этой страницей руководства и фактическим программным обеспечением, пожалуйста, обращайтесь к английской версии страницы руководства.