rroonga 5.0.4-x86-mingw32 → 5.0.5-x86-mingw32

data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/build/unix_cmake.txt

@@ -0,0 +1,94 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+How to build Groonga at the repository by CMake on GNU/Linux or Unix
+====================================================================
+
+This document describes how to build Groonga at the repository by
+CMake on GNU/Linux or Unix.
+
+Unix is \*BSD, Solaris, OS X and so on.
+
+If you want to use Windows for developing Groonga, see
+:doc:`windows_cmake`.
+
+You can't choose this way if you want to release Groonga. Groonga
+release system is only supported by GNU Autotools build. See
+:doc:`unix_autotools` about GNU Autotools build.
+
+Install depended software
+-------------------------
+
+TODO
+
+  * `CMake <http://www.cmake.org/>`_
+  * `Ruby <https://www.ruby-lang.org/>`_
+  * `Git <https://git-scm.com/>`_
+  * `Cutter <http://cutter.sourceforge.net/>`_
+  * ...
+
+Checkout Groonga from the repository
+------------------------------------
+
+Users use released source archive. But developers must build Groonga
+at the repository. Because source code in the repository is the
+latest.
+
+The Groonga repository is hosted on `GitHub
+<https://github.com/groonga/groonga>`_. Checkout the latest source
+code from the repository::
+
+  % git clone --recursive git@github.com:groonga/groonga.git
+
+Run ``cmake``
+-------------
+
+You need to create ``Makefile`` for your environment.
+
+You can custom your build configuration by passing options to
+``cmake``.
+
+Here are recommended ``cmake`` options for developers::
+
+  % cmake . -DCMAKE_INSTALL_PREFIX=/tmp/local -DGRN_WITH_DEBUG=on -DGRN_WITH_MRUBY=on
+
+Here are descriptions of these options:
+
+``-DCMAKE_INSTALL_PREFIX=/tmp/local``
+
+    It specifies that you install your Groonga into temporary
+    directory. You can do "clean install" by removing
+    ``/tmp/local`` directory. It'll be useful for debugging install.
+
+``-DGRN_WITH_DEBUG=on``
+
+    It enables debug options for C/C++ compiler. It's useful for
+    debugging on debugger such as GDB and LLDB.
+
+``-DGRN_WITH_MRUBY=on``
+
+    It enables mruby support. The feature isn't enabled by default
+    but developers should enable the feature.
+
+Run ``make``
+------------
+
+Now, you can build Groonga.
+
+Here is a recommended ``make`` command line for developers::
+
+  % make -j8 > /dev/null
+
+``-j8`` decreases build time. It enables parallel build. If you have 8
+or more CPU cores, you can increase ``8`` to decreases more build
+time.
+
+You can just see only warning and error messages by ``>
+/dev/null``. Developers shouldn't add new warnings and errors in new
+commit.
+
+See also
+--------
+
+  * :doc:`/contribution/development/test`

data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/build/windows_cmake.txt

@@ -0,0 +1,93 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+How to build Groonga at the repository by CMake on Windows
+==========================================================
+
+This document describes how to build Groonga at the repository by
+CMake on Windows.
+
+If you want to use GNU/Linux or Unix for developing Groonga, see
+:doc:`unix_cmake`.
+
+Unix is \*BSD, Solaris, OS X and so on.
+
+Install depended software
+-------------------------
+
+  * `Microsoft Visual Studio Express 2013 for Windows Desktop
+    <https://www.visualstudio.com/downloads/#d-2013-express>`_
+  * `CMake <http://www.cmake.org/>`_
+  * `Ruby <https://www.ruby-lang.org/>`_
+
+    * `RubyInstaller for Windows <http://rubyinstaller.org/>`_ is
+      recommended.
+
+  * `Git <https://git-scm.com/>`_: There are some Git clients for
+    Windows. For example:
+
+    * `The official Git package <https://git-scm.com/download/win>`_
+    * `TortoiseGit <https://tortoisegit.org/>`_
+    * `Git for Windows <https://git-for-windows.github.io/>`_
+    * `GitHub Desktop <https://desktop.github.com/>`_
+
+Checkout Groonga from the repository
+------------------------------------
+
+Users use released source archive. But developers must build Groonga
+at the repository. Because source code in the repository is the
+latest.
+
+The Groonga repository is hosted on `GitHub
+<https://github.com/groonga/groonga>`_. Checkout the latest source
+code from the repository::
+
+  > git clone --recursive git@github.com:groonga/groonga.git
+
+Run ``cmake``
+-------------
+
+You need to create ``Makefile`` for your environment.
+
+You can custom your build configuration by passing options to
+``cmake``.
+
+You must to pass ``-G`` option. Here are available ``-G`` value:
+
+  * ``"Visual Studio 12 2013"``: For 32bit build.
+  * ``"Visual Studio 12 2013 Win64"``: For 64bit build.
+
+Here are recommended ``cmake`` options for developers::
+
+  > cmake . -G "Visual Studio 12 2013 Win64" -DCMAKE_INSTALL_PREFIX=C:\Groonga -DGRN_WITH_MRUBY=on
+
+Here are descriptions of these options:
+
+``-G "Visual Studio 12 2013 Win64"``
+
+``-DCMAKE_INSTALL_PREFIX=C:\Groonga``
+
+    It specifies that you install your Groonga into ``C:\\Groonga``
+    folder.
+
+``-DGRN_WITH_MRUBY=on``
+
+    It enables mruby support. The feature isn't enabled by default
+    but developers should enable the feature.
+
+Build Groonga
+-------------
+
+Now, you can build Groonga.
+
+You can use Visual Studio or ``cmake --build``.
+
+Here is a command line to build Groonga by ``cmake --build``::
+
+  > cmake --build . --config Debug
+
+See also
+--------
+
+  * :doc:`/contribution/development/test`

data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/release.txt

@@ -240,6 +240,9 @@ make update-poコマンドの実行により更新した各種.poファイルを
 
     % make tag
 
+.. note::
+   タグを打った後にconfigureを実行することで、ドキュメント生成時のバージョン番号に反映されます。
+
 リリース用アーカイブファイルの作成
 ----------------------------------
 
@@ -312,10 +315,10 @@ make build PALALLEL=yesコマンドを実行すると、ディストリビュー
 
 現在サポートされているのは以下の通りです。
 
-* wheezy i386/amd64
-* precise i386/amd64
-* trusty i386/amd64
-* utopic i386/amd64
+* Debian GNU/Linux
+
+  * wheezy i386/amd64
+  * jessie i386/amd64
 
 正常にビルドが終了すると$GROONGA_CLONE_DIR/packages/apt/repositories配下に.debパッケージが生成されます。
 
@@ -349,7 +352,7 @@ make build PALALLEL=yesコマンドを実行すると、ディストリビュー
 
 * centos-5 i386/x86_64
 * centos-6 i386/x86_64
-* fedora-17 i386/x86_64
+* centos-7 i386/x86_64
 
 ビルドが正常終了すると$GROONGA_CLONE_DIR/packages/yum/repositories配下にRPMパッケージが生成されます。
 
@@ -357,8 +360,8 @@ make build PALALLEL=yesコマンドを実行すると、ディストリビュー
 * repositories/yum/centos/5/x86_64/Packages
 * repositories/yum/centos/6/i386/Packages
 * repositories/yum/centos/6/x86_64/Packages
-* repositories/yum/fedora/17/i386/Packages
-* repositories/yum/fedora/17/x86_64/Packages
+* repositories/yum/centos/7/i386/Packages
+* repositories/yum/centos/7/x86_64/Packages
 
 リリース対象のRPMに署名を行うには以下のコマンドを実行します。::
 
@@ -533,6 +536,12 @@ Ubuntu向けのパッケージのアップロードには以下のコマンド
     % cd packages/ubuntu
     % make upload
 
+現在サポートされているのは以下の通りです。
+
+* precise i386/amd64
+* trusty i386/amd64
+* vivid i386/amd64
+
 アップロードが正常終了すると、launchpad.net上でビルドが実行され、ビルド結果がメールで通知されます。ビルドに成功すると、リリース対象のパッケージがlaunchpad.netのGroongaチームのPPAへと反映されます。公開されているパッケージは以下のURLで確認できます。
 
   https://launchpad.net/~groonga/+archive/ubuntu/ppa

data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/repository.txt

@@ -5,8 +5,12 @@
 Repository
 ==========
 
-There is `the repository of groonga on GitHub <https://github.com/groonga/groonga>`_. If you want to check-out groonga, type the below command::
+There is `the repository of Groonga on GitHub
+<https://github.com/groonga/groonga>`_. If you want to check-out
+Groonga, type the below command::
 
-  % git clone --recursive git://github.com/groonga/groonga.git
+  % git clone --recursive https://github.com/groonga/groonga.git
 
-There is `the list of related projects of groonga <https://github.com/groonga>`_ (grntest, fluent-plugin-groonga and so on).
+There is `the list of related projects of Groonga
+<https://github.com/groonga>`_ (grntest, fluent-plugin-groonga and so
+on).

data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/test.txt

@@ -5,6 +5,10 @@
 テスト方法
 ===========
 
+TODO: Write in English.
+
+TODO: Write about ``test/command/run-test.sh``.
+
 テスト環境の構築
 ----------------
 

data/vendor/local/share/doc/groonga/ja/html/_sources/install/centos.txt

@@ -170,9 +170,9 @@ Install required packages to build Groonga::
 
 Download source::
 
-  % wget http://packages.groonga.org/source/groonga/groonga-5.0.5.tar.gz
-  % tar xvzf groonga-5.0.5.tar.gz
-  % cd groonga-5.0.5
+  % wget http://packages.groonga.org/source/groonga/groonga-5.0.7.tar.gz
+  % tar xvzf groonga-5.0.7.tar.gz
+  % cd groonga-5.0.7
 
 Configure (see :ref:`source-configure` about ``configure`` options)::
 

data/vendor/local/share/doc/groonga/ja/html/_sources/install/debian.txt

@@ -66,7 +66,7 @@ Install groonga-normalizer-mysql package::
 jessie
 ------
 
-.. versionadded:: 5.0.5
+.. versionadded:: 5.0.3
 
 Add the Groonga apt repository.
 
@@ -123,9 +123,9 @@ Install required packages to build Groonga::
 
 Download source::
 
-  % wget http://packages.groonga.org/source/groonga/groonga-5.0.5.tar.gz
-  % tar xvzf groonga-5.0.5.tar.gz
-  % cd groonga-5.0.5
+  % wget http://packages.groonga.org/source/groonga/groonga-5.0.7.tar.gz
+  % tar xvzf groonga-5.0.7.tar.gz
+  % cd groonga-5.0.7
 
 Configure (see :ref:`source-configure` about ``configure`` options)::
 

data/vendor/local/share/doc/groonga/ja/html/_sources/install/fedora.txt

@@ -80,9 +80,9 @@ Install required packages to build Groonga::
 
 Download source::
 
-  % wget http://packages.groonga.org/source/groonga/groonga-5.0.5.tar.gz
-  % tar xvzf groonga-5.0.5.tar.gz
-  % cd groonga-5.0.5
+  % wget http://packages.groonga.org/source/groonga/groonga-5.0.7.tar.gz
+  % tar xvzf groonga-5.0.7.tar.gz
+  % cd groonga-5.0.7
 
 Configure (see :ref:`source-configure` about ``configure`` options)::
 

data/vendor/local/share/doc/groonga/ja/html/_sources/install/mac_os_x.txt

@@ -39,9 +39,9 @@ Install `Xcode <https://developer.apple.com/xcode/>`_.
 
 Download source::
 
-  % curl -O http://packages.groonga.org/source/groonga/groonga-5.0.5.tar.gz
-  % tar xvzf groonga-5.0.5.tar.gz
-  % cd groonga-5.0.5
+  % curl -O http://packages.groonga.org/source/groonga/groonga-5.0.7.tar.gz
+  % tar xvzf groonga-5.0.7.tar.gz
+  % cd groonga-5.0.7
 
 Configure (see :ref:`source-configure` about ``configure`` options)::
 

data/vendor/local/share/doc/groonga/ja/html/_sources/install/others.txt

@@ -74,9 +74,9 @@ Build from source
 Groonga uses GNU build system. So the following is the simplest build
 steps::
 
-  % wget http://packages.groonga.org/source/groonga/groonga-5.0.5.tar.gz
-  % tar xvzf groonga-5.0.5.tar.gz
-  % cd groonga-5.0.5
+  % wget http://packages.groonga.org/source/groonga/groonga-5.0.7.tar.gz
+  % tar xvzf groonga-5.0.7.tar.gz
+  % cd groonga-5.0.7
   % ./configure
   % make
   % sudo make install
@@ -157,7 +157,7 @@ Here is an example that Shift_JIS is used as the default encoding::
 ++++++++++++++++++++++++++++++++++++++++++++
 
 Specifies the default match escalation threshold. See
-:ref:`match-escalation-threshold` about match
+:ref:`select-match-escalation-threshold` about match
 escalation threshold. -1 means that match operation never escalate.
 
 The default is 0.

data/vendor/local/share/doc/groonga/ja/html/_sources/install/solaris.txt

@@ -17,9 +17,9 @@ Install required packages to build Groonga::
 
 Download source::
 
-  % wget http://packages.groonga.org/source/groonga/groonga-5.0.5.tar.gz
-  % gtar xvzf groonga-5.0.5.tar.gz
-  % cd groonga-5.0.5
+  % wget http://packages.groonga.org/source/groonga/groonga-5.0.7.tar.gz
+  % gtar xvzf groonga-5.0.7.tar.gz
+  % cd groonga-5.0.7
 
 Configure with ``CFLAGS="-m64" CXXFLAGS="-m64"`` variables. They are
 needed for building 64-bit version. To build 32-bit version, just

data/vendor/local/share/doc/groonga/ja/html/_sources/install/ubuntu.txt

@@ -24,7 +24,6 @@ Here are supported Ubuntu versions:
 
   * 12.04 LTS Precise Pangolin
   * 14.04 LTS Trusty Tahr
-  * 14.10 Utopic Unicorn
   * 15.04 Vivid Vervet
 
 Enable the universe repository to install Groonga::
@@ -82,9 +81,9 @@ Install required packages to build Groonga::
 
 Download source::
 
-  % wget http://packages.groonga.org/source/groonga/groonga-5.0.5.tar.gz
-  % tar xvzf groonga-5.0.5.tar.gz
-  % cd groonga-5.0.5
+  % wget http://packages.groonga.org/source/groonga/groonga-5.0.7.tar.gz
+  % tar xvzf groonga-5.0.7.tar.gz
+  % cd groonga-5.0.7
 
 Configure (see :ref:`source-configure` about ``configure`` options)::
 

data/vendor/local/share/doc/groonga/ja/html/_sources/install/windows.txt

@@ -21,14 +21,14 @@ Installer
 For 32-bit environment, download x86 executable binary from
 packages.groonga.org:
 
-  * http://packages.groonga.org/windows/groonga/groonga-5.0.5-x86.exe
+  * http://packages.groonga.org/windows/groonga/groonga-5.0.7-x86.exe
 
 Then run it.
 
 For 64-bit environment, download x64 executable binary from
 packages.goronga.org:
 
-  * http://packages.groonga.org/windows/groonga/groonga-5.0.5-x64.exe
+  * http://packages.groonga.org/windows/groonga/groonga-5.0.7-x64.exe
 
 Then run it.
 
@@ -41,14 +41,14 @@ zip
 For 32-bit environment, download x86 zip archive from
 packages.groonga.org:
 
-  * http://packages.groonga.org/windows/groonga/groonga-5.0.5-x86.zip
+  * http://packages.groonga.org/windows/groonga/groonga-5.0.7-x86.zip
 
 Then extract it.
 
 For 64-bit environment, download x64 zip archive from
 packages.groonga.org:
 
-  * http://packages.groonga.org/windows/groonga/groonga-5.0.5-x64.zip
+  * http://packages.groonga.org/windows/groonga/groonga-5.0.7-x64.zip
 
 Then extract it.
 
@@ -66,27 +66,27 @@ Windows. Here are required tools:
 
 Download zipped source from packages.groonga.org:
 
-  * http://packages.groonga.org/source/groonga/groonga-5.0.5.zip
+  * http://packages.groonga.org/source/groonga/groonga-5.0.7.zip
 
 Then extract it.
 
 Move to the Groonga's source folder::
 
-  > cd c:\Users\%USERNAME%\Downloads\groonga-5.0.5
+  > cd c:\Users\%USERNAME%\Downloads\groonga-5.0.7
 
 Configure by ``cmake``. The following commnad line is for 64-bit
 version. To build 32-bit version, use ``-G "Visual Studio 12 2013"``
 parameter instead::
 
-  groonga-5.0.5> cmake . -G "Visual Studio 12 2013 Win64" -DCMAKE_INSTALL_PREFIX=C:\Groonga
+  groonga-5.0.7> cmake . -G "Visual Studio 12 2013 Win64" -DCMAKE_INSTALL_PREFIX=C:\Groonga
 
 Build::
 
-  groonga-5.0.5> cmake --build . --config Release
+  groonga-5.0.7> cmake --build . --config Release
 
 Install::
 
-  groonga-5.0.5> cmake --build . --config Release --target Install
+  groonga-5.0.7> cmake --build . --config Release --target Install
 
 After the above steps, :doc:`/reference/executables/groonga` is found at
 ``c:\Groonga\bin\groonga.exe``.