You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+33-7
Original file line number
Diff line number
Diff line change
@@ -4,22 +4,48 @@ This repository is part of the [codebender.cc](http://www.codebender.cc) maker a
4
4
5
5
## And what's that?
6
6
7
-
codebender comes to fill the need for reliable and easy to use tools for makers.
8
-
A need that from our own experience could not be totally fulfilled by any of the existing solutions. Things like installing libraries, updating the software or installing the IDE can be quite a painful process.
7
+
codebender fills the need for reliable, easy to use tools for makers, a need that couldn't be completely fulfilled by any existing solution according to our experience.
9
8
10
-
In addition to the above, the limited features provided (e.g. insufficient highlighting, indentation and autocompletion) got us starting building codebender, a completely web-based IDE, that requires virtually no installation and offers a great code editor. It also stores your sketches on the cloud.
9
+
Things like installing libraries or the IDE and updating software sometimes were (and still are) quite a painful process. But in addition to the above, the limited features provided (e.g. insufficient highlighting, indentation and autocompletion) got us to start codebender, a completely web-based IDE that requires virtually no installation and offers a great code editor. Plus it stores your sketches on the cloud. Yeah!
11
10
12
-
That way, you can still access your sketches safely even if your laptop is stolen or your hard drive fails! codebender also takes care of compilation, giving you extremely descriptive warnings on terrible code. On top of that, when you are done, you can upload your code to your Arduino straight from the browser.
11
+
With your code on the cloud, you can access your sketches safely even if your laptop is stolen or your hard drive fails! codebender also compiles your code giving you extremely descriptive error descriptions on terrible code. There's even more, you can upload your code to your Arduino straight from the browser.
13
12
14
13
## How does the compiler come into the picture?
15
14
16
-
The compiler repository includes all the necessary files needed to run the compiler as a service. It receives the code as input and outputs the errors in the code, or the compiled output if the compilation was successful. We provide a really easy to use interface to allow us to send the code to the compiler easily.
15
+
The compiler repository includes all the necessary files needed to run the compiler as a service. It receives the code as input and outputs the compiled output if the compilation was successful or the errors present in the code. We provide an easy interface to send the code to the compiler.
17
16
18
17
Here's a list of open source projects we use
19
18
* Clang
20
19
* gcc-avr
21
20
* avr binutils (avrsize)
22
21
23
-
For development, we've used it on a variety of Linux and Mac OS X machines.
22
+
For development we've run it on a variety of Linux and Mac OS X machines.
24
23
25
-
For production, we are using Ubuntu Server 12.04, and we know it works perfectly with that, so we suggest using that as well.
24
+
For production we are using Ubuntu Server 12.04. We know the compiler works perfectly on it, so we suggest you using it as well.
Then cd in the created directory (if you run the command as is above, it would be named `compiler`) and run
33
+
34
+
`scripts/install.sh`
35
+
36
+
(don't cd into scripts directory and run install.sh from there, it won't work)
37
+
38
+
If you now visit `http://localhost/status` you'll see a JSON response telling you everything's ok:
39
+
`{"success":true,"status":"OK"}`
40
+
41
+
## What's next?
42
+
43
+
Visit the [wiki](https://github.com/codebendercc/compiler/wiki) for more information.
44
+
45
+
## How can someone contribute?
46
+
47
+
Contribution is always welcome whether it is by creating an issue for a bug or suggestion you can't fix yourself or a pull request for something you can.
48
+
49
+
If you write new code or edit old code please don't forget to add/update relative unit tests that come with it. It is always a good idea to run tests localy to make sure nothing breaks before you create a pull request.
50
+
51
+
We expect new code to be [PSR-2](http://www.php-fig.org/psr/psr-2/) but we know we carry legacy code with different coding styles. You're welcome to fix that.
'When using the logout handler from the Symfony Security Component, you should have at least PHP 5.4.11 due to PHP bug #63379 (as a workaround, you can also set invalidate_session to false in the security logout handler configuration)',
560
+
'Install PHP 5.4.11 or newer if your project uses the logout handler from the Symfony Security Component.'
'You should use PHP 5.3.18+ or PHP 5.4.8+ to always get nice error messages for fatal errors in the development environment due to PHP bug #61767/#60909',
568
+
'Install PHP 5.3.18+ or PHP 5.4.8+ if you want nice error messages for all fatal errors in the development environment.'
0 commit comments