From 92b54aacc0de5446dd5497c39897b0bbff72e626 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20Hoguin?= Date: Wed, 13 Jun 2018 09:54:12 +0200 Subject: Rebuild using Asciideck --- docs/en/erlang.mk/1/guide/overview/index.html | 102 +++++++------------------- 1 file changed, 25 insertions(+), 77 deletions(-) (limited to 'docs/en/erlang.mk/1/guide/overview') diff --git a/docs/en/erlang.mk/1/guide/overview/index.html b/docs/en/erlang.mk/1/guide/overview/index.html index 1a4b2b9d..9fa002de 100644 --- a/docs/en/erlang.mk/1/guide/overview/index.html +++ b/docs/en/erlang.mk/1/guide/overview/index.html @@ -62,94 +62,42 @@

Overview

-

Now that you know how to get started, let’s take a look at -what Erlang.mk can do for you.

-
+

Now that you know how to get started, let's take a look at what Erlang.mk can do for you.

Building your project

-
-

Erlang.mk is first and foremost a build tool. It is especially -tailored for Erlang developers and follows widely accepted -practices in the Erlang community.

-

Erlang.mk will happily build all Erlang-specific files -you throw at it. Other kinds of files too, like C or C++ code -when you are working on a NIF or a port driver.

-

Erlang.mk embraces the concept of source dependencies. -It can fetch dependency source code using a variety of mechanisms, -including fetching from Git, Mercurial or SVN.

-

Erlang.mk will automatically generate releases -when applicable. It can also generate escripts.

-
-
-
+

Erlang.mk is first and foremost a build tool. It is especially tailored for Erlang developers and follows widely accepted practices in the Erlang community.

+

Erlang.mk will happily build all Erlang-specific files you throw at it. Other kinds of files too, like C or C++ code when you are working on a NIF or a port driver.

+

Erlang.mk embraces the concept of source dependencies. It can fetch dependency source code using a variety of mechanisms, including fetching from Git, Mercurial or SVN.

+

Erlang.mk will automatically generate releases when applicable. It can also generate escripts.

Exploring the package index

-
-

Erlang.mk comes with a built-in package index. -It is built as an extension of the dependency system and is -meant to be used for discovery purposes.

-

No package is ever installed, they are only used as dependencies -and are always project-specific. They can be thought of as a -shortcut over plain dependencies.

-

You can get a list of all packages known to Erlang.mk by using -the search target:

-
-
-
$ make search
-

You can also use this target to search across all packages, for -example to find all packages related to Cowboy:

-
-
-
$ make search q=cowboy
-
-
-
+
$ make search q=cowboy
+

Generating documentation

-
-

Erlang.mk supports EDoc and Asciidoc.

-

EDoc generates HTML documentation directly from -your source code.

-

While it is convenient, ask yourself: if all the documentation is -inside the source code, why not just open the source code directly? -That’s where Asciidoc comes in.

-

The Asciidoc plugin expects all documentation -to be separate from source. It will generate HTML, PDF, man pages and -more from the documentation you write in the doc/src/ folder in -your repository.

-
- -
+

Erlang.mk supports EDoc and Asciidoc.

+

EDoc generates HTML documentation directly from your source code.

+

While it is convenient, ask yourself: if all the documentation is inside the source code, why not just open the source code directly? That's where Asciidoc comes in.

+

The Asciidoc plugin expects all documentation to be separate from source. It will generate HTML, PDF, man pages and more from the documentation you write in the doc/src/ folder in your repository.

Running tests

-
-

Erlang.mk supports a lot of different testing and static -analysis tools.

-

The make shell command allows you -to test your project manually. You can automate these -unit tests with EUnit and test -your entire system with Common Test. -Code coverage can of course -be enabled during tests.

-

Erlang.mk comes with features to make your life easier when -setting up and using Continuous integration.

-

On the static analysis side of things, Erlang.mk comes with -support for Dialyzer and Xref, -to perform success typing analysis and cross referencing -of the code.

-
-
-
+

Erlang.mk supports a lot of different testing and static analysis tools.

+

The make shell command allows you to test your project manually. You can automate these unit tests with EUnit and test your entire system with Common Test. Code coverage can of course be enabled during tests.

+

Erlang.mk comes with features to make your life easier when setting up and using Continuous integration.

+

On the static analysis side of things, Erlang.mk comes with support for Dialyzer and Xref, to perform success typing analysis and cross referencing of the code.

Need more?

-
-

Not convinced yet? You can read about why you should use Erlang.mk -and its history. And if you’re still not -convinced after that, it’s OK! The world would be boring if -everyone agreed on everything all the time.

-
-
+

Not convinced yet? You can read about why you should use Erlang.mk and its history. And if you're still not convinced after that, it's OK! The world would be boring if everyone agreed on everything all the time.

+ -- cgit v1.2.3