瀏覽代碼

2008-12-17 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>

	Updated "How to build" section in README. Mentioned about
	--with-ca-bundle compile option.
	* README
Tatsuhiro Tsujikawa 17 年之前
父節點
當前提交
27a858a504
共有 3 個文件被更改,包括 52 次插入5 次删除
  1. 6 0
      ChangeLog
  2. 24 2
      README
  3. 22 3
      README.html

+ 6 - 0
ChangeLog

@@ -1,3 +1,9 @@
+2008-12-17  Tatsuhiro Tsujikawa  <t-tujikawa@users.sourceforge.net>
+
+	Updated "How to build" section in README. Mentioned about
+	--with-ca-bundle compile option.
+	* README
+
 2008-12-17  Tatsuhiro Tsujikawa  <t-tujikawa@users.sourceforge.net>
 
 	Bump up version number to 1.1.0.

+ 24 - 2
README

@@ -108,14 +108,36 @@ You can use libexpat1-dev instead of libxml2-dev:
 
 * libexpat1-dev    (Required for Metalink support)
 
-The build process is fairly standard way for *nix programs:
+The quickest way to build aria2 is just type following commands:
 
 -------------
 $ ./configure
 $ make
 -------------
 
-The executable is aria2c in src directory.
+The configure script checks available libraries and enables the features
+as much as possible because all the features are enabled by default.
+
+Since 1.1.0, aria2 checks the certificate of HTTPS servers by default.
+If you build with HTTPS support, I recommend to supply the path to the
+CA bundle file. For example, in Debian the path to CA bundle file is
+'/etc/ssl/certs/ca-certificates.crt' (in ca-certificates package). This
+may varies depending on the distributions. You can give it to
+configure script using \--with-ca-bundle option:
+
+-------------------------------------------------------------------
+$ ./configure --with-ca-bundle='/etc/ssl/certs/ca-certificates.crt'
+$ make
+-------------------------------------------------------------------
+
+Without \--with-ca-bundle option, you will encounter the error when
+accessing HTTPS servers because the certificate cannot be verified
+without CA bundle. In such case, you can specify the CA bundle file
+using aria2's \--ca-certificate option.  If you don't have CA bundle
+file installed, then the last resort is disable the certificate
+validation using \--check-certificate=false.
+
+The executable is 'aria2c' in src directory.
 
 aria2 uses CppUnit for automated unit testing. To run run the unit test:
 

+ 22 - 3
README.html

@@ -674,13 +674,32 @@ libexpat1-dev    (Required for Metalink support)
 </p>
 </li>
 </ul></div>
-<div class="para"><p>The build process is fairly standard way for *nix programs:</p></div>
+<div class="para"><p>The quickest way to build aria2 is just type following commands:</p></div>
 <div class="listingblock">
 <div class="content">
 <pre><tt>$ ./configure
 $ make</tt></pre>
 </div></div>
-<div class="para"><p>The executable is aria2c in src directory.</p></div>
+<div class="para"><p>The configure script checks available libraries and enables the features
+as much as possible because all the features are enabled by default.</p></div>
+<div class="para"><p>Since 1.1.0, aria2 checks the certificate of HTTPS servers by default.
+If you build with HTTPS support, I recommend to supply the path to the
+CA bundle file. For example, in Debian the path to CA bundle file is
+<em>/etc/ssl/certs/ca-certificates.crt</em> (in ca-certificates package). This
+may varies depending on the distributions. You can give it to
+configure script using --with-ca-bundle option:</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><tt>$ ./configure --with-ca-bundle='/etc/ssl/certs/ca-certificates.crt'
+$ make</tt></pre>
+</div></div>
+<div class="para"><p>Without --with-ca-bundle option, you will encounter the error when
+accessing HTTPS servers because the certificate cannot be verified
+without CA bundle. In such case, you can specify the CA bundle file
+using aria2's --ca-certificate option.  If you don't have CA bundle
+file installed, then the last resort is disable the certificate
+validation using --check-certificate=false.</p></div>
+<div class="para"><p>The executable is <em>aria2c</em> in src directory.</p></div>
 <div class="para"><p>aria2 uses CppUnit for automated unit testing. To run run the unit test:</p></div>
 <div class="listingblock">
 <div class="content">
@@ -867,7 +886,7 @@ max-upload-limit=40K</tt></pre>
 </div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2008-12-02 01:48:13 JST
+Last updated 2008-12-17 21:33:30 JST
 </div>
 </div>
 </body>