Skip to content

Commit 29e330a

Browse files
author
Sebastiano Merlino
committed
Added new sections to the documentation
Created a section describing the public structures. Added subsection to the compilation instruction regarding optional compilation arguments.
1 parent ff78839 commit 29e330a

File tree

1 file changed

+43
-6
lines changed

1 file changed

+43
-6
lines changed

doc/libhttpserver.md

Lines changed: 43 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -76,16 +76,53 @@ Additionally, clients can specify resource limits on the overall
7676
number of connections, number of connections per IP address and memory
7777
used per connection to avoid resource exhaustion.
7878

79+
Requirements
80+
============
81+
g++ >= 4.1.2
82+
libmicrohttpd >= 0.9.7
83+
doxygen (if you want to build code reference)
84+
7985
Compilation
8086
===========
8187
libhttpserver uses the standard system where the usual build process
8288
involves running
83-
> ./bootstrap
84-
> mkdir build
85-
> cd build
86-
> ../configure
87-
> make
88-
> make install
89+
> ./bootstrap
90+
> mkdir build
91+
> cd build
92+
> ../configure
93+
> make
94+
> make install
95+
96+
Optional parameters to configure script
97+
---------------------------------------
98+
A complete list of parameters can be obtained running 'configure --help'.
99+
Here are listed the libhttpserver specific options (the canonical configure options are also supported).
100+
101+
* --enable-same-directory-build: enable to compile in the same directory. This is heavily discouraged. (def=no)
102+
* --enable-debug: enable debug data generation (def=no)
103+
* --enable-cpp11: enable c++11 std classes (def=no)
104+
* --disable-doxygen-doc: don't generate any doxygen documentation
105+
* --disable-doxygen-dot: don't generate graphics for doxygen documentation
106+
* --disable-doxygen-man: don't generate doxygen manual pages
107+
* --enable-doxygen-rtf: generate doxygen RTF documentation
108+
* --enable-doxygen-xml: generate doxygen XML documentation
109+
* --enable-doxygen-chm: generate doxygen compressed HTML help documentation
110+
* --enable-doxygen-chi: generate doxygen seperate compressed HTML help index file
111+
* --disable-doxygen-html: don't generate doxygen plain HTML documentation
112+
* --enable-doxygen-ps: generate doxygen PostScript documentation
113+
* --enable-doxygen-pdf: generate doxygen PDF documentation
114+
115+
Constants
116+
=========
117+
W.I.P.
118+
119+
Structures and classes type definition
120+
======================================
121+
* http_resource (CPP class): Represents the resource associated with a specific http endpoint.
122+
* http_request (CPP class): Represents the request received by the resource that process it.
123+
* http_response (CPP class): Represents the response sent by the server once the resource finished its work.
124+
* event_supplier (CPP class): Represents a class that supplies events to the webserver. It can be used to trigger the internal select of it.
125+
* webserver (CPP class): Represents the daemon listening on a socket for HTTP traffic.
89126

90127
GNU Lesser General Public License
91128
=================================

0 commit comments

Comments
 (0)