[Groonga-commit] groonga/groonga at c83dd3c [master] doc: suppress abuse of ".. note::" directive

Back to archive index

HAYASHI Kentaro null+****@clear*****
Tue Sep 24 18:32:38 JST 2013


HAYASHI Kentaro	2013-09-24 18:32:38 +0900 (Tue, 24 Sep 2013)

  New Revision: c83dd3c36ef59d29d835262a25258e39a03a2e60
  https://github.com/groonga/groonga/commit/c83dd3c36ef59d29d835262a25258e39a03a2e60

  Message:
    doc: suppress abuse of ".. note::" directive

  Modified files:
    doc/source/server/package.txt

  Modified: doc/source/server/package.txt (+12 -8)
===================================================================
--- doc/source/server/package.txt    2013-09-24 18:31:02 +0900 (13049d1)
+++ doc/source/server/package.txt    2013-09-24 18:32:38 +0900 (f4eca12)
@@ -15,19 +15,23 @@ There are three packages for server use.
 * ``groonga-server-http`` (simple HTTP protocol based server package)
 * ``groonga-server-gqtp`` (:doc:`/spec/gqtp` protocol based server package)
 
-.. note::
+There is the reason why groonga supports not only GQTP but also two HTTP server
+packages. :doc:`/spec/gqtp` - Groonga Query Transfer Protocol is desined to reduce overheads
+and improve performance. But, GQTP is less support of client library than HTTP protocol does.
+As HTTP is matured protocol, you can take advantage of existing tool and there are many client
+library (See `related projects <http://groonga.org/related-projects.html>`_ for details).
+If you use ``groonga-httpd`` package, you can also take benefits of nginx functionality.
+
+We recommend to use ``groonga-server-http`` at first, then if you want to use more 
+fullfilling functionality, use ``groonga-httpd`` package. If you have performance issues which
+is derived from protocol overheads, consider to use ``groonga-server-gqtp``.
+
+ .. note::
 
    There is a conflict between ``groonga-httpd`` and ``groonga-server-http``
    package because of port number.
    See :doc:`/server/http/comparison` if you want to know which package meets your demands.
 
-.. note::
-
-   ``groonga-server-gqtp`` is based on groonga specific protocol (:doc:`/spec/gqtp` - Groonga Query Transfer
-   Protocol). This protocol is designed to reduce overheads and improve performance. The weak
-   point of GQTP is less support of client library than HTTP protocol does.
-
-
 groonga-httpd
 -------------
 
-------------- next part --------------
HTML����������������������������...
Download 



More information about the Groonga-commit mailing list
Back to archive index