couchdb-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From nsla...@apache.org
Subject [2/2] couchdb commit: updated refs/heads/master to 1d860fb
Date Thu, 30 Oct 2014 16:18:05 GMT
Moved DEVELOPERS to README-DEV


Project: http://git-wip-us.apache.org/repos/asf/couchdb/repo
Commit: http://git-wip-us.apache.org/repos/asf/couchdb/commit/1d860fb3
Tree: http://git-wip-us.apache.org/repos/asf/couchdb/tree/1d860fb3
Diff: http://git-wip-us.apache.org/repos/asf/couchdb/diff/1d860fb3

Branch: refs/heads/master
Commit: 1d860fb34aaade3aac2319a3f5ea8e4b1c596ea1
Parents: 243eae9
Author: Noah Slater <Noah Slater nslater@apache.org>
Authored: Thu Oct 30 17:17:47 2014 +0100
Committer: Noah Slater <Noah Slater nslater@apache.org>
Committed: Thu Oct 30 17:17:47 2014 +0100

----------------------------------------------------------------------
 DEVELOPERS | 200 --------------------------------------------------------
 README-DEV | 200 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 200 insertions(+), 200 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/couchdb/blob/1d860fb3/DEVELOPERS
----------------------------------------------------------------------
diff --git a/DEVELOPERS b/DEVELOPERS
deleted file mode 100644
index 94bb683..0000000
--- a/DEVELOPERS
+++ /dev/null
@@ -1,200 +0,0 @@
-Apache CouchDB DEVELOPERS
-=========================
-
-Before you start here, read `INSTALL.Unix` (or `INSTALL.Windows`) and
-follow the setup instructions including the installation of all the
-listed dependencies for your system.
-
-Only follow these instructions if you are building from a source checkout.
-
-If you're unsure what this means, ignore this document.
-
-Dependencies
-------------
-
-You will need the following installed:
-
- * Rebar (>=2.5.0)        (https://github.com/rebar/rebar)
-
-You may also need:
-
- * Sphinx                 (http://sphinx.pocoo.org/)
- * LaTex                  (http://www.latex-project.org/)
- * GNU Texinfo            (http://www.gnu.org/software/texinfo/)
- * GNU help2man           (http://www.gnu.org/software/help2man/)
- * GnuPG                  (http://www.gnupg.org/)
- * md5sum                 (http://www.microbrew.org/tools/md5sha1sum/)
- * sha1sum                (http://www.microbrew.org/tools/md5sha1sum/)
-
-The first of these optional dependencies are required for building the
-documentation. The last three are needed to build releases.
-
-You will need these optional dependencies installed if:
-
- * You are working on the documentation, or
- * You are preparing a distribution archive
-
-However, you do not need them if:
-
- * You are building from a distribution archive, or
- * You don't care about building the documentation
-
-
-Here is a list of *optional* dependencies for various operating systems.
-Installation will be easiest, when you install them all.
-
-Debian-based (inc. Ubuntu) Systems
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    sudo apt-get install help2man
-    sudo apt-get install python-sphinx
-    sudo apt-get install texlive-latex-base
-    sudo apt-get install texlive-latex-recommended
-    sudo apt-get install texlive-latex-extra
-    sudo apt-get install texlive-fonts-recommended
-    sudo apt-get install texinfo
-    sudo apt-get install gnupg
-
-Gentoo-based Systems
-~~~~~~~~~~~~~~~~~~~~
-
-    sudo emerge texinfo
-    sudo emerge gnupg
-    sudo emerge coreutils
-    sudo emerge pkgconfig
-    sudo emerge help2man
-    sudo USE=latex emerge sphinx
-
-RedHat-based (Fedora, Centos, RHEL) Systems
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-    sudo yum install help2man
-    sudo yum install python-sphinx
-    sudo yum install python-docutils
-    sudo yum install python-pygments
-    sudo yum install texlive-latex
-    sudo yum install texlive-latex-fonts
-    sudo yum install texinfo
-    sudo yum install gnupg
-
-Mac OS X
-~~~~~~~~
-
-Install Homebrew, if you do not have it already:
-
-    https://github.com/mxcl/homebrew
-
-Unless you want to install the optional dependencies, skip to the next section.
-
-Install what else we can with Homebrew:
-
-    brew install help2man
-    brew install gnupg
-    brew install md5sha1sum
-
-If you don't already have pip installed, install it:
-
-    sudo easy_install pip
-
-Now, install the required Python packages:
-
-    sudo pip install sphinx
-    sudo pip install docutils
-    sudo pip install pygments
-
-Download MaxTeX from here:
-
-    http://www.tug.org/mactex/
-
-Follow the instructions to get a working LaTeX install on your system.
-
-Windows
-~~~~~~~
-
-Follow the instructions in INSTALL.Windows and build all components from
-source, using the same Visual C++ compiler and runtime.
-
-Configuring
------------
-
-Configure the source by running:
-
-    ./configure
-
-If you intend to run the test suites:
-
-    ./configure -c
-
-If you want to build it into different destination than `/usr/local`.
-
-    ./configure --prefix=/<your directory path>
-
-Testing
--------
-
-Check the test suite by running:
-
-    make check
-
-Generate a coverage report by running:
-
-    make cover
-
-Please report any problems to the developer's mailing list.
-
-Testing a cluster
------------------
-
-We use Docker (https://docker.io) to safely run a local three node
-cluster all inside a single docker container.
-
-Assuming you have Docker installed and running:
-
-    make docker-image
-
-This will create a docker image (tagged 'couchdb/dev-cluster') capable
-of running a joined three node cluster.
-
-To start it up:
-
-    make docker-start
-
-A three node cluster should now be running (you can now use `docker ps`
-to find the exposed ports of the nodes).
-
-To stop it:
-
-    make docker-stop
-
-Releasing
----------
-
-The release procedure is documented here:
-
-    https://wiki.apache.org/couchdb/Release_Procedure
-
-Unix-like Systems
-~~~~~~~~~~~~~~~~~
-
-Prepare the release artefacts by running:
-
-    make distcheck
-
-You can prepare signed release artefacts by running:
-
-    make distsign
-
-The release artefacts can be found in the root source directory.
-
-Microsoft Windows
-~~~~~~~~~~~~~~~~~
-
-Prepare the release artefacts by running:
-
-    make dist
-
-The release artefacts can be found in the `etc/windows` directory.
-
-Until the build system has been improved, you must make sure that you run this
-command from a clean source checkout. If you do not, your test database and log
-files will be bundled up in the release artefact.

http://git-wip-us.apache.org/repos/asf/couchdb/blob/1d860fb3/README-DEV
----------------------------------------------------------------------
diff --git a/README-DEV b/README-DEV
new file mode 100644
index 0000000..94bb683
--- /dev/null
+++ b/README-DEV
@@ -0,0 +1,200 @@
+Apache CouchDB DEVELOPERS
+=========================
+
+Before you start here, read `INSTALL.Unix` (or `INSTALL.Windows`) and
+follow the setup instructions including the installation of all the
+listed dependencies for your system.
+
+Only follow these instructions if you are building from a source checkout.
+
+If you're unsure what this means, ignore this document.
+
+Dependencies
+------------
+
+You will need the following installed:
+
+ * Rebar (>=2.5.0)        (https://github.com/rebar/rebar)
+
+You may also need:
+
+ * Sphinx                 (http://sphinx.pocoo.org/)
+ * LaTex                  (http://www.latex-project.org/)
+ * GNU Texinfo            (http://www.gnu.org/software/texinfo/)
+ * GNU help2man           (http://www.gnu.org/software/help2man/)
+ * GnuPG                  (http://www.gnupg.org/)
+ * md5sum                 (http://www.microbrew.org/tools/md5sha1sum/)
+ * sha1sum                (http://www.microbrew.org/tools/md5sha1sum/)
+
+The first of these optional dependencies are required for building the
+documentation. The last three are needed to build releases.
+
+You will need these optional dependencies installed if:
+
+ * You are working on the documentation, or
+ * You are preparing a distribution archive
+
+However, you do not need them if:
+
+ * You are building from a distribution archive, or
+ * You don't care about building the documentation
+
+
+Here is a list of *optional* dependencies for various operating systems.
+Installation will be easiest, when you install them all.
+
+Debian-based (inc. Ubuntu) Systems
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    sudo apt-get install help2man
+    sudo apt-get install python-sphinx
+    sudo apt-get install texlive-latex-base
+    sudo apt-get install texlive-latex-recommended
+    sudo apt-get install texlive-latex-extra
+    sudo apt-get install texlive-fonts-recommended
+    sudo apt-get install texinfo
+    sudo apt-get install gnupg
+
+Gentoo-based Systems
+~~~~~~~~~~~~~~~~~~~~
+
+    sudo emerge texinfo
+    sudo emerge gnupg
+    sudo emerge coreutils
+    sudo emerge pkgconfig
+    sudo emerge help2man
+    sudo USE=latex emerge sphinx
+
+RedHat-based (Fedora, Centos, RHEL) Systems
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    sudo yum install help2man
+    sudo yum install python-sphinx
+    sudo yum install python-docutils
+    sudo yum install python-pygments
+    sudo yum install texlive-latex
+    sudo yum install texlive-latex-fonts
+    sudo yum install texinfo
+    sudo yum install gnupg
+
+Mac OS X
+~~~~~~~~
+
+Install Homebrew, if you do not have it already:
+
+    https://github.com/mxcl/homebrew
+
+Unless you want to install the optional dependencies, skip to the next section.
+
+Install what else we can with Homebrew:
+
+    brew install help2man
+    brew install gnupg
+    brew install md5sha1sum
+
+If you don't already have pip installed, install it:
+
+    sudo easy_install pip
+
+Now, install the required Python packages:
+
+    sudo pip install sphinx
+    sudo pip install docutils
+    sudo pip install pygments
+
+Download MaxTeX from here:
+
+    http://www.tug.org/mactex/
+
+Follow the instructions to get a working LaTeX install on your system.
+
+Windows
+~~~~~~~
+
+Follow the instructions in INSTALL.Windows and build all components from
+source, using the same Visual C++ compiler and runtime.
+
+Configuring
+-----------
+
+Configure the source by running:
+
+    ./configure
+
+If you intend to run the test suites:
+
+    ./configure -c
+
+If you want to build it into different destination than `/usr/local`.
+
+    ./configure --prefix=/<your directory path>
+
+Testing
+-------
+
+Check the test suite by running:
+
+    make check
+
+Generate a coverage report by running:
+
+    make cover
+
+Please report any problems to the developer's mailing list.
+
+Testing a cluster
+-----------------
+
+We use Docker (https://docker.io) to safely run a local three node
+cluster all inside a single docker container.
+
+Assuming you have Docker installed and running:
+
+    make docker-image
+
+This will create a docker image (tagged 'couchdb/dev-cluster') capable
+of running a joined three node cluster.
+
+To start it up:
+
+    make docker-start
+
+A three node cluster should now be running (you can now use `docker ps`
+to find the exposed ports of the nodes).
+
+To stop it:
+
+    make docker-stop
+
+Releasing
+---------
+
+The release procedure is documented here:
+
+    https://wiki.apache.org/couchdb/Release_Procedure
+
+Unix-like Systems
+~~~~~~~~~~~~~~~~~
+
+Prepare the release artefacts by running:
+
+    make distcheck
+
+You can prepare signed release artefacts by running:
+
+    make distsign
+
+The release artefacts can be found in the root source directory.
+
+Microsoft Windows
+~~~~~~~~~~~~~~~~~
+
+Prepare the release artefacts by running:
+
+    make dist
+
+The release artefacts can be found in the `etc/windows` directory.
+
+Until the build system has been improved, you must make sure that you run this
+command from a clean source checkout. If you do not, your test database and log
+files will be bundled up in the release artefact.


Mime
View raw message