Document how to disable tests when certain --disable-* flags are used.
authorDan Fandrich <dan@coneharvesters.com>
Tue, 7 Oct 2008 20:28:25 +0000 (20:28 +0000)
committerDan Fandrich <dan@coneharvesters.com>
Tue, 7 Oct 2008 20:28:25 +0000 (20:28 +0000)
docs/INSTALL
tests/README

index 92484ad..9634585 100644 (file)
@@ -770,10 +770,12 @@ REDUCING SIZE
    will not use, here are some other flags that can reduce the size of the
    library:
 
-     --disable-ares (disables support for the ARES DNS library)
+     --disable-ares (disables support for the C-ARES DNS library)
      --disable-cookies (disables support for HTTP cookies)
      --disable-crypto-auth (disables HTTP cryptographic authentication)
      --disable-ipv6 (disables support for IPv6)
+     --disable-manual (disables support for the built-in documentation)
+     --disable-proxy (disables support for HTTP and SOCKS proxies)
      --disable-verbose (eliminates debugging strings and error code strings)
      --enable-hidden-symbols (eliminates unneeded symbols in the shared library)
      --without-libidn (disables support for the libidn DNS library)
@@ -791,11 +793,24 @@ REDUCING SIZE
 
    Using these techniques it is possible to create an HTTP-only shared libcurl
    library for i386 Linux platforms that is only 96 KiB in size (as of libcurl
-   version 7.17.1, using gcc 4.2.2).
+   version pre-7.19.1, using gcc 4.2.2).
 
    You may find that statically linking libcurl to your application will
    result in a lower total size.
 
+   Note that the curl test harness can detect the use of some, but not all, of
+   the --disable statements suggested above. Use will cause tests relying on
+   those features to fail.  The test harness can be manually forced to skip
+   the relevant tests by specifying certain key words on the runtests.pl
+   command line.  Following is a list of appropriate key words:
+
+     --disable-cookies          !cookies
+     --disable-crypto-auth      !HTTP\ Digest\ auth !HTTP\ NTLM\ auth
+                                !HTTP\ proxy\ Digest\ auth
+                                !HTTP\ proxy\ NTLM\ auth
+     --disable-manual           !--manual
+     --disable-proxy            !HTTP\ proxy !SOCKS4 !SOCKS5
+
 
 PORTS
 =====
index 50b5345..ad832b0 100644 (file)
@@ -109,8 +109,7 @@ Code coverage:
   and torture tests to get more full coverage, i.e. do:
 
     make test
-    cd tests
-    make torture-test
+    make test-torture
 
   The graphical tool ggcov can be used to browse the source and create
   coverage reports on *NIX hosts: