summaryrefslogtreecommitdiffstats
path: root/libcsoap
diff options
context:
space:
mode:
Diffstat (limited to 'libcsoap')
-rw-r--r--libcsoap/soap-server.h77
1 files changed, 70 insertions, 7 deletions
diff --git a/libcsoap/soap-server.h b/libcsoap/soap-server.h
index 8cad6ff..4a850a8 100644
--- a/libcsoap/soap-server.h
+++ b/libcsoap/soap-server.h
@@ -1,5 +1,5 @@
/******************************************************************
- * $Id: soap-server.h,v 1.20 2006/12/10 19:21:06 m0gg Exp $
+ * $Id: soap-server.h,v 1.21 2006/12/11 08:13:19 m0gg Exp $
*
* CSOAP Project: A SOAP client/server library in C
* Copyright (C) 2003 Ferhat Ayaz
@@ -28,21 +28,72 @@
*
* @mainpage Project overview
*
- * @section seq_intro Introduction
+ * @section project_intro_sec Introduction
*
* cSOAP is a client/server SOAP library implemented in pure C. It comes with
- * embedded transport servers for UDP and HTTP (nanohttp). The transferred XML
+ * embedded transport servers for UDP and HTTP (nanoHTTP). The transferred XML
* structures are handled by libxml2.
*
- * @section seq_features Features
+ * @section project_features_sec Features
*
+ * - @subpage soap_page
* - different transport services
- * - @ref nanohttp_page (HTTP including SSL)
+ * - @subpage nanohttp_page (HTTP including SSL)
* - client/server UDP transport service (multicast)
* - attachments via MIME
* - message based security (XML encryption/signation)
* - automatic generation of WS-Inspection
*
+ * @section howto_sec HOWTOs and coding examples
+ *
+ * - @ref nanohttp_client_page
+ * - @ref nanohttp_server_page
+ * - @ref nanohttp_mime_page
+ * - @ref csoap_client_page
+ * - @ref csoap_server_page
+ * - @ref csoap_mime_page
+ *
+ * @section help_sec How to help
+ *
+ * The development of cSOAP highly depends on your input! If you are trying
+ * cSOAP let us know what you think of it (do you miss certain features?). Even
+ * if you decide not to use it, please let us know why.
+ *
+ * @section projects_sec Projects that use cSOAP
+ *
+ * @subsection CompLearn (http://complearn.org/)
+ *
+ * CompLear is a suite of simple-to-use utilities that you can use to apply
+ * compression techniques to the process of discovering and learning patterns.
+ *
+ * @section downloads_sec Downloads
+ *
+ * @subsection Download stable release
+ *
+ * A stable release is a tested version of cSOAP. Download this package if you
+ * want to use it in your productive projects.
+ *
+ * Download source code of libsoap-1.1.0.tar.gz:
+ * http://prdownloads.sourceforge.net/csoap/libsoap-1.1.0.tar.gz?download
+ *
+ * @subsection Download latest snapshot (nightly build)
+ *
+ * Latest snapshots are build nightly on a detected CVS commit. This is sometimes
+ * not very stable but in some case are snapshots the better choice then the
+ * stable version. This can happen if a very important bug was fixed or a new
+ * feature was introduced. It is recommend to join the mailinglist.
+ *
+ * Download latest snapshot (nightly build):
+ * http://csoap.sourceforge.net/downloads/libsoap-snapshot.tar.gz
+ *
+ * @subsection Checkout from CVS
+ *
+ * Do you want the latest source codes? You want to contribute a patch? Have you
+ * found a bug? Or whatever. You should check out csoap from CVS to play the game
+ * with us csoap developers.
+ *
+ * Web CVS access: http://csoap.cvs.sourceforge.net/csoap/libsoap/
+ *
* @author Ferhat Ayaz
* @author Michael Rans
* @author Matt Campbell
@@ -54,6 +105,19 @@
* @see http://www.libxml.org/
* @see http://www.openssl.org/
* @see http://www.aleksey.com/xmlsec/
+ *
+ */
+
+/** @page soap_page
+ *
+ * T.B.D.
+ *
+ * @section soap_howto_sec HOWTOs and coding examples
+ *
+ * - @ref csoap_client_page
+ * - @ref csoap_server_page
+ * - @ref csoap_mime_page
+ *
*/
/** @page soap_server_page Howto write an SOAP server
@@ -149,8 +213,7 @@
*
* xmlDocFormatDump(stdout, req->env->root->doc, 1);
*
- * err = soap_env_new_with_response(req->env, &res->env);
- * if (err != H_OK)
+ * if ((err = soap_env_new_with_response(req->env, &res->env)) != H_OK)
* {
* printf("soap_env_new_with_response failed (%s)\n", herror_message(err));
* return err;