diff options
| author | Fredrik Gustafsson <[email protected]> | 2013-08-21 11:06:12 +0200 |
|---|---|---|
| committer | Fredrik Gustafsson <[email protected]> | 2013-08-21 11:06:12 +0200 |
| commit | a27e9776c839aa9fed9e71e3d06a33720377e293 (patch) | |
| tree | a8b3e0a16766da4a55ca4c56297468c1b85bd775 /lib/kernel/doc/src/application.xml | |
| parent | 619f74597b36ed76826a76cc6499cc136fc66f3e (diff) | |
| parent | 3cc53db7071988cd8dad0d67c85b3e08a7c6818e (diff) | |
| download | otp-a27e9776c839aa9fed9e71e3d06a33720377e293.tar.gz otp-a27e9776c839aa9fed9e71e3d06a33720377e293.tar.bz2 otp-a27e9776c839aa9fed9e71e3d06a33720377e293.zip | |
Merge branch 'maint'
Diffstat (limited to 'lib/kernel/doc/src/application.xml')
| -rw-r--r-- | lib/kernel/doc/src/application.xml | 27 |
1 files changed, 21 insertions, 6 deletions
diff --git a/lib/kernel/doc/src/application.xml b/lib/kernel/doc/src/application.xml index da16964d61..29eaf348a9 100644 --- a/lib/kernel/doc/src/application.xml +++ b/lib/kernel/doc/src/application.xml @@ -253,15 +253,30 @@ Nodes = [cp1@cave, {cp2@cave, cp3@cave}]</code> </warning> </desc> </func> - <func> + <func> <name name="ensure_started" arity="1"/> <name name="ensure_started" arity="2"/> <fsummary>Load and start an application</fsummary> - <desc> - <p>Equivalent to <seealso marker="#start/2"><c>application:start/1,2</c></seealso> except - it returns <c>ok</c> for already started applications.</p> - </desc> - </func> + <desc> + <p>Equivalent to <seealso marker="#start/2"><c>application:start/1,2</c></seealso> except + it returns <c>ok</c> for already started applications.</p> + </desc> + </func> + <func> + <name name="ensure_all_started" arity="1"/> + <name name="ensure_all_started" arity="2"/> + <fsummary>Load and start an application and its dependencies, recursively</fsummary> + <desc> + <p>Equivalent to calling <seealso marker="#start/2"><c>application:start/1,2</c></seealso> + repeatedly on all dependencies that have not yet been started for an application. + The function returns <c>{ok, AppNames}</c> for a successful start or for an already started + application (which are however omitted from the <c>AppNames</c> list), and reports + <c>{error, {AppName,Reason}}</c> for errors, where <c>Reason</c> is any possible reason + returned by <seealso marker="#start/2"><c>application:start/1,2</c></seealso> when starting a + specific dependency. In case of an error, the applications that were started by the + function are stopped to bring the set of running applications back to its initial state.</p> + </desc> + </func> <func> <name name="start" arity="1"/> <name name="start" arity="2"/> |