mirror of
https://github.com/correl/rebar.git
synced 2024-11-27 19:19:53 +00:00
Update README
This commit is contained in:
parent
35ef3631b4
commit
000a834144
1 changed files with 14 additions and 29 deletions
37
README.md
37
README.md
|
@ -73,8 +73,8 @@ Do not mix spaces and tabs.
|
|||
Do not introduce lines longer than 80 characters.
|
||||
|
||||
[erlang-mode (emacs)](http://www.erlang.org/doc/man/erlang.el.html) indentation is preferred.
|
||||
vi-only users are encouraged to give [Vim emulation](http://emacswiki.org/emacs/Evil)
|
||||
([more info](https://gitorious.org/evil/pages/Home)) a try.
|
||||
vi-only users are encouraged to
|
||||
give [Vim emulation](http://emacswiki.org/emacs/Evil) ([more info](https://gitorious.org/evil/pages/Home)) a try.
|
||||
|
||||
Writing Commit Messages
|
||||
-----------------------
|
||||
|
@ -108,28 +108,15 @@ Longer description (wrap at 72 characters)
|
|||
* Break up logical changes
|
||||
* Make whitespace changes separately
|
||||
|
||||
Dialyzer and Tidier
|
||||
-------------------
|
||||
Run checks
|
||||
----------
|
||||
|
||||
Before you submit a patch check for
|
||||
Before you submit a patch, run ``make check`` to execute
|
||||
the test suite and check for
|
||||
[xref](http://www.erlang.org/doc/man/xref.html) and
|
||||
[Dialyzer](http://www.erlang.org/doc/man/dialyzer.html)
|
||||
warnings.
|
||||
|
||||
A successful run of ``make check`` looks like:
|
||||
|
||||
```sh
|
||||
$ make check
|
||||
Recompile: src/rebar_core
|
||||
==> rebar (compile)
|
||||
Command 'debug' not understood or not applicable
|
||||
Congratulations! You now have a self-contained script called "rebar" in
|
||||
your current working directory. Place this script anywhere in your path
|
||||
and you can use rebar to build OTP-compliant apps.
|
||||
==> rebar (xref)
|
||||
make: [dialyzer_warnings] Error 2 (ignored)
|
||||
```
|
||||
|
||||
[Dialyzer](http://www.erlang.org/doc/man/dialyzer.html) warnings are compared
|
||||
against a set of safe-to-ignore warnings found in
|
||||
[dialyzer_reference](https://raw.github.com/basho/rebar/master/dialyzer_reference).
|
||||
|
@ -139,10 +126,8 @@ to suppress safe-to-ignore warnings.
|
|||
|
||||
It is **strongly recommended** to check the code with
|
||||
[Tidier](http://tidier.softlab.ntua.gr:20000/tidier/getstarted).
|
||||
Select all transformation options and enable **automatic**
|
||||
transformation.
|
||||
If Tidier suggests a transformation apply the changes **manually**
|
||||
to the source code.
|
||||
Do not use the code from the tarball (*out.tgz*) as it will have
|
||||
white-space changes
|
||||
applied by Erlang's pretty-printer.
|
||||
Select all transformation
|
||||
options and enable **automatic** transformation. If Tidier suggests a transformation,
|
||||
apply the changes **manually** to the source code. Do not use the code from
|
||||
the
|
||||
tarball (*out.tgz*) as it will have white-space changes applied by Erlang's pretty-printer.
|
||||
|
|
Loading…
Reference in a new issue