This option requires BitTorrent message payload encryption with
arc4. This is a shorthand of --bt-requre-crypto
--bt-min-crypto-level=arc4. If true is given, deny legacy BitTorrent
handshake and only use Obfuscation handshake and always encrypt
message payload. This option defaults to false.
This option excludes seed only downloads when counting concurrent
active downloads (-j option). This means that if -j3 is given and
this option is turned on and 3 downloads are active and one of those
enters seed mode, then it is excluded from active download count (thus
it becomes 2), and the next download waiting in queue gets started.
But be aware that seeding item is still recognized as active download
in RPC method.
sf.net pulled the plug of hosted apps including trac-wiki. The link
to the wiki has not worked for some time now. We submit issue to
sf.net to migrate the wiki content to current sf.net standard wiki.
When the migration is done, we'll add the link to it in the doc.
It shows the number of stopped downloads in the current session and
not capped by --max-download-result option. On the other hand, the
existing numStopped key also shows the number of stopped downloads,
but it is capped by --max-download-result option.
This change changes the behavior of --bt-max-open-files. Previously,
it specifies the maximum number of opened files for each multi-file
download. Since it is more useful to limit the number globally, the
option now specifies the global limit. This change suggests that
aria2.changeOption() method now ignores --bt-max-open-files and
aria2.changeGlobalOption now reads it and dynamically change the
limit.
Also it's not just the `html` target that needs libaria2api generated.
The fix is mighty ackward, as it is not really out-of-tree: libaria2api
still will be but into the srcdir. I settled for this because trying to
do a real include from the build dir is really a mess, either requireing
heavy pre-processing or a custom sphinx Include directive :p
Because we don't require sphinx-doc to build distributed archive, the
man pages are generated when making distribution. And We want to keep
the generated man pages with `make clean` there.
--file-allocation option can now take new value 'trunc'. 'trunc' uses
ftruncate() system call or platform-specific counterpart to truncate a
file to a specified length.
This is because when generating man page, if a word starting '.' is
put in the beginning of the line, it will be treated as macro. This
sounds like docutils bug, but it will not be fixed soon, so we do this
as a workaround.
This will prevent `make clean` in unpacked archive from removing
aria2c.1. We don't want to remove them by `make clean` because to
generate aria2c.1, user has to install Sphinx. That is why we
distribute aria2c.1 in the archive.
Sphinx HTML markups are beautiful, but it uses many asset files, such
as stylesheets, javascripts and images. While it is no problem to
upload them in web site, but distributing and installing them in
individual user have some problems. For example, Sphinx uses same
assets for generated sites, so if many applications uses Sphinx
generated docs and they are installed in the PC, it is huge waste of
the disk space. I'm also not comfortable to copy HTML trees to the
install directory using 'cp -r' command. I seeked other format like
pdf and texi which Sphinx can generate but annoyingly they all convert
'--' into en-dash and there is no workaround to disable it. So I
decided to drop HTML manual from distribution and installation. For
users who want to HTML version manual, see it online:
http://aria2.sourceforge.net/manual/en/html/
$(HTML) is the root directory of html documents and since we don't
remove $(HTML) when re-building htmls, it is useless to use aria2c.rst
as a prerequisites.
The source files for manual pages are placed under doc/manual-src.
The built manual pages are placed under doc/manual.
When installed, manual pages are placed under $(docdir)/manual/.