diff options
| author | Fredrik Gustafsson <[email protected]> | 2013-08-21 11:06:01 +0200 |
|---|---|---|
| committer | Fredrik Gustafsson <[email protected]> | 2013-08-21 11:06:01 +0200 |
| commit | 3cc53db7071988cd8dad0d67c85b3e08a7c6818e (patch) | |
| tree | 273584caa1d8004737cf04a11a4fc6059118634d /lib/kernel/doc | |
| parent | 5960967a506c2eeadb3cbf66a1e21fff5000f08b (diff) | |
| parent | af48b10b5d8628ecec95643dfec297b30d3b7810 (diff) | |
| download | otp-3cc53db7071988cd8dad0d67c85b3e08a7c6818e.tar.gz otp-3cc53db7071988cd8dad0d67c85b3e08a7c6818e.tar.bz2 otp-3cc53db7071988cd8dad0d67c85b3e08a7c6818e.zip | |
Merge branch 'fh/start-all/OTP-11250' into maint
* fh/start-all/OTP-11250:
kernel: fix documentation regarding ensure_all_started endtag
Updated primary bootstrap
Add application:ensure_all_started/1-2
Diffstat (limited to 'lib/kernel/doc')
| -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 362c373c6c..3909b11e59 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"/> |