]> Nishi Git Mirror - gwion.git/commitdiff
:book: Update README
authorJérémie Astor <astor.jeremie@wanadoo.fr>
Fri, 7 Aug 2020 19:11:30 +0000 (21:11 +0200)
committerJérémie Astor <astor.jeremie@wanadoo.fr>
Fri, 7 Aug 2020 19:11:30 +0000 (21:11 +0200)
README.md

index 89b7220651a8f7eb5bef679c08152a97dd85af87..f22e1db9b99c0bd15e735cde5fe6ae8cf2e1cb9c 100644 (file)
--- a/README.md
+++ b/README.md
@@ -14,19 +14,47 @@ Gwion is a programming language, aimed at making music
 
 **strongly** inspired by [chuck](http://chuck.stanford.edu/), but adding a bunch *high-level* features:  
          templating, first-class functions and more.  
-<!-- TODO: add benchmarks in doc and link to it -->
+
 It aims to be simple, small,
  [fast](https://fennecdjay.github.io/Gwion/#Benchmarks/),
  [extendable](https://github.com/fennecdjay/Gwion-plug) and [embeddable](https://github.com/fennecdjay/Gwion/blob/master/src/main.c#L18-L31).
 
-### Executing your first code (hello_world.gw):
+## Build
+### Download the source
+You might just want the minimum to start with, try
+``` sh
+git clone https://github.com/fennecdjay/Gwion
+cd Gwion
+git submodule update --init util ast
+make
+```
+
+### Configuring (optionnal)
+You can get a list of config files to tweak with
+``` sh
+find . -name "config.mk"
+```
+
+Please rebuild to take your change into account.
+```
+make -C util clean
+make -C ast  clean
+make clean
+make
+```
+
+> Besides develloper options, you migth want to check *USE_DOUBLE*, in util/config.mk, which set the floating point size (float or double).
+
+## Executing your first code (hello_world.gw):
 
-This assumes you have successfully installed gwion. To build follow [these steps](#build) . To check, if the build was successfully run
+This assumes you have successfully compiled gwion. To build follow [these steps](#build) . To check, if the build was successfully run
 ```
 ./gwion
 ```
-if this gives out some error, there were problems with your installation. Try installing again, and open a issue if the problem persists. We would love to help you out.  
-If you see no errors, Congratulations!! You have successfully installed gwion, and can move ahead.
+if this gives out some error, there were problems with your compilation.
+Try building again, and open a [issue](https://github.com/fennecdjay/Gwion/issues)
+if the problem persists. We would love to help you out.  
+If you see no errors, Congratulations!! You have successfully compiled gwion, and can move ahead.
 
 Create a new file "hello_world.gw" in the same directory.(You are free to use any command)
 ```
@@ -52,22 +80,6 @@ Congratulations!! You ran your first gwion program.
 You want to know more? :smile: Look [here](https://fennecdjay.github.io/Gwion/)
 Both outdated and WIP :construction_worker: but a nice place to learn and [contribute](https://github.com/fennecdjay/gwion/issues)
 
-## Build
-### Download the source
-You might just want the minimum to start with, try
-``` sh
-git clone https://github.com/fennecdjay/Gwion
-cd Gwion
-git submodule update --init util ast
-make
-```
-
-You can get a list of config files to tweak with
-``` sh
-find . -name "config.mk"
-```
-> Besides develloper options, you migth want to check *USE_DOUBLE*, in util/config.mk, which set the floating point size (float or double).
-
 ## Reporting bugs / Contributing
 
 :+1: Every helping hand is welcome!!! :+1: