ASCII platform-adventure game (http://ariis.it/static/articles/venzone/page.html)

root / CONTRIBUTING

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
===========================================
If you want to contriubute to the source
code of venzone you are in the right
place. If you want to design levels inste-
ad, check the guide at `stories/editor.vns`
===========================================



1. Get Haskell and Darcs, from your repos or from:
        https://www.haskell.org/downloads/#minimal
        http://darcs.net

2. Clone the code with `darcs get https://hub.darcs.net/ffaf/venzone`

3. Modify the game, add features.

    lentil src/ test/ # to see open issues
    # no lentil? `cabal new-install lentil` to get it.

4. If needed, update your package list:

    cabal new-update

5. Build your executable:

    cabal new-build venzone
    # when it finishes, you will find your executable in `release/`.
    # Use --allow-newer if cabal cannot solve the dependency tree

6. Run the tests with:

    cabal new-run test
    # you might get a `missing hspec-discover` error, in that case
    # run `cabal new-install hspec-discover`.

    # if you want to watch the replay of a specific test, do
    `cabal new-repl test` and then
    λ> narrateGymnasium "test/records/ladder-exit.vr"

7. send me a diff or patch in any format you prefer. With darcs the
   usual workflow is to set up a repo at https://hub.darcs.net/ ,
   push your patches there and let me know.
   If you prefer plain email:

    darcs record                         # records your changes
    darcs send -o some-change.dpatch     # creates a textual patch
        # and then write to me (<fa-ml@ariis.it>)
        # with some-change.dpatch attached.

8. if you compiled venzone for a new system and want to send me a release
   of it just type:

    cabal new-run -f crea-release packerino

   and a .zip will be automatically created.


If you get stuck, don't hesitate to contact me:

    http://ariis.it/static/articles/mail/page.html