git.infodrom.org Git - infodrom/cgilib/blob - readme

   1 Using this Library
   2 ------------------
   3
   4 To use this library you need to include the cgi.h include file with
   5 the following expression into your C programs:
   6
   7    #include <cgi.h>
   8
   9 Additionally you'll have to add the library libcgi.a to the linker,
  10 either by modifying LDFLAGS in your Makefile or by adding `-lcgi' to
  11 the appropriate commandline.
  12
  13
  14 Test Suite
  15 ----------
  16
  17 This library comes with a test suite both to demonstrate its features
  18 and to help you understand how it works.  The respective program is
  19 called cgitest.c.  You can use it as reference implementation for this
  20 CGI library.  It can also be used to debug the library by increasing
  21 its debug level.  Therefore it should be included as source in your
  22 distribution.
  23
  24 If you want to test your forms you can use the following action.
  25
  26    <form action="/cgi-bin/cgitest/listall" method="post">
  27
  28 The /listall target will display all environment variables, all CGI
  29 variables, all HTTP Cookies and refer to all files that were
  30 transmitted.  This way you can test your own implementations quite
  31 easy.
  32
  33
  34 Further Documentation
  35 ---------------------
  36
  37 This section will refer to a number of URLs that document how this
  38 library and used protocols work
  39
  40   The CGI Library
  41
  42     http://www.infodrom.org/projects/cgilib/
  43
  44   HTTP Return Codes
  45
  46     http://www.w3.org/Protocols/HTTP/HTRESP.html
  47
  48   HTTP Headers
  49
  50     http://www.w3.org/Protocols/HTTP/Object_Headers.html
  51
  52
  53
  54 Mailing Lists
  55 -------------
  56
  57 A mailing list dedicated to discussions about this library has been
  58 created.  It is meant as a forum for users and developers of the
  59 lightweight CGI library and applications that make use of it.
  60
  61 The lists address is <infodrom-cgilib@lists.infodrom.org>.
  62
  63 To subscribe to this list,
  64
  65  . send a mail to infodrom-cgilib-request@@lists.infodrom.org with the
  66    word "subscribe" as subject, or
  67
  68  . send a mail to majordomo@@lists.infodrom.org with the body of
  69    "subscribe infodrom-cgilib".
  70
  71 The list is publicly archived at
  72 <http://lists.infodrom.org/infodrom-cgilib/>.
  73
  74 A second mailing list exists as infodrom-cgilib-cvs on the same host.
  75 Only CVS messages and differences are distributed there.  Whenever new
  76 code is added to the CGI library, »cvs« generates a mail from these
  77 changes which will be sent to this particular list.  Discussions
  78 continue to take place on the first list.
  79
  80
  81 Feedback
  82 --------
  83
  84 If you have additions, questions or improvements please don't hesitate
  85 to contact either the mailing list or me personally.
  86
  87 Infodrom Oldenburg
  88 Martin Schulze
  89 joey@infodrom.org