# The PROJECT_NAME tag is a single word (or a sequence of words surrounded
# by quotes) that should identify the project.
-PROJECT_NAME = Bitcoin
+PROJECT_NAME = Novacoin
# The PROJECT_NUMBER tag can be used to enter a project or revision number.
# This could be handy for archiving the generated documentation or
# exceed 55 pixels and the maximum width should not exceed 200 pixels.
# Doxygen will copy the logo to the output directory.
-PROJECT_LOGO = doc/bitcoin_logo_doxygen.png
+PROJECT_LOGO = doc/novacoin_logo_doxygen.png
# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute)
# base path where the generated documentation will be put.
Copyright (c) 2009-2012 Bitcoin Developers
+Copyright (c) 2013 NovaCoin Developers
Distributed under the MIT/X11 software license, see the accompanying
file license.txt or http://www.opensource.org/licenses/mit-license.php.
This product includes software developed by the OpenSSL Project for use in
software written by Thomas Bernard.
-See readme-qt.rst for instructions on building Bitcoin QT, the
+See readme-qt.rst for instructions on building NovaCoin QT, the
graphical user interface.
WINDOWS BUILD NOTES
mkdir miniupnpc
cp *.h miniupnpc/
-Bitcoin
+NovaCoin
-------
DOS prompt:
-cd \bitcoin\src
+cd \novacoin\src
mingw32-make -f makefile.mingw
-strip bitcoind.exe
+strip novacoind.exe
Copyright (c) 2009-2012 Bitcoin Developers
+Copyright (c) 2013 NovaCoin Developers
Distributed under the MIT/X11 software license, see the accompanying file
license.txt or http://www.opensource.org/licenses/mit-license.php. This
product includes software developed by the OpenSSL Project for use in the
Thomas Bernard.
-Mac OS X bitcoind build instructions
+Mac OS X novacoind build instructions
Laszlo Hanyecz <solar@heliacal.net>
Douglas Huff <dhuff@jrbobdobbs.org>
-See readme-qt.rst for instructions on building Bitcoin QT, the
+See readme-qt.rst for instructions on building NovaCoin QT, the
graphical user interface.
Tested on 10.5 and 10.6 intel. PPC is not supported because it's big-endian.
1. Clone the github tree to get the source code:
-git clone git@github.com:bitcoin/bitcoin.git bitcoin
+git clone https://github.com/novacoin-project/novacoin
2. Download and install MacPorts from http://www.macports.org/
Optionally install qrencode (and set USE_QRCODE=1):
sudo port install qrencode
-4. Now you should be able to build bitcoind:
+4. Now you should be able to build novacoind:
-cd bitcoin/src
+cd novacoin/src
make -f makefile.osx
Run:
- ./bitcoind --help # for a list of command-line options.
+ ./novacoind --help # for a list of command-line options.
Run
- ./bitcoind -daemon # to start the bitcoin daemon.
+ ./novacoind -daemon # to start the novacoin daemon.
Run
- ./bitcoind help # When the daemon is running, to get a list of RPC commands
+ ./novacoind help # When the daemon is running, to get a list of RPC commands
Copyright (c) 2009-2012 Bitcoin Developers
+Copyright (c) 2013 NovaCoin Developers
Distributed under the MIT/X11 software license, see the accompanying
file license.txt or http://www.opensource.org/licenses/mit-license.php.
This product includes software developed by the OpenSSL Project for use in
--------
cd src/
-make -f makefile.unix # Headless bitcoin
+make -f makefile.unix # Headless novacoin
-See readme-qt.rst for instructions on building Bitcoin QT,
-the graphical bitcoin.
+See readme-qt.rst for instructions on building NovaCoin QT,
+the graphical novacoin.
Dependencies
------------
Dependency Build Instructions: Gentoo
-------------------------------------
-Note: If you just want to install bitcoind on Gentoo, you can add the Bitcoin
+Note: If you just want to install novacoind on Gentoo, you can add the Novacoin
overlay and use your package manager:
- layman -a bitcoin && emerge bitcoind
+ layman -a novacoin && emerge novacoind
emerge -av1 --noreplace boost glib openssl sys-libs/db:4.8
Take the following steps to build (no UPnP support):
- cd ${BITCOIN_DIR}/src
+ cd ${NOVACOIN_DIR}/src
make -f makefile.unix USE_UPNP= BDB_INCLUDE_PATH='/usr/include/db4.8'
- strip bitcoind
+ strip novacoind
Notes
-----
-The release is built with GCC and then "strip bitcoind" to strip the debug
+The release is built with GCC and then "strip novacoind" to strip the debug
symbols, which reduces the executable size by about 90%.
Security
--------
-To help make your bitcoin installation more secure by making certain attacks impossible to
+To help make your novacoin installation more secure by making certain attacks impossible to
exploit even if a vulnerability is found, you can take the following measures:
* Position Independent Executable
make -f makefile.unix ... -e PIE=1
To test that you have built PIE executable, install scanelf, part of paxutils, and use:
- scanelf -e ./bitcoin
+ scanelf -e ./novacoin
The output should contain:
TYPE
* Non-executable Stack
If the stack is executable then trivial stack based buffer overflow exploits are possible if
- vulnerable buffers are found. By default, bitcoin should be built with a non-executable stack
+ vulnerable buffers are found. By default, novacoin should be built with a non-executable stack
but if one of the libraries it uses asks for an executable stack or someone makes a mistake
and uses a compiler extension which requires an executable stack, it will silently build an
executable without the non-executable stack protection.
To verify that the stack is non-executable after compiling use:
- scanelf -e ./bitcoin
+ scanelf -e ./novacoin
the output should contain:
STK/REL/PTL
-Bitcoin-qt: Qt4 GUI for Bitcoin
+Novacoin-qt: Qt4 GUI for Novacoin
===============================
Build instructions
qmake
make
-Alternatively, install Qt Creator and open the `bitcoin-qt.pro` file.
+Alternatively, install Qt Creator and open the `novacoin-qt.pro` file.
-An executable named `bitcoin-qt` will be built.
+An executable named `novacoin-qt` will be built.
Windows
UPNnP port forwarding
---------------------
-To use UPnP for port forwarding behind a NAT router (recommended, as more connections overall allow for a faster and more stable bitcoin experience), pass the following argument to qmake:
+To use UPnP for port forwarding behind a NAT router (recommended, as more connections overall allow for a faster and more stable novacoin experience), pass the following argument to qmake:
::
Berkely DB version warning
==========================
-A warning for people using the *static binary* version of Bitcoin on a Linux/UNIX-ish system (tl;dr: **Berkely DB databases are not forward compatible**).
+A warning for people using the *static binary* version of Novacoin on a Linux/UNIX-ish system (tl;dr: **Berkely DB databases are not forward compatible**).
-The static binary version of Bitcoin is linked against libdb4.8 (see also `this Debian issue`_).
+The static binary version of Novacoin is linked against libdb4.8 (see also `this Debian issue`_).
Now the nasty thing is that databases from 5.X are not compatible with 4.X.
====================
Ubuntu 11.10 has a package called 'qt-at-spi' installed by default. At the time of writing, having that package
-installed causes bitcoin-qt to crash intermittently. The issue has been reported as `launchpad bug 857790`_, but
+installed causes novacoin-qt to crash intermittently. The issue has been reported as `launchpad bug 857790`_, but
isn't yet fixed.
Until the bug is fixed, you can remove the qt-at-spi package to work around the problem, though this will presumably
* update translations (ping tcatm on IRC for now)
* update (commit) version in sources
- bitcoin-qt.pro
+ novacoin-qt.pro
src/version.h
share/setup.nsi
doc/README*
* perform gitian builds
- * From a directory containing the bitcoin source, gitian-builder and gitian.sigs
+ * From a directory containing the novacoin source, gitian-builder and gitian.sigs
export SIGNER=(your gitian key, ie bluematt, sipa, etc)
export VERSION=0.5.1
cd ./gitian-builder
wget 'http://downloads.sourceforge.net/project/boost/boost/1.47.0/boost_1_47_0.tar.bz2'
wget 'http://download.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.7.4.tar.gz'
cd ..
- ./bin/gbuild ../bitcoin/contrib/gitian-descriptors/boost-win32.yml
+ ./bin/gbuild ../novacoin/contrib/gitian-descriptors/boost-win32.yml
cp build/out/boost-win32-1.47.0-gitian.zip inputs/
- ./bin/gbuild ../bitcoin/contrib/gitian-descriptors/qt-win32.yml
+ ./bin/gbuild ../novacoin/contrib/gitian-descriptors/qt-win32.yml
cp build/out/qt-win32-4.7.4-gitian.zip inputs/
- ./bin/gbuild ../bitcoin/contrib/gitian-descriptors/deps-win32.yml
- cp build/out/bitcoin-deps-0.0.3.zip inputs/
+ ./bin/gbuild ../novacoin/contrib/gitian-descriptors/deps-win32.yml
+ cp build/out/novacoin-deps-0.0.3.zip inputs/
- * Build bitcoind and bitcoin-qt on Linux32, Linux64, and Win32:
- ./bin/gbuild --commit bitcoin=v${VERSION} ../bitcoin/contrib/gitian-descriptors/gitian.yml
- ./bin/gsign --signer $SIGNER --release ${VERSION} --destination ../gitian.sigs/ ../bitcoin/contrib/gitian-descriptors/gitian.yml
+ * Build novacoind and novacoin-qt on Linux32, Linux64, and Win32:
+ ./bin/gbuild --commit novacoin=v${VERSION} ../novacoin/contrib/gitian-descriptors/gitian.yml
+ ./bin/gsign --signer $SIGNER --release ${VERSION} --destination ../gitian.sigs/ ../novacoin/contrib/gitian-descriptors/gitian.yml
pushd build/out
- zip -r bitcoin-${VERSION}-linux-gitian.zip *
- mv bitcoin-${VERSION}-linux-gitian.zip ../../
+ zip -r novacoin-${VERSION}-linux-gitian.zip *
+ mv novacoin-${VERSION}-linux-gitian.zip ../../
popd
- ./bin/gbuild --commit bitcoin=v${VERSION} ../bitcoin/contrib/gitian-descriptors/gitian-win32.yml
- ./bin/gsign --signer $SIGNER --release ${VERSION}-win32 --destination ../gitian.sigs/ ../bitcoin/contrib/gitian-descriptors/gitian-win32.yml
+ ./bin/gbuild --commit novacoin=v${VERSION} ../novacoin/contrib/gitian-descriptors/gitian-win32.yml
+ ./bin/gsign --signer $SIGNER --release ${VERSION}-win32 --destination ../gitian.sigs/ ../novacoin/contrib/gitian-descriptors/gitian-win32.yml
pushd build/out
- zip -r bitcoin-${VERSION}-win32-gitian.zip *
- mv bitcoin-${VERSION}-win32-gitian.zip ../../
+ zip -r novacoin-${VERSION}-win32-gitian.zip *
+ mv novacoin-${VERSION}-win32-gitian.zip ../../
popd
Build output expected:
- 1. linux 32-bit and 64-bit binaries + source (bitcoin-${VERSION}-linux-gitian.zip)
- 2. windows 32-bit binary, installer + source (bitcoin-${VERSION}-win32-gitian.zip)
+ 1. linux 32-bit and 64-bit binaries + source (novacoin-${VERSION}-linux-gitian.zip)
+ 2. windows 32-bit binary, installer + source (novacoin-${VERSION}-win32-gitian.zip)
3. Gitian signatures (in gitian.sigs/${VERSION}[-win32]/(your gitian key)/
* repackage gitian builds for release as stand-alone zip/tar/installer exe
* Linux .tar.gz:
- unzip bitcoin-${VERSION}-linux-gitian.zip -d bitcoin-${VERSION}-linux
- tar czvf bitcoin-${VERSION}-linux.tar.gz bitcoin-${VERSION}-linux
- rm -rf bitcoin-${VERSION}-linux
+ unzip novacoin-${VERSION}-linux-gitian.zip -d novacoin-${VERSION}-linux
+ tar czvf novacoin-${VERSION}-linux.tar.gz novacoin-${VERSION}-linux
+ rm -rf novacoin-${VERSION}-linux
* Windows .zip and setup.exe:
- unzip bitcoin-${VERSION}-win32-gitian.zip -d bitcoin-${VERSION}-win32
- mv bitcoin-${VERSION}-win32/bitcoin-*-setup.exe .
- zip -r bitcoin-${VERSION}-win32.zip bitcoin-${VERSION}-win32
- rm -rf bitcoin-${VERSION}-win32
+ unzip novacoin-${VERSION}-win32-gitian.zip -d novacoin-${VERSION}-win32
+ mv novacoin-${VERSION}-win32/novacoin-*-setup.exe .
+ zip -r novacoin-${VERSION}-win32.zip novacoin-${VERSION}-win32
+ rm -rf novacoin-${VERSION}-win32
* perform Mac build
See this blog post for how Gavin set up his build environment to build the OSX
release; note that a patched version of macdeployqt is not needed anymore, as
the required functionality and fixes are implemented directly in macdeployqtplus:
- http://gavintech.blogspot.com/2011/11/deploying-bitcoin-qt-on-osx.html
+ http://gavintech.blogspot.com/2011/11/deploying-novacoin-qt-on-osx.html
Gavin also had trouble with the macports py27-appscript package; he
ended up installing a version that worked with: /usr/bin/easy_install-2.7 appscript
- qmake RELEASE=1 USE_UPNP=1 USE_QRCODE=1 bitcoin-qt.pro
+ qmake RELEASE=1 USE_UPNP=1 USE_QRCODE=1 novacoin-qt.pro
make
export QTDIR=/opt/local/share/qt4 # needed to find translations/qt_*.qm files
T=$(contrib/qt_translations.py $QTDIR/translations src/qt/locale)
- python2.7 contrib/macdeploy/macdeployqtplus Bitcoin-Qt.app -add-qt-tr $T -dmg -fancy contrib/macdeploy/fancy.plist
+ python2.7 contrib/macdeploy/macdeployqtplus Novacoin-Qt.app -add-qt-tr $T -dmg -fancy contrib/macdeploy/fancy.plist
Build output expected:
- Bitcoin-Qt.dmg
+ Novacoin-Qt.dmg
* upload builds to SourceForge
* create SHA256SUMS for builds, and PGP-sign it
-* update bitcoin.org version
+* update novacoin.org version
* update forum version
* update wiki download links
-* update wiki changelog: https://en.bitcoin.it/wiki/Changelog
+* update wiki changelog: https://wiki.novaco.in/en/Changelog
* Commit your signature to gitian.sigs:
pushd gitian.sigs
* After 3 or more people have gitian-built, repackage gitian-signed zips:
- * From a directory containing bitcoin source, gitian.sigs and gitian zips
+ * From a directory containing novacoin source, gitian.sigs and gitian zips
export VERSION=0.5.1
- mkdir bitcoin-${VERSION}-linux-gitian
- pushd bitcoin-${VERSION}-linux-gitian
- unzip ../bitcoin-${VERSION}-linux-gitian.zip
+ mkdir novacoin-${VERSION}-linux-gitian
+ pushd novacoin-${VERSION}-linux-gitian
+ unzip ../novacoin-${VERSION}-linux-gitian.zip
mkdir gitian
- cp ../bitcoin/contrib/gitian-downloader/*.pgp ./gitian/
+ cp ../novacoin/contrib/gitian-downloader/*.pgp ./gitian/
for signer in $(ls ../gitian.sigs/${VERSION}/); do
- cp ../gitian.sigs/${VERSION}/${signer}/bitcoin-build.assert ./gitian/${signer}-build.assert
- cp ../gitian.sigs/${VERSION}/${signer}/bitcoin-build.assert.sig ./gitian/${signer}-build.assert.sig
+ cp ../gitian.sigs/${VERSION}/${signer}/novacoin-build.assert ./gitian/${signer}-build.assert
+ cp ../gitian.sigs/${VERSION}/${signer}/novacoin-build.assert.sig ./gitian/${signer}-build.assert.sig
done
- zip -r bitcoin-${VERSION}-linux-gitian.zip *
- cp bitcoin-${VERSION}-linux-gitian.zip ../
+ zip -r novacoin-${VERSION}-linux-gitian.zip *
+ cp novacoin-${VERSION}-linux-gitian.zip ../
popd
- mkdir bitcoin-${VERSION}-win32-gitian
- pushd bitcoin-${VERSION}-win32-gitian
- unzip ../bitcoin-${VERSION}-win32-gitian.zip
+ mkdir novacoin-${VERSION}-win32-gitian
+ pushd novacoin-${VERSION}-win32-gitian
+ unzip ../novacoin-${VERSION}-win32-gitian.zip
mkdir gitian
- cp ../bitcoin/contrib/gitian-downloader/*.pgp ./gitian/
+ cp ../novacoin/contrib/gitian-downloader/*.pgp ./gitian/
for signer in $(ls ../gitian.sigs/${VERSION}-win32/); do
- cp ../gitian.sigs/${VERSION}-win32/${signer}/bitcoin-build.assert ./gitian/${signer}-build.assert
- cp ../gitian.sigs/${VERSION}-win32/${signer}/bitcoin-build.assert.sig ./gitian/${signer}-build.assert.sig
+ cp ../gitian.sigs/${VERSION}-win32/${signer}/novacoin-build.assert ./gitian/${signer}-build.assert
+ cp ../gitian.sigs/${VERSION}-win32/${signer}/novacoin-build.assert.sig ./gitian/${signer}-build.assert.sig
done
- zip -r bitcoin-${VERSION}-win32-gitian.zip *
- cp bitcoin-${VERSION}-win32-gitian.zip ../
+ zip -r novacoin-${VERSION}-win32-gitian.zip *
+ cp novacoin-${VERSION}-win32-gitian.zip ../
popd
* Upload gitian zips to SourceForge
Files and Folders
-----------------
-### bitcoin-qt.pro
+### novacoin-qt.pro
This file takes care of generating `.qm` files from `.ts` files. It is mostly
automated.
-### src/qt/bitcoin.qrc
+### src/qt/novacoin.qrc
This file must be updated whenever a new translation is added. Please note that
files must end with `.qm`, not `.ts`.
<qresource prefix="/translations">
- <file alias="en">locale/bitcoin_en.qm</file>
+ <file alias="en">locale/novacoin_en.qm</file>
...
</qresource>
This directory contains all translations. Filenames must adhere to this format:
- bitcoin_xx_YY.ts or bitcoin_xx.ts
+ novacoin_xx_YY.ts or novacoin_xx.ts
#### Source file
-`src/qt/locale/bitcoin_en.ts` is treated in a special way. It is used as the
+`src/qt/locale/novacoin_en.ts` is treated in a special way. It is used as the
source for all other translations. Whenever a string in the code is changed
this file must be updated to reflect those changes. Usually, this can be
accomplished by running `lupdate` (included in the Qt SDK).
### Fetching new translations
1. `tx pull -a`
-2. update `src/qt/bitcoin.qrc` manually or via
- `ls src/qt/locale/*ts|xargs -n1 basename|sed 's/\(bitcoin_\(.*\)\).ts/<file alias="\2">locale/\1.qm<\/file>/'`
+2. update `src/qt/novacoin.qrc` manually or via
+ `ls src/qt/locale/*ts|xargs -n1 basename|sed 's/\(novacoin_\(.*\)\).ts/<file alias="\2">locale/\1.qm<\/file>/'`
3. `git add` new translations from `src/qt/locale/`