--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.
By default, bash_completion file named aria2c is installed to the
directory $prefix/share/doc/aria2/bash_completion. To change the
install directory of the file, use --with-bashcompletiondir option.
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/.
Removes the unselected files when download is completed in
BitTorrent. To selecting files, use --select-file option. If it is not
used, all files are assumed to be selected. Please use this option
with care because it will actually remove files from your disk.
This option is default to false.
If true is given to --deferred-input option, aria2 does not read all
URIs and options from file specified by -i option at startup, but it
reads one by one when it needs later. This may reduce memory usage if
input file contains a lot of URIs to download. If false is given,
aria2 reads all URIs and options at startup. This option defaults to
false.
