Navigation Menu

Skip to content

Commit

Permalink
doc: add server section
Browse files Browse the repository at this point in the history
  • Loading branch information
kou committed Aug 8, 2012
1 parent 36287f0 commit f123c73
Show file tree
Hide file tree
Showing 7 changed files with 101 additions and 0 deletions.
1 change: 1 addition & 0 deletions doc/source/index.txt
Expand Up @@ -20,6 +20,7 @@ groonga documentation
tutorial
suggest
geolocation_search
server
reference
spec
limitations
Expand Down
12 changes: 12 additions & 0 deletions doc/source/server.txt
@@ -0,0 +1,12 @@
.. -*- rst -*-
.. highlightlang:: none

Server
======

.. toctree::
:maxdepth: 2

server/gqtp
server/http
16 changes: 16 additions & 0 deletions doc/source/server/gqtp.txt
@@ -0,0 +1,16 @@
.. -*- rst -*-
.. highlightlang:: none

GQTP
====

TODO

See :doc:`/reference/executable/groonga`.

..
.. toctree::
:maxdepth: 2
gqtp/groonga
29 changes: 29 additions & 0 deletions doc/source/server/http.txt
@@ -0,0 +1,29 @@
.. -*- rst -*-
.. highlightlang:: none

HTTP
====

Groonga provides two HTTP server implementations.

* :doc:`http/groonga`
* :doc:`http/groonga-httpd`

:doc:`http/groonga` is a simple implemntation. It is fast but doesn't
have many HTTP features. It is convenient to try groonga because it
requires just a few command line options to run.

:doc:`http/groonga-httpd` is a `nginx <http://nginx.org/>`_ based
implementation. Is is also fast and has full HTTP features.

.. note::

:doc:`http/groonga-httpd` is still experimental.

.. toctree::
:maxdepth: 2

http/comparison
http/groonga
http/groonga-httpd
27 changes: 27 additions & 0 deletions doc/source/server/http/comparison.txt
@@ -0,0 +1,27 @@
.. -*- rst -*-
.. highlightlang:: none

Comparison
==========

There are many differences between :doc:`groonga` and
:doc:`groonga-httpd`. Here is a comparison table.

+-----------------------+----------+---------------+
| | groonga | groonga-httpd |
+=======================+==========+===============+
| Performance | o | o |
+-----------------------+----------+---------------+
| Configuration file | optional | required |
+-----------------------+----------+---------------+
| Custom prefix path | x | o |
+-----------------------+----------+---------------+
| Multi databases | x | o |
+-----------------------+----------+---------------+
| Basic authentication | x | o |
+-----------------------+----------+---------------+
| Gzip compression | x | o |
+-----------------------+----------+---------------+
| POST | x | x |
+-----------------------+----------+---------------+
8 changes: 8 additions & 0 deletions doc/source/server/http/groonga-httpd.txt
@@ -0,0 +1,8 @@
.. -*- rst -*-
.. highlightlang:: none

groonga-httpd
=============

TODO
8 changes: 8 additions & 0 deletions doc/source/server/http/groonga.txt
@@ -0,0 +1,8 @@
.. -*- rst -*-
.. highlightlang:: none

groonga
=======

TODO

0 comments on commit f123c73

Please sign in to comment.