Merge pull request #16 from ITriskTI/master

Fixed some bugs

doc/manual-src/ru/aria2c.rst

@@ -199,9 +199,10 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
 
   .. note::
     
-    Файл netrc считывается только при запуске, если :option:`--no-netrc <-n>` задан как ``false``. Так что если :option:`--no-netrc <-n>` задан как ``true`` при загрузке, то netrc недоступен на
+    Файл netrc считывается только при запуске, если :option:`--no-netrc <-n>` задан
-    протяжении всей сессии. Вы не сможете получить доступ к netrc, даже если
+    как ``false``. Так что если :option:`--no-netrc <-n>` задан как ``true`` при
-    отправите :option:`--no-netrc=false, <-n>` используя
+    загрузке, то netrc недоступен на протяжении всей сессии. Вы не сможете получить
+    доступ к netrc, даже если отправите :option:`--no-netrc=false, <-n>` используя
     :func:`aria2.changeGlobalOption`.
 
 .. option:: --no-proxy=<DOMAINS>
@@ -1022,8 +1023,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
   Если задано ``false``, тогда для всех заданных URI не поддерживается
   возобновление загрузки, или aria2 столкнется с невозможностью
   возобновления загрузки URI ``N``-ое количество раз
-  (значение ``N`` указывается в параметре
+  (значение ``N`` указывается в параметре :option:`--max-resume-failure-tries`,
-  
   то aria2 будет загружать файл с нуля. Смотрите параметр
   :option:`--max-resume-failure-tries`.
   По умолчанию: ``true``
@@ -1151,8 +1151,8 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
 .. option:: --hash-check-only[=true|false]
 
   Если задано ``true``, то после проверки хэша, используя параметр
-  :option:`--check-integrity <-V>`,
+  :option:`--check-integrity <-V>`, загрузка прервётся, в любом
-  загрузка прервётся, в любом случае загрузка завершится.
+  случае загрузка завершится.
   По умолчанию: ``false``
 
 .. option:: --human-readable[=true|false]
@@ -1172,8 +1172,8 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
 
     Если интерфейс имеет несколько адресов, то настоятельно рекомендуется
     указать IP-адрес явно. Смотрите также 
-    :option:`--disable-ipv6`. Если ваша система не имеет :manpage:`getifaddrs(3)`, это параметр не
+    :option:`--disable-ipv6`. Если ваша система не имеет :manpage:`getifaddrs(3)`, это
-    принимает имя интерфейса.
+    параметр не принимает имя интерфейса.
 
 .. option:: --max-download-result=<NUM>
 
@@ -1348,10 +1348,10 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
 .. option:: --save-session=<FILE>
 
   Сохранять ошибочные/незаконченные загрузки в FILE при выходе. Вы можете
-  передать этот выходной файл aria2c с параметром  :option:`--input-file <-i>` при перезапуске. Обратите внимание, что
+  передать этот выходной файл aria2c с параметром  :option:`--input-file <-i>` при
-  загрузки, добавленные через RPC-методы
+  перезапуске. Обратите внимание, что загрузки, добавленные через RPC-методы
-  :func:`aria2.addTorrent`, :func:`aria2.addMetalink`
+  :func:`aria2.addTorrent`, :func:`aria2.addMetalink` и чьи метаданные не могут
-  и чьи метаданные не могут быть сохранены как файл, не будут сохраняться.
+  быть сохранены как файл, не будут сохраняться.
   Загрузки, удаленные с использованием :func:`aria2.remove` и
   :func:`aria2.forceRemove` не будут сохранены.
 
@@ -1395,18 +1395,18 @@ URI, MAGNET-ССЫЛКА, TORRENT-ФАЙЛ, METALINK-ФАЙЛ
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Вы можете перечислить несколько URI в командной строке. Пока вы не указали
-параметр :option:`--force-sequential <-Z>`, все URI должны указывать
+параметр :option:`--force-sequential <-Z>`, все URI должны указывать на один
-на один и тот же файл или загрузка завершиться не удачно.
+и тот же файл или загрузка завершиться не удачно.
 
 Вы можете указать произвольное количество BitTorrent Magnet URI. Обратите
 внимание, что они всегда будут обрабатываться как отдельная
 загрузка. Поддерживаются оба Info Hash (Информация о хэше), как
 закодированный 40 шестнадцатеричными символами, так и закодированный 32
-символами Base32-кодировки. Поддерживаются составные параметры ``tr``. Т.к. в
+символами Base32-кодировки. Поддерживаются составные параметры
-BitTorrent Magnet URI возможно присутствие символа ``&``, то настоятельно
+``tr``. Т.к. в BitTorrent Magnet URI возможно присутствие символа ``&``, то
-рекомендуется всегда заключать URI в одиночные(``'``) или двойные(``"``)
+настоятельно рекомендуется всегда заключать URI в одиночные(``'``) или
-кавычки. Так же настоятельно рекомендуется включить DHT, особенно когда
+двойные(``"``)  кавычки. Так же настоятельно рекомендуется включить DHT,
-параметр ``tr`` не указан. Смотрите
+особенно когда параметр ``tr`` не указан. Смотрите
 http://www.bittorrent.org/beps/bep_0009.html для детальной информации по
 BitTorrent Magnet URI.
 
@@ -1447,7 +1447,7 @@ aria2 предоставляет параметры, в которых указ
 доступны следующие параметры:
 :option:`--on-bt-download-complete`,
 :option:`--on-download-pause`,
-:option:`--on-download-complete`.  
+:option:`--on-download-complete`,
 :option:`--on-download-start`,
 :option:`--on-download-error`,
 :option:`--on-download-stop`.
@@ -1458,11 +1458,10 @@ aria2 передает 3 аргумента указанной команды,
 файлов. Если число файлов больше чем один, то путь к файлу будет для
 первого. Другими словами, это значение параметра path в первой структуре,
 определенный параметр которой имеет значение true (истина), в ответе
-RPC-метода :func:`aria2.getFiles`. Если вы хотите
+RPC-метода :func:`aria2.getFiles`. Если вы хотите получить все пути к
-получить все пути к файлам, то рассмотрите использование
+файлам, то рассмотрите использование JSON-RPC/XML-RPC. Обратите внимание,
-JSON-RPC/XML-RPC. Обратите внимание, что путь к файлу может меняться в
+что путь к файлу может меняться в процессе загрузки по HTTP из-за
-процессе загрузки по HTTP из-за перенаправления или заголовка
+перенаправления или заголовка Content-Disposition.
-Content-Disposition.
 
 Посмотрите пример, как аргументы передаются команде:
 
@@ -1639,15 +1638,15 @@ aria2.conf
 
 По умолчанию, aria2 анализирует ``$HOME/.aria2/aria2.conf`` как
 конфигурационный файл. Вы можете указать путь к конфигурационному файлу в
-параметре :option:`--conf-path`. Если вы не хотите
+параметре :option:`--conf-path`. Если вы не хотите использовать
-использовать конфигурационный файл, используйте параметр
+конфигурационный файл, используйте параметр :option:`--no-conf`.
-:option:`--no-conf`.
 
 Конфигурационный файл - это текстовый файл, содержащий один параметр в
 строке. В каждой строке, вы можете указать пары имя-значение в формате:
 ИМЯ=ЗНАЧЕНИЕ, где имя - это длинный параметр командной строки, без префикса
-``--``. Вы можете использовать тот же синтаксис, что и для параметра командной
+``--``. Вы можете использовать тот же синтаксис, что и для параметра
-строки. Строки начинающиеся с ``#`` рассматриваются как комментарии::
+командной строки. Строки начинающиеся с ``#`` рассматриваются как
+комментарии::
 
   # sample configuration file for aria2c
   listen-port=60000
@@ -1658,18 +1657,18 @@ aria2.conf
 
 
 dht.dat
-~~~~~~~~
+~~~~~~~
 
 By default, the routing table of IPv4 DHT is saved to the path
-``$HOME/.aria2/dht.dat`` and the routing table of IPv6 DHT is saved to
+``$HOME/.aria2/dht.dat`` and the routing table of IPv6 DHT is saved to the
-the path ``$HOME/.aria2/dht6.dat``.
+path ``$HOME/.aria2/dht6.dat``.
 
 Netrc
 ~~~~~
 
 Поддержка Netrc включена по умолчанию для HTTP(S)/FTP. Для отключения
-поддержки netrc, укажите параметр :option:`--no-netrc <-n>`. Ваш файл
+поддержки netrc, укажите параметр :option:`--no-netrc <-n>`. Ваш файл .netrc
-.netrc должен иметь соответствующие права (600).
+должен иметь соответствующие права (600).
 
 Если имя машины (machine) начинается с ``.``, то aria2 выполняет доменное
 сопоставление вместо точного соответствия. Это расширение aria2. Пример
@@ -1681,10 +1680,10 @@ Netrc
 Домен ``aria2.example.org`` сопоставляется с ``.example.org`` и используется
 ``myid`` и ``mypasswd``.
 
-Примеры некоторых доменных сопоставлений: домен ``example.net`` не сопоставим
+Примеры некоторых доменных сопоставлений: домен ``example.net`` не
-с ``.example.org``. Домен ``example.org`` не сопоставим ``.example.org`` из-за
+сопоставим с ``.example.org``. Домен ``example.org`` не сопоставим
-предшествующей ``.``. Если вы хотите соответствия ``example.org``, то точно
+``.example.org`` из-за предшествующей ``.``. Если вы хотите соответствия
-укажите - ``example.org``.
+``example.org``, то точно укажите - ``example.org``.
 
 Контрольный файл
 ~~~~~~~~~~~~~~~~
@@ -1695,8 +1694,8 @@ aria2 использует контрольный файл для отслежи
 ``.aria2``. Например, если file.zip загружаемый файл, тогда контрольный файл
 будет file.zip.aria2. (Существует исключение для этого именования. При
 загрузке торрента с множеством файлов, контрольный файл будет в "корневом
-каталоге" с именем торрента и добавлением ``.aria2``. Имя "корневого каталога"
+каталоге" с именем торрента и добавлением ``.aria2``. Имя "корневого
-- значение ключа "name" в "info" внутри torrent-файла.)
+каталога" - значение ключа "name" в "info" внутри torrent-файла.)
 
 Обычно контрольный файл удаляется после завершения загрузки. Если aria2
 решает, что загрузка не может быть возобновлена (например, когда загружается
@@ -1799,7 +1798,8 @@ URI. Эти дополнительные строки должны начина
   * :option:`max-resume-failure-tries <--max-resume-failure-tries>`
   * :option:`max-tries <-m>`
   * :option:`max-upload-limit <-u>`
-  * :option:`metalink-enable-unique-protocol <--metalink-enable-unique-protocol>`
+  * :option:`metalink-enable-unique-protocol
+    <--metalink-enable-unique-protocol>`
   * :option:`metalink-language <--metalink-language>`
   * :option:`metalink-location <--metalink-location>`
   * :option:`metalink-os <--metalink-os>`
@@ -1845,15 +1845,13 @@ URI. Эти дополнительные строки должны начина
   http://foo/bar
 
 
-Если aria2 выполняется с параметрами ``-i uri.txt -d /tmp``,
+Если aria2 выполняется с параметрами ``-i uri.txt -d /tmp``, а загрузка
-а загрузка происходит с
+происходит с \http://server/file.iso и \http://mirror/file.iso, то
-\http://server/file.iso и \http://mirror/file.iso, то ``file.iso`` сохранится
+``file.iso`` сохранится как ``/iso_images/file.img``. Файл ``bar``
-как ``/iso_images/file.img``. Файл ``bar`` загрузится с http://foo/bar и
+загрузится с http://foo/bar и сохранится как ``/tmp/bar``.
-сохранится как ``/tmp/bar``.
 
 В некоторых случаях, параметр :option:`out <-o>` не имеет никакого
-эффекта. Смотрите примечание по ограничениям параметра 
+эффекта. Смотрите примечание по ограничениям параметра :option:`--out <-o>`.
-:option:`--out <-o>`.
 
 Профиль функционирования сервера
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -1913,17 +1911,18 @@ aria2 обеспечивает JSON-RPC через HTTP и XML-RPC через HT
 имеют одинаковые функции. aria2 также обеспечивает JSON-RPC через
 WebSocket. JSON-RPC через WebSocket использует тот же самый метод сигнатур и
 формат ответа как у JSON-RPC через HTTP, но дополнительно имеет сервер,
-инициирующий уведомления. Смотрите подробности в разделе
+инициирующий уведомления. Смотрите подробности в разделе `JSON-RPC через
-`JSON-RPC через WebSocket`_.
+WebSocket`_.
 
 Путь запроса к JSON-RPC-интерфейсу (для через HTTP и через WebSocket) -
 ``/jsonrpc``. Путь запроса к XML-RPC-интерфейсу - ``/rpc``.
 
-WebSocket URI для JSON-RPC через WebSocket является ``ws://HOST:PORT/jsonrpc``.
+WebSocket URI для JSON-RPC через WebSocket является
+``ws://HOST:PORT/jsonrpc``.
 
-Реализованный JSON-RPC основан на спецификации
+Реализованный JSON-RPC основан на спецификации JSON-RPC 2.0
-JSON-RPC 2.0 <http://jsonrpc.org/specification> и поддерживает HTTP POST и
+<http://jsonrpc.org/specification> и поддерживает HTTP POST и GET
-GET (JSONP). Использование WebSocket как транспорта является начальным
+(JSONP). Использование WebSocket как транспорта является начальным
 расширением aria2.
 
 JSON-RPC-интерфейс не поддерживает уведомления в HTTP, но RPC-сервер будет
@@ -1961,10 +1960,11 @@ GID
   указывать на один и тот же файл. Если вы смешивайте другие URI, указывающие
   на другой файл, то aria2 не сообщит об этом, но и загрузка может неудачно
   завершаться. Параметр *options* имеет тип структура, элементы которой
-  являются парой имя и значение. Смотрите ниже :ref:`rpc_options` для более подробной информации. Если параметр *position* задан
+  являются парой имя и значение. Смотрите ниже :ref:`rpc_options` для более
-  как целое число, начиная с 0, то новая загрузка будет вставлена на позицию
+  подробной информации. Если параметр *position* задан как целое число,
-  *position* в очередь ожидания. Если параметр *position* не задан или больше
+  начиная с 0, то новая загрузка будет вставлена на позицию *position* в
-  чем размер очереди, то загрузка будет добавлена в конец очереди. Этот метод
+  очередь ожидания. Если параметр *position* не задан или больше чем размер
+  очереди, то загрузка будет добавлена в конец очереди. Этот метод
   возвращает GID зарегистрированной загрузки.
   
   **Пример JSON-RPC**
@@ -2294,8 +2294,8 @@ GID
   
   ``errorCode``
     Последний код ошибки, которая произошла при загрузке. Значение имеет тип
-    строки. Коды ошибок определены в разделе `КОДЫ ЗАВЕРШЕНИЯ`_. Это значение доступно только для остановленных/завершенных
+    строки. Коды ошибок определены в разделе `КОДЫ ЗАВЕРШЕНИЯ`_. Это значение доступно
-    загрузок.
+    только для остановленных/завершенных загрузок.
   
   ``followedBy``
     Список с GID, которые сгенерированы в результате запуска этой
@@ -2794,7 +2794,9 @@ GID
   пределами конца очереди, это переместит загрузку в начало или конец очереди
   соответственно. Ответ имеет целочисленный тип и является целевой позицией.
   
-  Например, если GID#1 размещается на позиции 3, ``aria2.changePosition('1', -1, 'POS_CUR')`` изменит его позицию на 2. Дополнительно ``aria2.changePosition('1', 0, 'POS_SET')`` изменит его позицию на 0 (начало очереди).
+  Например, если GID#1 размещается на позиции 3, ``aria2.changePosition('1', -1, 'POS_CUR')``
+  изменит его позицию на 2. Дополнительно ``aria2.changePosition('1', 0, 'POS_SET')``
+  изменит его позицию на 0 (начало очереди).
   
   **Пример JSON-RPC**
   
@@ -3325,9 +3327,8 @@ GID
 Параметры
 ~~~~~~~~~
 
-Такие же параметры, что доступны для 
+Такие же параметры, что доступны для :option:`--input-file <-i>`. Смотрите
-:option:`--input-file <-i>`. Смотрите подраздел `Входной файл`_ для полного
+подраздел `Входной файл`_ для полного списка параметров.
-списка параметров.
 
 В структуре, имя элемента - это имя параметра (без ``--``), а значение
 элемента - аргумент в виде строки.
@@ -3355,11 +3356,10 @@ GID
   </struct>
 
 
-Параметры :option:`header <--header>` и :option:`index-out <-O>`
+Параметры :option:`header <--header>` и :option:`index-out <-O>` допускают
-допускают нескольких определений в
+нескольких определений в командной строке. Поскольку имя должно быть
-командной строке. Поскольку имя должно быть уникальным в структуре
+уникальным в структуре (многие реализации библиотеки XML-RPC использует хэш
-(многие реализации библиотеки XML-RPC использует хэш или словарь
+или словарь для структуры), одной строки не достаточно. Для преодоления этой
-для структуры), одной строки не достаточно. Для преодоления этой
 ситуации, они могут взять массив в качестве значения, а также строку.
 
 Пример JSON-RPC
@@ -3404,16 +3404,14 @@ JSON-RPC используя HTTP GET
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 JSON-RPC-интерфейс также поддерживает запрос через HTTP GET. Схема
-кодирования в GET параметров основанных на
+кодирования в GET параметров основанных на JSON-RPC через HTTP Спецификация
-JSON-RPC
+[2008-1-15(RC1)]. Кодирование параметров через GET следующие::
-через HTTP Спецификация [2008-1-15(RC1)]. Кодирование параметров через GET
-следующие::
 
   /jsonrpc?method=METHOD_NAME&id=ID&params=BASE64_ENCODED_PARAMS
 
 
-``method`` и ``id`` всегда обрабатывается как JSON-строка и они должны быть в
+``method`` и ``id`` всегда обрабатывается как JSON-строка и они должны быть
-кодировке UTF-8.
+в кодировке UTF-8.
 
 Например, закодированная строка aria2.tellStatus('3') с id='foo' выглядит
 так::
@@ -3435,8 +3433,8 @@ JSON-RPC-интерфейс поддерживает JSONP. Вы можете о
 
 
 Для пакетного запроса, параметры ``method`` и ``id`` не должны быть
-указаны. Полный запрос должен быть определен в параметре ``params``. Например,
+указаны. Полный запрос должен быть определен в параметре
-пакетный запрос::
+``params``. Например, пакетный запрос::
 
   [{'jsonrpc':'2.0', 'id':'qwer', 'method':'aria2.getVersion'},
    {'jsonrpc':'2.0', 'id':'asdf', 'method':'aria2.tellActive'}]
@@ -3522,8 +3520,8 @@ params, является данными, которые переносит эт
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Следующий Ruby-скрипт добавляет ``http://localhost/aria2.tar.bz2``, с
-параметром :option:`--dir=/downloads, <-d>` в aria2c, которая
+параметром :option:`--dir=/downloads, <-d>` в aria2c, которая работает на
-работает на localhost и отображает ответ:
+localhost и отображает ответ:
 
 .. code-block:: ruby
 
@@ -3752,8 +3750,8 @@ params, является данными, которые переносит эт
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Для указания выходного имени файла в BitTorrent-загрузках, вам нужно узнать
-индекс файла в torrent-файле, используя параметр 
+индекс файла в torrent-файле, используя параметр :option:`--show-files
-:option:`--show-files <-S>`. Например, результат выглядит следующим образом::
+<-S>`. Например, результат выглядит следующим образом::
 
   idx|path/length
   ===+======================
@@ -3831,8 +3829,8 @@ params, является данными, которые переносит эт
 Добавить и удалить URI трекера
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Удалить все URI анонса трекеров, описанных в file.torrent и
+Удалить все URI анонса трекеров, описанных в file.torrent и взамен
-взамен использовать ``http://tracker1/announce`` и ``http://tracker2/announce``:
+использовать ``http://tracker1/announce`` и ``http://tracker2/announce``:
 
 .. code-block:: console
 

doc/manual-src/ru/index.rst

@@ -3,10 +3,10 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Aria2 Manual
+Руководство по Aria2
-============
+====================
 
-Contents:
+Содержание:
 
 .. toctree::
    :maxdepth: 3