From 003b1f909d416ab2c869b76176380c5f133bdad4 Mon Sep 17 00:00:00 2001 From: fluffypony Date: Wed, 23 Jul 2014 13:50:29 +0200 Subject: [PATCH] New README --- README | 173 ++++++++++++++++++++++++++++++++++++++++++++++----------- 1 file changed, 141 insertions(+), 32 deletions(-) diff --git a/README b/README index 1ed19f898..a388a6be1 100644 --- a/README +++ b/README @@ -1,48 +1,157 @@ --= Building CryptoNote =- +------ +Monero +------ -On *nix: +Copyright (c) 2014, The Monero Project -Dependencies: GCC 4.7.3 or later, CMake 2.8.6 or later, and Boost 1.53 or later (except 1.54, more details here: http://goo.gl/RrCFmA). -You may download them from: -http://gcc.gnu.org/ -http://www.cmake.org/ -http://www.boost.org/ -Alternatively, it may be possible to install them using a package manager. +--------------------- +Development Resources +--------------------- -To build, change to a directory where this file is located, and run `make'. The resulting executables can be found in build/release/src. +Web: monero.cc +Mail: dev@monero.cc +Github: https://github.com/monero-project/bitmonero +IRC: #monero-dev on Freenode + +------------ +Introduction +------------ + +Monero is a private, secure, untraceable currency. You are your bank, you control your +funds, and nobody can trace your transfers. + +Privacy: Monero uses a cryptographically sound system to allow you to send and receive +funds without your transactions being easily revealed on the blockchain (the ledger of +transactions that everyone has). This ensures that your purchases, receipts, and all +transfers remain absolutely private by default. + +Security: Using the power of a distributed peer-to-peer consensus network, every +transaction on the network is cryptographically secured. Individual wallets have a 24 word +mnemonic that is only displayed once, and can be written down to backup the wallet. Wallet +files are encrypted with a passphrase to ensure they are useless if stolen. + +Untraceability: By taking advantage of ring signatures, a special property of certain +types of cryptography, Monero is able to ensure that transactions are not only +untraceable, but have an optional measure of ambiguity that ensures that transactions +cannot easily be tied back to an individual user or computer. + +------------------ +About this Project +------------------ + +This is the core implementation of Monero. It is open source and completely free to use +without restrictions, except for those specified in the license agreement below. There are +no restrictions on anyone creating an alternative implementation of Monero that uses the +protocol and network in a compatible manner. + +As with many development projects, the repository on Github is considered to be the +"staging" area for the latest changes. Before changes are merged into that master repo, +they are tested by individual developers, as well as contributors who focus on thorough +testing and code reviews. That having been said, the repository should be carefully +considered before using it in a production environment, unless there is a patch in the +repository for a particular show-stopping issue you are experiencing. It is generally +a better idea to use a tagged release for stability. + +Anyone is able to contribute to Monero. If you have a fix or code change, feel free to +submit is as a pull request. In cases where the change is relatively small or does not +affect other parts of the codebase it may be merged in immediately by any one of the +collaborators. On the other hand, if the change is particularly large or complex, it +is expected that it will be discussed at length either well in advance of the pull +request being submitted, or even directly on the pull request. + +------- +License +------- + +Copyright (c) 2014, The Monero Project + +All rights reserved. + +Redistribution and use in source and binary forms, with or without modification, are +permitted provided that the following conditions are met: + +1. Redistributions of source code must retain the above copyright notice, this list of + conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright notice, this list of + conditions and the following disclaimer in the documentation and/or other materials + provided with the distribution. + +3. Neither the name of the copyright holder nor the names of its contributors may be used + to endorse or promote products derived from this software without specific prior + written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY +EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE +COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, +EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR +TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +Parts of the project are originally copyright (c) 2012-2013 The Cryptonote developers + +---------------- +Compiling Monero +---------------- + +On Unix and Linux: + +Dependencies: GCC 4.7.3 or later, CMake 2.8.6 or later, and Boost 1.53 or later (except +1.54, more details here: http://goo.gl/RrCFmA). + +- To build, change to the root of the source code directory, and run 'make'. + +- The resulting executables can be found in build/release/src. Advanced options: -Parallel build: run `make -j' instead of `make'. -Debug build: run `make build-debug'. -Test suite: run `make test-release' to run tests in addition to building. Running `make test-debug' will do the same to the debug version. -Building with Clang: it may be possible to use Clang instead of GCC, but this may not work everywhere. To build, run `export CC=clang CXX=clang++' before running `make'. + +- Parallel build: run 'make -j' instead of 'make'. + +- Debug build: run 'make build-debug'. + +- Test suite: run 'make test-release' to run tests in addition to building. Running + 'make test-debug' will do the same to the debug version. + +- Building with Clang: it may be possible to use Clang instead of GCC, but this may not + work everywhere. To build, run 'export CC=clang CXX=clang++' before running 'make'. + +On OS X: + +The project can be built from scratch by following instructions for Unix and Linux above. + +Alternatively, it can be built in an easier and more automated fashion using Homebrew: + +- Ensure Homebrew is installed, it can be found at http://brew.sh + +- Add the repository: brew tap sammy007/cryptonight + +- Build wallet: brew install --HEAD bitmonero On Windows: -Dependencies: MSVC 2012 or later, CMake 2.8.6 or later, and Boost 1.53 or later. You may download them from: -http://www.microsoft.com/ -http://www.cmake.org/ -http://www.boost.org/ -To build, change to a directory where this file is located, and run this commands: -mkdir build -cd build -cmake -G "Visual Studio 11 Win64" .. +Dependencies: MSVC 2013 or later, CMake 2.8.6 or later, and Boost 1.53 or later. -And then do Build. -Good luck! +- To build, change to the root of the source code directory, and run these commands: + mkdir build + cd build + cmake -G "Visual Studio 11 Win64" + And then do Build. -Build documentation (Doxygen) : -Pequired Packages: -* doxygen -* graphviz (optional) +---------------------- +Building Documentation +---------------------- -From root code directory, execute : +Monero developer documentation uses Doxygen, and is currently a work-in-progress. - doxygen Doxyfile +Dependencies: Doxygen 1.8.0 or later, Graphviz 2.28 or later (optional) -If you have installed *graphviz*, you can also generate in-doc diagrams : +- To build, change to the root of the source code directory, and run 'doxygen Doxyfile' - HAVE_DOT=YES doxygen Doxyfile +- If you have installed Graphviz, you can also generate in-doc diagrams by instead running + 'HAVE_DOT=YES doxygen Doxyfile' -The output will go in **doc/html/** +- The output will be built in doc/html/ \ No newline at end of file