<commit_before>How To Start with MonetDB
=========================

.. This document is written in reStructuredText (see
   http://docutils.sourceforge.net/ for more information).
   Use ``rst2html.py`` to convert this file to HTML.

This document helps you compile and install the MonetDB suite from
scratch on Unix-like systems (this includes of course Linux, but also
MacOS X and Cygwin).  This document is meant to be used when you want
to compile and install from Mercurial source.  When you use the prepared tar
balls, some of the steps described here should be skipped.

In case you prefer installing a pre-compiled binary distribution,
please check out `the binary distribution`__.

This document assumes that you are planning on compiling and
installing MonetDB on a Unix-like system (e.g., Linux, IRIX, Solaris,
AIX, Mac OS X/Darwin, or CYGWIN).  For compilation and installation on
a native Windows system (NT, 2000, XP) see the instructions in the
file `../buildtools/doc/windowsbuild.rst`__.

__ http://dev.monetdb.org/downloads/
__ Windows-Installation.html

The Suite
---------

The following are the most important parts of the MonetDB software suite:

buildtools
	Tools used only for building the other parts of the suite.
	These tools are only needed when building from Mercurial.  When
	building from the source distribution (i.e. the tar balls),
	you do not need this.

common
	Fundamental libraries used in the other parts of the suite.

clients
	Libraries and programs to communicate with the server(s) that
	are part of the suite.

monetdb5
	The MAL-based server.  This can be used with and is
	recommended for SQL.

sql
	The SQL front-end built on top of MonetDB5.


Prerequisites
-------------

Mercurial
	You only need this if you are building directly from our version
	control system.  If you start with the source distribution from `our
	download page`__ you don't need Mercurial.

	You need to have a working Mercurial (hg) and clone the main
	repository from: http://dev.monetdb.org/hg

Python
	MonetDB uses Python (version 2.0.0 or better) during
	configuration of the software.  See http://www.python.org/ for
	more information.  (It must be admitted, version 2.0.0 is
	ancient and has not recently been tested, we currently use
	2.6 and newer.)

autoconf/automake/libtool
	MonetDB uses GNU autoconf__ (>= 2.60) and automake__ (>= 1.10)
	during the Bootstrap_ phase, and libtool__ (>= 1.5) during the
	Make_ phase.  autoconf and automake are not needed when you
	start with the source distribution.

standard software development tools
	To compile MonetDB, you also need to have the following
	standard software development tools installed and ready for
	use on you system:

	- a C compiler (e.g. GNU's ``gcc``);
	- GNU ``make`` (``gmake``) (native ``make`` on, e.g., IRIX and Solaris
	  usually don't work).<commit_msg>merging heads<commit_after>How To Start with MonetDB
=========================

.. This document is written in reStructuredText (see
   http://docutils.sourceforge.net/ for more information).
   Use ``rst2html.py`` to convert this file to HTML.

This document helps you compile and install the MonetDB suite from
scratch on Unix-like systems (this includes of course Linux, but also
MacOS X and Cygwin).  This document is meant to be used when you want
to compile and install from Mercurial source.  When you use the prepared tar
balls, some of the steps described here should be skipped.

In case you prefer installing a pre-compiled binary distribution,
please check out `the binary distribution`__.

This document assumes that you are planning on compiling and
installing MonetDB on a Unix-like system (e.g., Linux, IRIX, Solaris,
AIX, Mac OS X/Darwin, or CYGWIN).  For compilation and installation on
a native Windows system (NT, 2000, XP) see the instructions in the
file `../buildtools/doc/windowsbuild.rst`__.

__ http://dev.monetdb.org/downloads/
__ Windows-Installation.html

The Suite
---------

The following are the most important parts of the MonetDB software suite:

buildtools
	Tools used only for building the other parts of the suite.
	These tools are only needed when building from Mercurial.  When
	building from the source distribution (i.e. the tar balls),
	you do not need this.

common
	Fundamental libraries used in the other parts of the suite.

clients
	Libraries and programs to communicate with the server(s) that
	are part of the suite.

monetdb5
	The MAL-based server.  This can be used with and is
	recommended for SQL.

sql
	The SQL front-end built on top of MonetDB5.


Prerequisites
-------------

Mercurial
	You only need this if you are building directly from our version
	control system.  If you start with the source distribution from `our
	download page`__ you don't need Mercurial.

	You need to have a working Mercurial (hg) and clone the main
	repository from: http://dev.monetdb.org/hg

Python
	MonetDB uses Python (version 2.0.0 or better) during
	configuration of the software.  See http://www.python.org/ for
	more information.  (It must be admitted, version 2.0.0 is
	ancient and has not recently been tested, we currently use
	2.6 and newer.)

autoconf/automake/libtool
	MonetDB uses GNU autoconf__ (>= 2.60) and automake__ (>= 1.10)
	during the Bootstrap_ phase, and libtool__ (>= 1.5) during the
	Make_ phase.  autoconf and automake are not needed when you
	start with the source distribution.

iconv
	A macrofile `iconv.m4` is expected in `/usr/share/aclocal/`.
	On Ubuntu, you can search with `apt-file` what provides these
	files:

	$ apt-file search iconv.m4
	gettext: /usr/share/aclocal/iconv.m4
	gnulib: /usr/share/gnulib/m4/iconv.m4

	The .m4 that usually works is in gettext. Simply run,

	$ sudo apt-get install gettext

standard software development tools
	To compile MonetDB, you also need to have the following
	standard software development tools installed and ready for
	use on you system:

	- a C compiler (e.g. GNU's ``gcc``);
	- GNU ``make`` (``gmake``) (native ``make`` on, e.g., IRIX and Solaris
	  usually don't work).
{'fraction_non_alphanumeric': 0.0797881145505711, 'fraction_numerical': 0.008607846383049164, 'mean_word_length': 3.822027134876297, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 9, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3570896', 'n_tokens_mistral': 1840, 'n_tokens_neox': 1744, 'n_words': 852}