neo/curl/packages/Win32/cygwin/README

   1 Curl is a tool for transferring files with URL syntax, supporting
   2   FTP, FTPS, HTTP, HTTPS, GOPHER, TELNET, DICT, FILE and LDAP.
   3   Curl supports HTTPS certificates, HTTP POST, HTTP PUT,
   4   FTP uploading, kerberos, HTTP form based upload, proxies,
   5   cookies, user+password authentication, file transfer resume,
   6   http proxy tunneling and a busload of other useful tricks.
   7
   8 See /usr/doc/curl-$(VERSION)/FEATURES for more info.
   9
  10
  11 Dependencies:
  12   - Cygwin
  13   - OpenSSL 0.9.6b-2+ (*)
  14
  15   (*) cURL can be built without SSL support, see below for details
  16
  17
  18 Canonical Homepage and Downloads:
  19   http://curl.haxx.se/
  20   http://curl.haxx.se/download.html
  21
  22
  23 Cygwin specific source files (a .README template and a Makefile
  24   for building binary tarballs) are maintained in the upstream
  25   CVS at: <srctop>/packages/Win32/cygwin/
  26
  27
  28 Build Instructions (to recompile from the cygwin source tarball):
  29   ---STANDARD (with SSL) RELEASE---
  30   Download the source (either the official release or the cygwin version),
  31   unpack it (done for you if using setup.exe), then:
  32
  33   $ ./configure --prefix=/usr
  34   $ make
  35   $ make test    # optional
  36   $ make install # (*)
  37
  38   (*) LibTool 1.4.2 had a bug related to cygwin's use of ".exe" extensions,
  39       such that "make install" blew up at curl.exe. See this URL for details:
  40         http://mail.gnu.org/pipermail/libtool/2001-September/005549.html
  41       The copy of ltmain.sh that is distributed with cURL includes this patch.
  42
  43   As of curl 7.9.1, the official source compiles (under Cygwin) and tests
  44     100% cleanly OOTB (Out Of The Box)
  45
  46   ---NO SSL RELEASE---
  47   Same as standard, except for the configure step, which changes to:
  48
  49   $ ./configure --prefix=/usr --without-ssl
  50
  51   NOTE: the standard release is what is available via Cygwin's setup.exe;
  52     the no-ssl release is only available from the curl website
  53
  54
  55 Packaging Instructions:
  56   ---BINARY---
  57   Compile cleanly as described above, then:
  58
  59   $ make cygwinbin CYGBUILD=n
  60
  61   where n is the cygwin release number (e.g. the "1" in curl-7.9-1),
  62   and "CYGBUILD=n" is optional (n defaults to 1 if not specified)
  63
  64   Assuming everything worked, you'll find your binary tarballs in
  65    $(buildtop)/packages/Win32/cygwin/
  66
  67   ---SOURCE---
  68   1. download & unpack the pristine source
  69   2. rename the source dir to add the "-$(REL)" suffix, e.g.:
  70      $ mv curl-7.9 curl-7.9-1
  71   3. unpack the pristine source once more, so you'll end up
  72      with 2 directories: "curl-7.9" and "curl-7.9-1" in this example
  73   3. add a CYGWIN-PATCHES directory, and add this readme to it
  74      $ cd curl-7.9-1; mkdir CYGWIN-PATCHES
  75      $ cp packages/Win32/cygwin/README CYGWIN-PATCHES/curl-7.9-1.README
  76   4. if applicable, document any changes in the README file
  77   5. create a patch which, when applied
  78      (using `patch -p1 < curl-7.9-$(REL).patch`)
  79      will remove any changes you've made to the pristine source:
  80      $ cd ..
  81      $ diff -Nrup curl-7.9-1 curl-7.9 > curl-7.9-1.patch
  82      and then move it into the CYGWIN-PATCHES directory
  83      $ mv curl-7.9-1.patch curl-7.9-1/CYGWIN-PATCHES
  84   6. pack the new source dir into a tar.bz2 file:
  85      $ tar cfj curl-7.9-1-src.tar.bz2 curl-7.9-1
  86
  87   ---SETUP.HINT---
  88   sdesc: "a client that groks URLs"
  89   ldesc: "Curl is a tool for transferring files with URL syntax,
  90   supporting FTP, FTPS, HTTP, HTTPS, GOPHER, TELNET, DICT, FILE
  91   and LDAP. Curl supports HTTPS certificates, HTTP POST, HTTP PUT,
  92   FTP uploading, kerberos, HTTP form based upload, proxies,
  93   cookies, user+password authentication, file transfer resume,
  94   http proxy tunneling and a busload of other useful tricks."
  95   category: Web Libs
  96   requires: cygwin openssl
  97
  98
  99 Cygwin port maintained by:
 100   Kevin Roth <kproth @ users . sourceforge . net>
 101   Questions about cURL should be directed to curl-users@cool.haxx.se.
 102   Questions about this cygwin package go to cygwin@cygwin.com.
 103