Statistics
| Branch: | Tag: | Revision:

root / doc / devnotes.rst @ 88b58ed6

History | View | Annotate | Download (8.1 kB)

# Date Author Comment
42e85303 09/25/2013 04:49 pm Klaus Aehlig

Merge branch 'stable-2.9' into master

  • stable-2.9
    Including missing RST files in packaging
    Update supported lint tools version numbers
    Fix some wrong indentations in the code
    Disable parenthesis indentation check
    Fix an improperly escaped string...
ab6536ba 09/25/2013 12:07 pm Michele Tartara

Update supported lint tools version numbers

Linting is now verified against the lint tools version numbers as listed in this
patch.

These version are corresponding to the ones that can be found in the
repositories of Ubuntu 13.04.

Signed-off-by: Michele Tartara <>...

242e6bdd 08/07/2013 06:48 pm Thomas Thrainer

Require newer python mock library

Older Python mock libraries do not provide MagicMock, which eases
mocking of complex objects quite a bit. As this is a build/test
dependency only, requiring a new version is OK (it's available via
easy_install).

Signed-off-by: Thomas Thrainer <>...

5f7d4181 07/10/2013 02:04 pm Jose A. Lopes

Fix single-execution of Haskell tests and shelltests

Add Makefile.am target hs-test-% for single-execution of Haskell
tests.

Add Makefile.am target hs-shell-% for single-execution of Haskell
shelltests.

Update documentation on running individual tests....

7a694e30 04/29/2013 07:05 pm Thomas Thrainer

Add dependency on python-mock

Python Mock (http://www.voidspace.org.uk/python/mock/) is a mocking
library for Python. It is included in the standard Python distribution
as of Python 3.3, but has been around for quite a while. Debian unstable
contains a version we require....

f0eeeb2a 04/03/2013 11:52 am Michele Tartara

Fix error in the developer notes

The version numbers of two programs had been swapped.

Signed-off-by: Michele Tartara <>
Reviewed-by: Helga Velroyen <>

6e71fbf6 04/02/2013 03:18 pm Bernardo Dal Seno

Add dependency on PyYAML in devnotes

This is required because of 0e79564a; otherwise, the pylint-qa target will
fail.

Signed-off-by: Bernardo Dal Seno <>
Reviewed-by: Guido Trotter <>

8d53117b 04/02/2013 11:51 am Michele Tartara

Update installation documentation

Some required dependencies were missing from the installation instructions.

Signed-off-by: Michele Tartara <>
Reviewed-by: Helga Velroyen <>

099e9213 03/05/2013 05:53 pm Iustin Pop

Update required pylint version

This should help a lot of users, since pylint 0.21.1 was quite an old
version…

The tree is "clean" w.r.t. the new pylint version.

Signed-off-by: Iustin Pop <>
Reviewed-by: Michele Tartara <>

3784c431 01/08/2013 11:28 am Yiannis Tsiouris

Update name of test/htest in doc/devnotes.rst

Update the docs after the rename of 'test/hs/test' to
'test/hs/htest'. This must have been forgotten in 3e16567e.

Signed-off-by: Yiannis Tsiouris <>
Signed-off-by: Iustin Pop <>...

fe7ad9c8 01/08/2013 11:28 am Iustin Pop

Improve a bit Haskell library recommended versions

The hinotify library was missing any versions, and finding one that
works with ghc 6.12 (base 4.2.x) was not obvious. The
test-framework-quickcheck2 recommended version didn't actually work
with the test-framework version, so fix that as well....

83846468 12/27/2012 03:34 pm Iustin Pop

Move htest/ files under the test/ tree

htest/data becomes test/data/htools (basically reverting commit
8feabc89), and htest/* becomes test/hs/*.

Most changes beside the rename are trivial s/…/…, with the exception
of autotools/run-in-tempdir, which needed some more changes now that...

90066780 12/27/2012 03:34 pm Iustin Pop

Move python test files to test/py

This is the first step of the test files reorganisation: moving test/*
(except test/data) to new directory test/py/.

Signed-off-by: Iustin Pop <>
Reviewed-by: Guido Trotter <>

3add7574 12/24/2012 11:38 pm Iustin Pop

Rename htools/ to src/

Per offline discussions, this is the first patch of the
renames. Tested with "make distcheck", seems to work fine.

The only change outside of the renaming is a bit of simplification in
the .gitignore rules; otherwise, simply s/htools/src/....

c96887cf 12/18/2012 03:22 pm Iustin Pop

Explain how to use GHCI to see spliced TH code

This can be more useful than the "make" version.

Signed-off-by: Iustin Pop <>
Reviewed-by: Michael Hanselmann <>

4355b2de 12/17/2012 01:37 pm Iustin Pop

Add new Haskell library dependency for tests

The 'temporary' library add support for create temporary
directories/files beyond what is offered in the base library (which is
somewhat limited, and hard to use in tests).

Signed-off-by: Iustin Pop <>...

d6b5da24 12/14/2012 03:11 pm Guido Trotter

Add profiling dependencies note

As discussed on the list, these are needed to do a make hs-prof.

Signed-off-by: Guido Trotter <>
Reviewed-by: Iustin Pop <>

8e09e801 11/01/2012 07:44 pm Michael Hanselmann

Merge branch 'devel-2.6'

  • devel-2.6:
    Fix typo in gnt-instance man page
    jqueue: Return jobs to queue when shutting down
    gnt-debug delay: Add "--submit" option
    Make hostname checks uniform between instance rename and add
    Improve logging of new job submissions...
cfa2b7a0 10/30/2012 09:00 pm Iustin Pop

Add note about developing on a production machine

This is the bit of documentation missing for issue 170. Doing
development on a machine which already has Ganeti installed kind of
works, but only when the installed and the developed version are very
similar, and even then it can be problematic....

06c9a9d6 10/19/2012 05:55 pm Iustin Pop

Add note about running individual test cases

This was asked a few times offline, so let's document it.

Signed-off-by: Iustin Pop <>
Reviewed-by: Michael Hanselmann <>

ded769c1 10/19/2012 05:55 pm Iustin Pop

Add a small note about tab completion and generated files

This can indeed be annoying, so let's document it.

Signed-off-by: Iustin Pop <>
Reviewed-by: Adeodato Simo <>

6a74f584 10/11/2012 12:38 pm Michael Hanselmann

Merge branch 'devel-2.6'

  • devel-2.6:
    verify-disks: Explicitely state nothing has to be done
    Add list of design documents implemented in version 2.6
    Better list of replace-disks arguments + typos fixed
    jqueue: Look at archived jobs when watching
    Show old primary/secondary node on disk replacement...
21a5e56c 10/10/2012 02:43 pm Iustin Pop

Improve Haskell configure options and detection

This patch cleans up the Haskell library detection and defaults.

First, it makes the base compiler/libraries required, per the email discussion.

It then adds two new small autoconf macros, on to check for a required...

77865fb4 10/01/2012 09:23 am Gintautas Miliauskas

Fixed typos in devnotes.rst

Signed-off-by: Gintautas Miliauskas <>
Reviewed-by: Michael Hanselmann <>

95f6c931 08/28/2012 06:03 pm Iustin Pop

Switch Haskell test harness to test-framework

This patch replaces our home-grown, and quite limited, test runner
infrastructure with test-framework
(http://batterseapower.github.com/test-framework/). The rationale for
doing so is as follows:

- we will need to add support for HUnit tests, so either we add more...

5ae4945a 08/23/2012 02:41 pm Iustin Pop

Bump pep8 version to 1.2

Debian Wheezy will ship with this version, and it has many improved checks compared to 0.6, so let's:

- bump version in the docs
- silence some new checks that are wrong due to our indent=2 instead of 4
- fix lots of errors in the code where the indentation was wrong by 1...

fc6075dd 07/06/2012 01:37 pm Agata Murawska

Installation instructions update

This patch aims at improving documentation for installing ganeti - both for users and developers.

Signed-off-by: Agata Murawska <>
Reviewed-by: Iustin Pop <>

727ee1ec 03/27/2012 06:10 pm Iustin Pop

Update INSTALL and devnotes documents

Added the new Haskell library requirements, for both normal and
developer usage.

Furthermore, all commands are now converted to the shell-example
lexer.

Signed-off-by: Iustin Pop <>
Reviewed-by: Michael Hanselmann <>

c7ec3025 01/16/2012 02:49 pm Iustin Pop

Add a Makefile target for profiling targets

This simplifies the building of profiling-enabled htools binaries;
there are two targets, one used for the initial two-stage build, and
one that can be used for incremental builds.

The patch adds a new internal variable for the htools/test binary,...

3603605a 12/08/2011 10:00 am Iustin Pop

Cleanup hlint errors

First, we update the recommended hlint version to what I used to get a
clean output (1.8.15). Most of the changes are:

- remove unneeded parentheses
- some simplifications (intercalate " " → unwords, maybe … id →
fromMaybe, etc.)
- removal of some duplicate code (in previous patches)...

ef958f2a 10/14/2011 01:37 pm Iustin Pop

Document some useful Haskell tips

This improves devnotes.rst with some tricks for Haskell development,
and additionally it does two Makefile improvements:

- properly document lib/_vcsversion.py as a requirement for
Constants.hs (but do not require rebuild when updated)...

08366664 08/26/2011 02:57 pm Michael Hanselmann

Use pep8 utility in “make lint”

This utility checks whether the code conforms to PEP8. Some checks had
to be disabled for Ganeti.

Signed-off-by: Michael Hanselmann <>
Reviewed-by: Iustin Pop <>

ee041788 07/21/2011 02:52 pm Iustin Pop

Update documentation regarding Haskell dependencies

These were forgot when the supported library versions were changed.

Signed-off-by: Iustin Pop <>
Reviewed-by: Michael Hanselmann <>

8e4f6d56 06/28/2011 06:37 pm Iustin Pop

htools: Switch to QuickCheck 2.x

Since current distros don't package anymore QuickCheck 1.x, let's move
to 2.x.

This requires also a few changes to the code:

- Test.QuickCheck.Batch doesn't exist anymore, so we need to write some
scaffolding code to replace it...

fd0bc853 03/30/2011 04:45 pm Iustin Pop

Clarify the need for QuickCheck/Haskell tests

Expands the devnotes.rst doc and adds warnings in the Makefile.

Signed-off-by: Iustin Pop <>
Reviewed-by: Michael Hanselmann <>

77a180f6 03/23/2011 01:25 pm Iustin Pop

Update INSTALL and devnotes.rst with Haskell notes

This documents the needed libraries for Haskell development. It also
fixes a tiny typo in devnotes.rst.

Signed-off-by: Iustin Pop <>
Reviewed-by: Michael Hanselmann <>

18e2b6e4 11/15/2010 07:34 pm Iustin Pop

Remove last vestiges of docbook

This patch removes the last traces of docbook.

Signed-off-by: Iustin Pop <>
Reviewed-by: René Nussbaumer <>

b3a8bebf 10/15/2010 05:24 pm Michael Hanselmann

devnotes.rst: Remove hardcoded Python version

Signed-off-by: Michael Hanselmann <>
Reviewed-by: Iustin Pop <>

1de45c78 06/02/2010 08:39 pm Guido Trotter

Document the check-man change

Since this affects developers' systems, document it in NEWS and
devnotes.rst

Signed-off-by: Guido Trotter <>
Reviewed-by: Iustin Pop <>

27e336af 02/23/2010 07:11 pm Michael Hanselmann

Add make target to generate unittest coverage report

Signed-off-by: Michael Hanselmann <>
Reviewed-by: Guido Trotter <>

94338f0a 11/13/2009 05:59 pm Michael Hanselmann

Add packaging notes to documentation

This includes a few paragraphs about daemon-util.

Signed-off-by: Michael Hanselmann <>
Reviewed-by: Guido Trotter <>

cbf3d64b 11/13/2009 05:59 pm Michael Hanselmann

Include INSTALL in documentation

Signed-off-by: Michael Hanselmann <>
Reviewed-by: Guido Trotter <>

c27ba1cc 11/13/2009 05:59 pm Michael Hanselmann

Convert INSTALL to RST

This is in preparation to including it into the large
documentation.

Signed-off-by: Michael Hanselmann <>
Reviewed-by: Guido Trotter <>

558fd122 09/24/2009 06:31 pm Michael Hanselmann

Set Vim textwidth in each documentation file

Signed-off-by: Michael Hanselmann <>
Reviewed-by: Iustin Pop <>

62947ebb 09/15/2009 03:17 pm Michael Hanselmann

Move developer notes into normal documentation

Signed-off-by: Michael Hanselmann <>
Reviewed-by: Guido Trotter <>