From ad6e765bcd4f35a282ef00e38ed9129f3a5c1d83 Mon Sep 17 00:00:00 2001 From: Hans Bolinder Date: Thu, 1 Sep 2016 14:32:27 +0200 Subject: doc: Correct errors introduced by Editorial changes Fix some older errors as well. --- lib/asn1/doc/src/asn1_getting_started.xml | 2 +- lib/asn1/doc/src/asn1_introduction.xml | 2 +- lib/asn1/doc/src/notes.xml | 4 +- lib/common_test/doc/src/common_test_app.xml | 2 +- lib/common_test/doc/src/ct.xml | 6 +- lib/common_test/doc/src/ct_hooks.xml | 2 +- lib/common_test/doc/src/ct_hooks_chapter.xml | 8 +- lib/common_test/doc/src/ct_ssh.xml | 106 +++---- lib/common_test/doc/src/ct_telnet.xml | 2 +- lib/common_test/doc/src/event_handler_chapter.xml | 6 +- lib/common_test/doc/src/introduction.xml | 2 +- lib/common_test/doc/src/run_test_chapter.xml | 6 +- lib/common_test/doc/src/write_test_chapter.xml | 10 +- lib/compiler/doc/src/compile.xml | 6 +- lib/compiler/doc/src/notes.xml | 4 +- lib/compiler/doc/src/ref_man.xml | 2 +- lib/crypto/doc/src/notes.xml | 2 +- lib/debugger/doc/src/i.xml | 4 +- lib/inets/doc/src/http_server.xml | 36 +-- lib/inets/doc/src/httpc.xml | 4 +- lib/inets/doc/src/httpd.xml | 16 +- lib/inets/doc/src/mod_auth.xml | 2 +- lib/kernel/doc/src/app.xml | 6 +- lib/kernel/doc/src/application.xml | 6 +- lib/kernel/doc/src/auth.xml | 4 +- lib/kernel/doc/src/code.xml | 12 +- lib/kernel/doc/src/erl_boot_server.xml | 4 +- lib/kernel/doc/src/erl_ddll.xml | 6 +- lib/kernel/doc/src/error_logger.xml | 30 +- lib/kernel/doc/src/file.xml | 28 +- lib/kernel/doc/src/gen_tcp.xml | 6 +- lib/kernel/doc/src/inet.xml | 22 +- lib/kernel/doc/src/init_stub.xml | 2 +- lib/kernel/doc/src/kernel_app.xml | 20 +- lib/kernel/doc/src/net_kernel.xml | 12 +- lib/kernel/doc/src/notes.xml | 2 +- lib/kernel/doc/src/rpc.xml | 4 +- lib/kernel/doc/src/zlib_stub.xml | 2 +- lib/mnesia/doc/src/Mnesia_chap1.xml | 28 +- lib/mnesia/doc/src/Mnesia_chap8.xml | 8 +- lib/mnesia/doc/src/Mnesia_overview.xml | 42 +-- lib/mnesia/doc/src/mnesia.xml | 336 +++++++++++----------- lib/mnesia/doc/src/mnesia_frag_hash.xml | 12 +- lib/mnesia/doc/src/mnesia_registry.xml | 12 +- lib/mnesia/doc/src/part.xml | 2 +- lib/mnesia/doc/src/ref_man.xml | 2 +- lib/observer/doc/src/ttb.xml | 2 +- lib/odbc/doc/src/notes.xml | 2 +- lib/parsetools/doc/src/yecc.xml | 2 +- lib/reltool/doc/src/notes.xml | 4 +- lib/reltool/doc/src/part.xml | 2 +- lib/reltool/doc/src/ref_man.xml | 2 +- lib/reltool/doc/src/reltool.xml | 8 +- lib/reltool/doc/src/reltool_intro.xml | 4 +- lib/runtime_tools/doc/src/dbg.xml | 2 +- lib/runtime_tools/doc/src/notes.xml | 2 +- lib/sasl/doc/src/alarm_handler.xml | 4 +- lib/sasl/doc/src/appup.xml | 10 +- lib/sasl/doc/src/error_logging.xml | 18 +- lib/sasl/doc/src/notes.xml | 2 +- lib/sasl/doc/src/part.xml | 2 +- lib/sasl/doc/src/rb.xml | 6 +- lib/sasl/doc/src/ref_man.xml | 2 +- lib/sasl/doc/src/rel.xml | 6 +- lib/sasl/doc/src/release_handler.xml | 20 +- lib/sasl/doc/src/sasl_app.xml | 24 +- lib/sasl/doc/src/sasl_intro.xml | 2 +- lib/sasl/doc/src/systools.xml | 6 +- lib/ssh/doc/src/ssh.xml | 6 +- lib/ssh/doc/src/ssh_app.xml | 4 +- lib/ssh/doc/src/ssh_channel.xml | 2 +- lib/ssl/doc/src/ssl_distribution.xml | 4 +- lib/stdlib/doc/src/dets.xml | 2 +- lib/stdlib/doc/src/ets.xml | 6 +- lib/stdlib/doc/src/notes.xml | 4 +- lib/stdlib/doc/src/proc_lib.xml | 4 +- lib/stdlib/doc/src/stdlib_app.xml | 8 +- lib/stdlib/doc/src/timer.xml | 2 +- lib/stdlib/doc/src/unicode_usage.xml | 8 +- lib/stdlib/doc/src/zip.xml | 6 +- lib/tools/doc/src/xref_chapter.xml | 6 +- 81 files changed, 518 insertions(+), 518 deletions(-) (limited to 'lib') diff --git a/lib/asn1/doc/src/asn1_getting_started.xml b/lib/asn1/doc/src/asn1_getting_started.xml index 3c8ec24723..d40b294c39 100644 --- a/lib/asn1/doc/src/asn1_getting_started.xml +++ b/lib/asn1/doc/src/asn1_getting_started.xml @@ -678,7 +678,7 @@ ok 1081,32,1043,1085,1086,1084]

For details, see the unicode - module in stdlib.

+ module in STDLIB.

In the following example, this ASN.1 specification is used:

diff --git a/lib/asn1/doc/src/asn1_introduction.xml b/lib/asn1/doc/src/asn1_introduction.xml
index d8b81aa467..e4f406364d 100644
--- a/lib/asn1/doc/src/asn1_introduction.xml
+++ b/lib/asn1/doc/src/asn1_introduction.xml
@@ -30,7 +30,7 @@
     asn1_introduction.xml
   
 
-  
The ASN.1 application provides the following:

+  
The ASN.1 application provides the following:

 
   
     An ASN.1 compiler for Erlang, which generates encode and
diff --git a/lib/asn1/doc/src/notes.xml b/lib/asn1/doc/src/notes.xml
index 68d335f451..ac3d9c828e 100644
--- a/lib/asn1/doc/src/notes.xml
+++ b/lib/asn1/doc/src/notes.xml
@@ -329,7 +329,7 @@
         
         
           

-	    The asn1 application would fail to build if the
+	    The ASN.1 application would fail to build if the
 	    .erlang file printed something to standard output.

           

 	    Own Id: OTP-11360

@@ -997,7 +997,7 @@
 	    also been extended.  The configure
 	    scripts of erl_interface and odbc now
 	    search for thread libraries and thread library quirks the
-	    same way as erts do.  The
+	    same way as ERTS do.  The
 	    configure script of the odbc application
 	    now also looks for odbc libraries in lib64 and
 	    lib/64 directories when building on a 64-bit
diff --git a/lib/common_test/doc/src/common_test_app.xml b/lib/common_test/doc/src/common_test_app.xml
index 3f83747485..48ffe653e4 100644
--- a/lib/common_test/doc/src/common_test_app.xml
+++ b/lib/common_test/doc/src/common_test_app.xml
@@ -566,7 +566,7 @@
 	  (which also causes the test case process to terminate).

 
 	
Elements from the Config list can, for example, be read
-	  with proplists:get_value/2 in STDLIB
+	  with proplists:get_value/2 in STDLIB
 	  (or the macro ?config defined in ct.hrl).

 
 	
If you decide not to run the test case after all, return
diff --git a/lib/common_test/doc/src/ct.xml b/lib/common_test/doc/src/ct.xml
index 264bcff251..ffc64cba67 100644
--- a/lib/common_test/doc/src/ct.xml
+++ b/lib/common_test/doc/src/ct.xml
@@ -777,7 +777,7 @@
           caught by any installed event manager.

 
         
See also
-          stdlib:gen_event(3).

+          gen_event(3).

       
     
 
@@ -1236,7 +1236,7 @@
         Millisecs = integer() | float()
       
       
-        
This function, similar to timer:sleep/1 in STDLIB, 
+        
This function, similar to timer:sleep/1 in STDLIB,
           suspends the test case for a specified time.
           However, this function also multiplies Time with the
           multiply_timetraps value (if set) and under certain
@@ -1330,7 +1330,7 @@
           caught by any installed event manager.

 
         
See also
-          stdlib:gen_event(3).
+          gen_event(3).
         

       
     
diff --git a/lib/common_test/doc/src/ct_hooks.xml b/lib/common_test/doc/src/ct_hooks.xml
index 3b1e564b66..c2cf29c530 100644
--- a/lib/common_test/doc/src/ct_hooks.xml
+++ b/lib/common_test/doc/src/ct_hooks.xml
@@ -94,7 +94,7 @@
           ct_hooks:id/1,
           or a reference (created using
           erlang:make_ref/0
-          in ERTS) if
+          in ERTS) if
           ct_hooks:id/1
           is not implemented.

 
diff --git a/lib/common_test/doc/src/ct_hooks_chapter.xml b/lib/common_test/doc/src/ct_hooks_chapter.xml
index 1998f15697..0e4c35e11f 100644
--- a/lib/common_test/doc/src/ct_hooks_chapter.xml
+++ b/lib/common_test/doc/src/ct_hooks_chapter.xml
@@ -374,7 +374,7 @@
      Example CTH
      
The following CTH logs information about a test run into a format 
        parseable by file:consult/1 
-       (in Kernel):
+       (in Kernel):
      

      
  %%% @doc Common Test Example Common Test Hook module.
@@ -499,13 +499,13 @@
        cth_log_redirect
        
        
Built-in

-       
Captures all error_logger and SASL logging 
+       
Captures all error_logger and SASL logging
 	events and prints them to the current test case log. If an event cannot be 
 	associated with a test case, it is printed in the Common Test framework log. 
 	This happens for test cases running in parallel and events occuring
 	in-between test cases. You can configure the level of
-	SASL events report
-	using the normal SASL mechanisms.

+	SASL events report
+	using the normal SASL mechanisms.

        
        cth_surefire
        
diff --git a/lib/common_test/doc/src/ct_ssh.xml b/lib/common_test/doc/src/ct_ssh.xml
index d00737aa5a..137e4c3f1d 100644
--- a/lib/common_test/doc/src/ct_ssh.xml
+++ b/lib/common_test/doc/src/ct_ssh.xml
@@ -64,7 +64,7 @@
     
ConnType = ssh | sftp.

 
     
For other types, see
-      ssh:ssh(3).

+      ssh(3).

 
     
All time-out parameters in ct_ssh functions are values in
       milliseconds.

@@ -88,7 +88,7 @@
       ssh_sftp_return() = term()
       
         
Return value from an
-          ssh:ssh_sftp
+          ssh_sftp
             function.

     
   
@@ -104,7 +104,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -118,7 +118,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -132,7 +132,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -146,7 +146,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -160,7 +160,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -174,7 +174,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -188,7 +188,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -202,7 +202,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -216,7 +216,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -230,7 +230,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -310,7 +310,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -324,7 +324,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -338,7 +338,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -352,7 +352,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -423,7 +423,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -437,7 +437,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -451,7 +451,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -465,7 +465,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -479,7 +479,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -493,7 +493,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -507,7 +507,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -521,7 +521,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -535,7 +535,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -549,7 +549,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -563,7 +563,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -577,7 +577,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -591,7 +591,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -605,7 +605,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -619,7 +619,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -633,7 +633,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -647,7 +647,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -661,7 +661,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -675,7 +675,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -689,7 +689,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -703,7 +703,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -717,7 +717,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -731,7 +731,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -745,7 +745,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -759,7 +759,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -773,7 +773,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -787,7 +787,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -801,7 +801,7 @@
       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -853,7 +853,7 @@ ChannelId, End, DefaultTimeout).

 
         
If End is a fun, this fun is called with one argument, the
           data value in a received ssh_cm message (see
-          ssh:ssh_connection(3).
+          ssh_connection(3).
           The fun is to return either true to end the receiving
           operation (and have the so far collected data returned) or
           false to wait for more data from the server. Even if a fun
@@ -872,7 +872,7 @@ ChannelId, End, DefaultTimeout).

       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -886,7 +886,7 @@ ChannelId, End, DefaultTimeout).

       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -1070,7 +1070,7 @@ ChannelId, 0, Data, End, Timeout).

       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -1084,7 +1084,7 @@ ChannelId, 0, Data, End, Timeout).

       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -1098,7 +1098,7 @@ ChannelId, 0, Data, End, Timeout).

       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -1112,7 +1112,7 @@ ChannelId, 0, Data, End, Timeout).

       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -1126,7 +1126,7 @@ ChannelId, 0, Data, End, Timeout).

       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
 
@@ -1140,7 +1140,7 @@ ChannelId, 0, Data, End, Timeout).

       
       
         
For information and other types, see
-          ssh:ssh_sftp(3).

+          ssh_sftp(3).

       
     
   
diff --git a/lib/common_test/doc/src/ct_telnet.xml b/lib/common_test/doc/src/ct_telnet.xml
index e2a45e894b..eba3c3030d 100644
--- a/lib/common_test/doc/src/ct_telnet.xml
+++ b/lib/common_test/doc/src/ct_telnet.xml
@@ -198,7 +198,7 @@
       
         
Regular expression matching all possible prompts for a specific
           target type. regexp must not have any groups, that is, when
-          matching, re:run/3 (in STDLIB) must return a list with
+          matching, re:run/3 (in STDLIB) must return a list with
           one single element.

     
   
diff --git a/lib/common_test/doc/src/event_handler_chapter.xml b/lib/common_test/doc/src/event_handler_chapter.xml
index 2978226a19..bd9ed21cb4 100644
--- a/lib/common_test/doc/src/event_handler_chapter.xml
+++ b/lib/common_test/doc/src/event_handler_chapter.xml
@@ -50,7 +50,7 @@
     pass the information on. The event handlers are Erlang modules
     implemented by the Common Test user according to the gen_event 
     behavior (for details, see module
-    stdlib:gen_event and
+    gen_event and
     section
     gen_event Behaviour
     in OTP Design Principles in the System Documentation).
@@ -69,8 +69,8 @@
     manager, either by telling Common Test to install them before the test
     run (described later), or by adding the handlers dynamically during the test
     run using
-    stdlib:gen_event:add_handler/3 or 
-    stdlib:gen_event:add_sup_handler/3.
+    gen_event:add_handler/3 or
+    gen_event:add_sup_handler/3.
     In the latter scenario, the reference of the Common Test event manager is
     required. To get it, call 
     ct:get_event_mgr_ref/0 
diff --git a/lib/common_test/doc/src/introduction.xml b/lib/common_test/doc/src/introduction.xml
index 40724f24e9..df12bea6dd 100644
--- a/lib/common_test/doc/src/introduction.xml
+++ b/lib/common_test/doc/src/introduction.xml
@@ -45,7 +45,7 @@
       
       
Common Test also integrates use of the OTP
       cover tool in application 
-      Tools for code coverage analysis of Erlang/OTP programs.

+      Tools for code coverage analysis of Erlang/OTP programs.

       
       
Common Test executes test suite programs automatically,
       without operator interaction. Test progress and results are
diff --git a/lib/common_test/doc/src/run_test_chapter.xml b/lib/common_test/doc/src/run_test_chapter.xml
index 43e36adfb6..76e306c4ed 100644
--- a/lib/common_test/doc/src/run_test_chapter.xml
+++ b/lib/common_test/doc/src/run_test_chapter.xml
@@ -274,7 +274,7 @@
 
     
Directories passed to Common Test can have either relative or absolute paths.

 
-    
Any start flags to the Erlang runtime system (application ERTS) can also be passed as
+    
Any start flags to the Erlang runtime system (application ERTS) can also be passed as
              parameters to ct_run. It is, for example, useful to be able to
 	     pass directories to be added to the Erlang code server search path
 	     with flag -pa or -pz. If you have common help- or library 
@@ -286,7 +286,7 @@
 	  
The absolute path of directory chat_server/ebin
 	     is here passed to the code server. This is essential because relative
 	     paths are stored by the code server as relative, and Common Test changes 
-	     the current working directory of ERTS during the test run.

+	     the current working directory of ERTS during the test run.

     
     
     
The ct_run program sets the exit status before shutting down. The following values
@@ -1258,7 +1258,7 @@
       
The minor log files contain full details of every single test
 	case, each in a separate file. This way, it is
 	straightforward	to compare the latest results to that of previous
-	test runs, even if the set of test cases changes. If application SASL 
+	test runs, even if the set of test cases changes. If application SASL
 	is running, its logs are also printed to the current minor log file by the
 	
 	  cth_log_redirect built-in hook.
diff --git a/lib/common_test/doc/src/write_test_chapter.xml b/lib/common_test/doc/src/write_test_chapter.xml
index 83daf771a6..7bd2ccf588 100644
--- a/lib/common_test/doc/src/write_test_chapter.xml
+++ b/lib/common_test/doc/src/write_test_chapter.xml
@@ -269,10 +269,10 @@
     
     
As parameter Config is a list of key-value tuples, that is,
     a data type called a property list, it can be handled by the
-    stdlib:proplists module. 
+    proplists module.
     A value can, for example, be searched for and returned with function 
     proplists:get_value/2.
-    Also, or alternatively, the general stdlib:lists 
+    Also, or alternatively, the general lists
     module contains useful functions. Normally, the only operations 
     performed on Config is insert (adding a tuple to the head of the list) 
     and lookup. Common Test provides a simple macro named ?config, 
@@ -652,7 +652,7 @@
     Parallel Test Cases and I/O
     
A parallel test case has a private I/O server as its group leader. 
       (For a description of the group leader concept, see
-      ERTS). 
+      ERTS).
       The central I/O server process, which handles the output from 
       regular test cases and configuration functions, does not respond to I/O messages
       during execution of parallel groups. This is important to understand
@@ -1032,8 +1032,8 @@
  6. Categorized error, importance = 99

The arguments Format and FormatArgs in ct:log/print/pal are - always passed on to the stdlib function io:format/3 (For details, - see the stdlib:io manual page).

+ always passed on to the STDLIB function io:format/3 (For details, + see the io manual page).

ct:pal/4 and ct:log/5 add headers to strings being printed to the log file. The strings are also wrapped in div tags with a CSS class diff --git a/lib/compiler/doc/src/compile.xml b/lib/compiler/doc/src/compile.xml index 61e214294e..3ce37b98e9 100644 --- a/lib/compiler/doc/src/compile.xml +++ b/lib/compiler/doc/src/compile.xml @@ -136,7 +136,7 @@ (see The Abstract Format in ERTS User's Guide) in the compiled beam module. Tools - such as Debugger, Xref, and Cover require + such as Debugger, Xref, and Cover require the debug information to be included.

Warning: Source code can be reconstructed from @@ -544,7 +544,7 @@ module.beam: module.erl \ compiler to be deprecated. Notice that the compiler does not know about attribute -deprecated(), but uses an assembled list of deprecated functions in Erlang/OTP. To - do a more general check, the Xref tool can be used. + do a more general check, the Xref tool can be used. See also xref(3) and the function @@ -846,7 +846,7 @@ pi() -> 3.1416.

Inlining of List Functions

The compiler can also inline various list manipulation functions - from the module list in STDLIB.

+ from the module list in STDLIB.

This feature must be explicitly enabled with a compiler option or a -compile() attribute in the source module.

diff --git a/lib/compiler/doc/src/notes.xml b/lib/compiler/doc/src/notes.xml index 92b3d809fc..dd6b132a92 100644 --- a/lib/compiler/doc/src/notes.xml +++ b/lib/compiler/doc/src/notes.xml @@ -280,7 +280,7 @@

The cerl and cerl_trees modules in the - compiler application are now documented.

+ Compiler application are now documented.

Own Id: OTP-11978

 @@ -1982,7 +1982,7 @@ RightExpr or vice versa. The evaluation order is only important if the expressions contains and/or depends on operations with side-effects, such as message passing - or ets operations.

+ or ETS operations.

Own Id: OTP-7206

diff --git a/lib/compiler/doc/src/ref_man.xml b/lib/compiler/doc/src/ref_man.xml index f5466553c0..c32c499008 100644 --- a/lib/compiler/doc/src/ref_man.xml +++ b/lib/compiler/doc/src/ref_man.xml @@ -30,7 +30,7 @@ application.sgml -

The Compiler application compiles Erlang +

The Compiler application compiles Erlang code to byte-code. The highly compact byte-code is executed by the Erlang emulator.

 diff --git a/lib/crypto/doc/src/notes.xml b/lib/crypto/doc/src/notes.xml index 7d3a85326f..56e165a1d1 100644 --- a/lib/crypto/doc/src/notes.xml +++ b/lib/crypto/doc/src/notes.xml @@ -815,7 +815,7 @@ also been extended. The configure scripts of erl_interface and odbc now search for thread libraries and thread library quirks the - same way as erts do. The + same way as ERTS do. The configure script of the odbc application now also looks for odbc libraries in lib64 and lib/64 directories when building on a 64-bit diff --git a/lib/debugger/doc/src/i.xml b/lib/debugger/doc/src/i.xml index db89f23494..628b91e9e4 100644 --- a/lib/debugger/doc/src/i.xml +++ b/lib/debugger/doc/src/i.xml @@ -45,7 +45,7 @@ attached manually or automatically.

By preference, these functions can be included in module - stdlib:shell_default. + shell_default. By default, they are included in that module.

@@ -372,7 +372,7 @@

Returns the current version number of the interpreter. - Same as the version number of the Debugger application.

+ Same as the version number of the Debugger application.

 diff --git a/lib/inets/doc/src/http_server.xml b/lib/inets/doc/src/http_server.xml index aeda961714..65b3dcde95 100644 --- a/lib/inets/doc/src/http_server.xml +++ b/lib/inets/doc/src/http_server.xml @@ -4,7 +4,7 @@
- 20042015 + 20042016 Ericsson AB. All Rights Reserved. @@ -40,8 +40,8 @@ Secure Sockets Layer (SSL) Erlang Scripting Interface (ESI) Common Gateway Interface (CGI) - User Authentication (using Mnesia, - Dets or plain text database) + User Authentication (using Mnesia, + Dets or plain text database) Common Logfile Format (with or without disk_log(3) support) URL Aliasing Action Mappings @@ -563,7 +563,7 @@ http://your.server.org/eval?httpd_example:print(atom_to_list(apply(erlang,halt,[ mod_auth - User Authentication

The mod_auth(3) module provides for basic user authentication using - textual files, Dets databases as well as Mnesia databases.

+ textual files, Dets databases as well as Mnesia databases.

Uses the following Erlang Web Server API interaction data:

@@ -580,15 +580,15 @@ http://your.server.org/eval?httpd_example:print(atom_to_list(apply(erlang,halt,[
Mnesia As Authentication Database -

If Mnesia is used as storage method, Mnesia must be - started before the HTTP server. The first time Mnesia is +

If Mnesia is used as storage method, Mnesia must be + started before the HTTP server. The first time Mnesia is started, the schema and the tables must be created before - Mnesia is started. A simple example of a module with two - functions that creates and start Mnesia is provided + Mnesia is started. A simple example of a module with two + functions that creates and start Mnesia is provided here. Function first_start/0 is to be used the first time. It creates the schema and the tables. start/0 is to be used in consecutive startups. - start/0 starts Mnesia and waits for the tables to + start/0 starts Mnesia and waits for the tables to be initiated. This function must only be used when the schema and the tables are already created.

@@ -616,25 +616,25 @@ start() -> mnesia:start(), mnesia:wait_for_tables([httpd_user, httpd_group], 60000). -

To create the Mnesia tables, we use two records defined in +

To create the Mnesia tables, we use two records defined in mod_auth.hrl, so that file must be included. first_start/0 creates a schema that specifies on which nodes the database is to reside. - Then it starts Mnesia and creates the tables. The first argument + Then it starts Mnesia and creates the tables. The first argument is the name of the tables, the second argument is a list of options of how to create the table, see - mnesia, documentation for + mnesia(3), documentation for more information. As the implementation of the mod_auth_mnesia saves one row for each user, the type must be bag. When the schema and the tables are created, function mnesia:start/0 - is used to start Mnesia and - waits for the tables to be loaded. Mnesia uses the + is used to start Mnesia and + waits for the tables to be loaded. Mnesia uses the directory specified as mnesia_dir at startup if specified, - otherwise Mnesia uses the current directory. For security - reasons, ensure that the Mnesia tables are stored outside + otherwise Mnesia uses the current directory. For security + reasons, ensure that the Mnesia tables are stored outside the document tree of the HTTP server. If they are placed in the directory which it protects, clients can download the tables. - Only the Dets and Mnesia storage + Only the Dets and Mnesia storage methods allow writing of dynamic user data to disk. plain is a read only method.

@@ -669,7 +669,7 @@ start() ->
mod_disk_log - Logging Using Disk_Log.

Standard logging using the "Common Logfile Format" and - kernel:disk_log(3).

+ disk_log(3).

Uses the following Erlang Web Server API interaction data:

diff --git a/lib/inets/doc/src/httpc.xml b/lib/inets/doc/src/httpc.xml index ca9b268a03..13471aab2c 100644 --- a/lib/inets/doc/src/httpc.xml +++ b/lib/inets/doc/src/httpc.xml @@ -4,7 +4,7 @@
- 20042015 + 20042016 Ericsson AB. All Rights Reserved. @@ -72,7 +72,7 @@

profile() = atom()

path() = string() representing a file path or directory path

ip_address() = See the - inet(3) manual page in Kernel.

+ inet(3) manual page in Kernel.

socket_opt() = See the options used by gen_tcp(3) gen_tcp(3) and ssl(3) connect(s)

diff --git a/lib/inets/doc/src/httpd.xml b/lib/inets/doc/src/httpd.xml index b05ae72983..d74635fc01 100644 --- a/lib/inets/doc/src/httpd.xml +++ b/lib/inets/doc/src/httpd.xml @@ -4,7 +4,7 @@
- 19972015 + 19972016 Ericsson AB. All Rights Reserved. @@ -711,7 +711,7 @@ text/plain asc txt

Sets the type of authentication database that is used for the directory. The key difference between the different methods is - that dynamic data can be saved when Mnesia and Dets + that dynamic data can be saved when Mnesia and Dets are used. This property is called AuthDbType in the Apache-like configuration files.

@@ -731,10 +731,10 @@ text/plain asc txt ragnar:s7Xxv7 edward:wwjau8 -

If the Dets storage method is used, the user database is - maintained by Dets and must not be edited by hand. Use the +

If the Dets storage method is used, the user database is + maintained by Dets and must not be edited by hand. Use the API functions in module mod_auth to create/edit the user - database. This directive is ignored if the Mnesia + database. This directive is ignored if the Mnesia storage method is used. For security reasons, ensure that auth_user_file is stored outside the document tree of the web server. If it is placed in the directory that it protects, @@ -753,10 +753,10 @@ text/plain asc txt group1: bob joe ante -

If the Dets storage method is used, the group database is - maintained by Dets and must not be edited by hand. Use the +

If the Dets storage method is used, the group database is + maintained by Dets and must not be edited by hand. Use the API for module mod_auth to create/edit the group database. - This directive is ignored if the Mnesia storage method is used. + This directive is ignored if the Mnesia storage method is used. For security reasons, ensure that the auth_group_file is stored outside the document tree of the web server. If it is placed in the directory that it protects, clients diff --git a/lib/inets/doc/src/mod_auth.xml b/lib/inets/doc/src/mod_auth.xml index 4b7088b2c5..c4f844622b 100644 --- a/lib/inets/doc/src/mod_auth.xml +++ b/lib/inets/doc/src/mod_auth.xml @@ -33,7 +33,7 @@ User authentication using text files, Dets, or Mnesia database.

This module provides for basic user authentication using - textual files, Dets databases, or Mnesia databases.

+ textual files, Dets databases, or Mnesia databases.

diff --git a/lib/kernel/doc/src/app.xml b/lib/kernel/doc/src/app.xml index 5e0da409a3..d2e9390d7e 100644 --- a/lib/kernel/doc/src/app.xml +++ b/lib/kernel/doc/src/app.xml @@ -151,7 +151,7 @@ ApplicationVersion = string() application is allowed to be started. systools uses this list to generate correct start scripts. Defaults to the empty list, but notice that all applications have - dependencies to (at least) Kernel and STDLIB.

+ dependencies to (at least) Kernel and STDLIB.

 env @@ -171,7 +171,7 @@ ApplicationVersion = string() implemented as a supervision tree, otherwise the application controller does not know how to start it. mod can be omitted for applications without processes, typically - code libraries, for example, STDLIB.

+ code libraries, for example, STDLIB.

 start_phases @@ -236,7 +236,7 @@ ApplicationVersion = string()
See Also

application(3), - sasl:systools(3)

+ systools(3)

diff --git a/lib/kernel/doc/src/application.xml b/lib/kernel/doc/src/application.xml index 8d33aa86e7..886286b76d 100644 --- a/lib/kernel/doc/src/application.xml +++ b/lib/kernel/doc/src/application.xml @@ -200,7 +200,7 @@ app(4).

If Distributed == {Application,[Time,]Nodes}, the application becomes distributed. The argument overrides - the value for the application in the Kernel configuration + the value for the application in the Kernel configuration parameter distributed. Application must be the application name (same as in the first argument). If a node crashes and Time is specified, @@ -221,7 +221,7 @@ Nodes = [cp1@cave, {cp2@cave, cp3@cave}] the application is to be started at cp2@cave or cp3@cave.

If Distributed == default, the value for - the application in the Kernel configuration parameter + the application in the Kernel configuration parameter distributed is used.

@@ -267,7 +267,7 @@ Nodes = [cp1@cave, {cp2@cave, cp3@cave}] started, Application is started as well.

By default, all applications are loaded with permission true on all nodes. The permission can be configured - using the Kernel configuration parameter permissions.

+ using the Kernel configuration parameter permissions.

diff --git a/lib/kernel/doc/src/auth.xml b/lib/kernel/doc/src/auth.xml index 03f983b96d..5901446960 100644 --- a/lib/kernel/doc/src/auth.xml +++ b/lib/kernel/doc/src/auth.xml @@ -47,7 +47,7 @@

Use erlang:get_cookie() - in ERTS instead.

+ in ERTS instead.

 @@ -59,7 +59,7 @@

Use erlang:set_cookie(node(), Cookie) - in ERTS instead.

+ in ERTS instead.

 diff --git a/lib/kernel/doc/src/code.xml b/lib/kernel/doc/src/code.xml index 21f8a2d54a..4db377bcde 100644 --- a/lib/kernel/doc/src/code.xml +++ b/lib/kernel/doc/src/code.xml @@ -86,11 +86,11 @@ an ebin directory are ignored.

All application directories found in the additional directories appears before the standard OTP applications, except for the - Kernel and STDLIB applications, which are placed before + Kernel and STDLIB applications, which are placed before any additional applications. In other words, modules found in any of the additional library directories override modules with - the same name in OTP, except for modules in Kernel and - STDLIB.

+ the same name in OTP, except for modules in Kernel and + STDLIB.

Environment variable ERL_LIBS (if defined) is to contain a colon-separated (for Unix-like systems) or semicolon-separated (for Windows) list of additional libraries.

@@ -151,7 +151,7 @@ zip:create("mnesia-4.4.7.ez", $OTPROOT/lib/mnesia.ez/mnesia/ebin or $OTPROOT/lib/mnesia-4.4.7.ez/mnesia-4.4.7/ebin.

-

The code server uses module erl_prim_loader in ERTS +

The code server uses module erl_prim_loader in ERTS (possibly through erl_boot_server) to read code files from archives. However, the functions in erl_prim_loader can also be used by other applications to read files from archives. For @@ -688,9 +688,9 @@ ok = code:finish_loading(Prepared),

Normally, Loaded is the absolute filename Filename from which the code is obtained. If the module is preloaded (see - sasl:script(4)), + script(4)), Loaded==preloaded. If the module is Cover-compiled (see - tools:cover(3)), + cover(3)), Loaded==cover_compiled.

 diff --git a/lib/kernel/doc/src/erl_boot_server.xml b/lib/kernel/doc/src/erl_boot_server.xml index 897365f9b9..4109251387 100644 --- a/lib/kernel/doc/src/erl_boot_server.xml +++ b/lib/kernel/doc/src/erl_boot_server.xml @@ -38,13 +38,13 @@ command-line flag -loader inet. All hosts specified with command-line flag -hosts Host must have one instance of this server running.

-

This server can be started with the Kernel configuration +

This server can be started with the Kernel configuration parameter start_boot_server.

The erl_boot_server can read regular files and files in archives. See code(3) and erl_prim_loader(3) - in ERTS.

+ in ERTS.

The support for loading code from archive files is experimental. It is released before it is ready to obtain early feedback. The file format, semantics, diff --git a/lib/kernel/doc/src/erl_ddll.xml b/lib/kernel/doc/src/erl_ddll.xml index a5ce58ef3e..75114e015c 100644 --- a/lib/kernel/doc/src/erl_ddll.xml +++ b/lib/kernel/doc/src/erl_ddll.xml @@ -201,7 +201,7 @@

Removes a driver monitor in much the same way as erlang:demonitor/1 - in ERTS + in ERTS does with process monitors. For details about how to create driver monitors, see monitor/2, @@ -431,7 +431,7 @@

Creates a driver monitor and works in many ways as erlang:monitor/2 - in ERTS, + in ERTS, does for processes. When a driver changes state, the monitor results in a monitor message that is sent to the calling process. MonitorRef returned by this function is @@ -745,7 +745,7 @@

This parameter is the name of the driver to be used in subsequent calls to function erlang:open_port - in ERTS. + in ERTS. The name can be specified as an iolist() or an atom(). The name specified when loading is used to find the object file (with the help of Path diff --git a/lib/kernel/doc/src/error_logger.xml b/lib/kernel/doc/src/error_logger.xml index a8273e59e2..814e8eac46 100644 --- a/lib/kernel/doc/src/error_logger.xml +++ b/lib/kernel/doc/src/error_logger.xml @@ -33,7 +33,7 @@

The Erlang error logger is an event manager (see OTP Design Principles and - stdlib:gen_event(3)), + gen_event(3)), registered as error_logger. Errors, warnings, and info events are sent to the error logger from the Erlang runtime system and the different Erlang/OTP applications. The events are, by default, @@ -44,12 +44,12 @@ executing.

Initially, error_logger has only a primitive event handler, which buffers and prints the raw event messages. During - system startup, the Kernel application replaces this with a + system startup, the Kernel application replaces this with a standard event handler, by default one that writes - nicely formatted output to the terminal. Kernel can also be + nicely formatted output to the terminal. Kernel can also be configured so that events are logged to a file instead, or not logged at all, see kernel(6).

-

Also the SASL application, if started, adds its own event +

Also the SASL application, if started, adds its own event handler, which by default writes supervisor, crash, and progress reports to the terminal. See sasl(6).

@@ -58,9 +58,9 @@ User-defined event handlers can be added to handle application-specific events, see add_report_handler/1,2. - Also, a useful event handler is provided in STDLIB for multi-file + Also, a useful event handler is provided in STDLIB for multi-file logging of events, see - stdlib:log_mf_h(3).

+ log_mf_h(3).

Warning events were introduced in Erlang/OTP R9C and are enabled by default as from Erlang/OTP 18.0. To retain backwards compatibility with existing user-defined event handlers, the warning events can be @@ -82,7 +82,7 @@

Adds a new event handler to the error logger. The event handler must be implemented as a gen_event callback module, see - stdlib:gen_event(3).

+ gen_event(3).

Handler is typically the name of the callback module and Args is an optional term (defaults to []) passed to the initialization callback function Handler:init/1. @@ -97,7 +97,7 @@

Deletes an event handler from the error logger by calling gen_event:delete_handler(error_logger, Handler, []), - see stdlib:gen_event(3).

+ see gen_event(3).

@@ -110,7 +110,7 @@ The Format and Data arguments are the same as the arguments of io:format/2 - in STDLIB. + in STDLIB. The event is handled by the standard event handler.

Example:

@@ -171,7 +171,7 @@ ok
The Format and Data arguments are the same as the arguments of io:format/2 - in STDLIB. The event is handled by the standard event handler.

+ in STDLIB. The event is handled by the standard event handler.

Example:

 1> error_logger:info_msg("Something happened in ~p~n", [a_module]).
@@ -235,7 +235,7 @@ ok

Enables or disables printout of standard events to a file.

This is done by adding or deleting the standard event handler for output to file. Thus, calling this function overrides - the value of the Kernel error_logger configuration + the value of the Kernel error_logger configuration parameter.

Enabling file logging can be used together with calling tty(false), to have a silent system where @@ -274,7 +274,7 @@ ok to the terminal.

This is done by adding or deleting the standard event handler for output to the terminal. Thus, calling this function overrides - the value of the Kernel error_logger configuration parameter.

+ the value of the Kernel error_logger configuration parameter.

 @@ -323,7 +323,7 @@ ok The Format and Data arguments are the same as the arguments of io:format/2 - in STDLIB. + in STDLIB. The event is handled by the standard event handler. It is tagged as an error, warning, or info, see warning_map/0.

@@ -416,8 +416,8 @@ ok
See Also -

stdlib:gen_event(3), - stdlib:log_mf_h(3) +

gen_event(3), + log_mf_h(3) kernel(6) sasl(6)

diff --git a/lib/kernel/doc/src/file.xml b/lib/kernel/doc/src/file.xml index 7d86c3ebcb..d734ee25b8 100644 --- a/lib/kernel/doc/src/file.xml +++ b/lib/kernel/doc/src/file.xml @@ -79,7 +79,7 @@ list_dir_all/1 and read_link_all/1.

-

See also section Notes About Raw Filenames in the STDLIB User´s Giude.

+

See also section Notes About Raw Filenames in the STDLIB User´s Giude.

@@ -277,7 +277,7 @@ f.txt: {person, "kalle", 25}. {ok,[{person,"kalle",25},{person,"pelle",30}]}

The encoding of Filename can be set by a comment, as described in - stdlib:epp(3).

+ epp(3).

@@ -445,7 +445,7 @@ f.txt: {person, "kalle", 25}.

The encoding of Filename can be set by a comment, as described in - stdlib:epp(3).

+ epp(3).

 @@ -455,7 +455,7 @@ f.txt: {person, "kalle", 25}.

The same as eval/1, but the variable bindings Bindings are used in the evaluation. For information about the variable bindings, see - stdlib:erl_eval(3).

+ erl_eval(3).

 @@ -830,7 +830,7 @@ f.txt: {person, "kalle", 25}. this module (file) for reading and writing data as the interfaces provided here work with byte-oriented data. Using other (Unicode) encodings makes the - stdlib:io(3) functions + io(3) functions get_chars, get_line, and put_chars more suitable, as they can work with the full Unicode range.

If data is sent to an io_device() in a format that cannot be @@ -847,7 +847,7 @@ f.txt: {person, "kalle", 25}. that is, read/2 are returned "as is". If module - stdlib:io(3) is used for + io(3) is used for writing, the file can only cope with Unicode characters up to code point 255 (the ISO Latin-1 range).

@@ -861,7 +861,7 @@ f.txt: {person, "kalle", 25}. the file lies beyond the ISO Latin-1 range (0..255), but failure occurs if the data contains Unicode code points beyond that range. The file is best read with the functions in the Unicode aware module - stdlib:io(3).

+ io(3).

Bytes written to the file by any means are translated to UTF-8 encoding before being stored on the disk file.

@@ -891,7 +891,7 @@ f.txt: {person, "kalle", 25}. So a file can be analyzed in latin1 encoding for, for example, a BOM, positioned beyond the BOM and then be set for the right encoding before further reading. For functions identifying BOMs, see module - stdlib:unicode(3).

+ unicode(3).

This option is not allowed on raw files.

ram @@ -932,7 +932,7 @@ f.txt: {person, "kalle", 25}. closed and the process itself is terminated. An IoDevice returned from this call can be used as an argument to the I/O functions (see - stdlib:io(3)).

+ io(3)).

In previous versions of file, modes were specified as one of the atoms read, write, or @@ -1055,7 +1055,7 @@ f.txt: {person, "kalle", 25}.

The encoding of Filename can be set by a comment as described in - stdlib:epp(3).

+ epp(3).

 @@ -1128,7 +1128,7 @@ f.txt: {person, "kalle", 25}.

The encoding of Filename can be set by a comment as described in - stdlib:epp(3).

+ epp(3).

 @@ -1389,7 +1389,7 @@ f.txt: {person, "kalle", 25}. {ok, FileInfo} if successful, otherwise {error, Reason}. FileInfo is a record - file_info, defined in the Kernel include file + file_info, defined in the Kernel include file file.hrl. Include the following directive in the module from which the function is called:

@@ -1552,7 +1552,7 @@ f.txt: {person, "kalle", 25}. raw line-oriented reading.

If encoding is set to something else than latin1, the read_line/1 call fails if the data contains characters larger than 255, - why module stdlib:io(3) is to be + why module io(3) is to be preferred when reading such a file.

The function returns:

@@ -1970,7 +1970,7 @@ f.txt: {person, "kalle", 25}.

Changes file information. Returns ok if successful, otherwise {error, Reason}. FileInfo is a record - file_info, defined in the Kernel include file + file_info, defined in the Kernel include file file.hrl. Include the following directive in the module from which the function is called:

diff --git a/lib/kernel/doc/src/gen_tcp.xml b/lib/kernel/doc/src/gen_tcp.xml index 83242c2df8..08454b9832 100644 --- a/lib/kernel/doc/src/gen_tcp.xml +++ b/lib/kernel/doc/src/gen_tcp.xml @@ -216,7 +216,7 @@ do_recv(Sock, Bs) -> time-out in milliseconds. Defaults to infinity.

The default values for options specified to connect can - be affected by the Kernel configuration parameter + be affected by the Kernel configuration parameter inet_default_connect_options. For details, see inet(3).

 @@ -293,7 +293,7 @@ do_recv(Sock, Bs) -> accept/1,2.

The default values for options specified to listen can - be affected by the Kernel configuration parameter + be affected by the Kernel configuration parameter inet_default_listen_options. For details, see inet(3).

 @@ -307,7 +307,7 @@ do_recv(Sock, Bs) -> See the description of HttpPacket in erlang:decode_packet/3 - in ERTS. + in ERTS.

Receives a packet from a socket in passive diff --git a/lib/kernel/doc/src/inet.xml b/lib/kernel/doc/src/inet.xml index 8cc21bf3e2..3f4e3684f4 100644 --- a/lib/kernel/doc/src/inet.xml +++ b/lib/kernel/doc/src/inet.xml @@ -36,7 +36,7 @@ ERTS User's Guide: Inet Configuration for more information about how to configure an Erlang runtime system for IP communication.

-

The following two Kernel configuration parameters affect the +

The following two Kernel configuration parameters affect the behavior of all sockets opened on an Erlang node:

inet_default_connect_options can contain a list of @@ -48,7 +48,7 @@

When accept is issued, the values of the listening socket options are inherited. No such application variable is therefore needed for accept.

-

Using the Kernel configuration parameters above, one +

Using the Kernel configuration parameters above, one can set default options for all TCP sockets on a node, but use this with care. Options such as {delay_send,true} can be specified in this way. The following is an example of starting an Erlang @@ -95,7 +95,7 @@ fe80::204:acff:fe17:bf38 -

The record is defined in the Kernel include file +

The record is defined in the Kernel include file "inet.hrl".

Add the following directive to the module:

@@ -391,7 +391,7 @@ get_tcpi_sacked(Sock) -> <<_:28/binary,TcpiSacked:32/native,_/binary>> = Info, TcpiSacked.]]>

Preferably, you would check the machine type, the operating system, - and the Kernel version before executing anything similar to + and the Kernel version before executing anything similar to this code.

 @@ -661,7 +661,7 @@ get_tcpi_sacked(Sock) ->

The size of the user-level software buffer used by the driver. Not to be confused with options sndbuf and recbuf, which correspond to the - Kernel socket buffers. It is recommended + Kernel socket buffers. It is recommended to have val(buffer) >= max(val(sndbuf),val(recbuf)) to avoid performance issues because of unnecessary copying. val(buffer) is automatically set to the above @@ -720,7 +720,7 @@ get_tcpi_sacked(Sock) ->

The socket message queue is set to a busy state when the amount of data on the message queue reaches this limit. Notice that this limit only - concerns data that has not yet reached the ERTS internal + concerns data that has not yet reached the ERTS internal socket implementation. Defaults to 8 kB.

Senders of data to the socket are suspended if either the socket message queue is busy or the socket @@ -736,7 +736,7 @@ get_tcpi_sacked(Sock) -> {high_watermark, Size} (TCP/IP sockets)

The socket is set to a busy state when the amount - of data queued internally by the ERTS socket implementation + of data queued internally by the ERTS socket implementation reaches this limit. Defaults to 8 kB.

Senders of data to the socket are suspended if either the socket message queue is busy or the socket @@ -816,7 +816,7 @@ get_tcpi_sacked(Sock) -> socket message queue is set in a not busy state when the amount of data queued in the message queue falls below this limit. Notice that this limit only concerns data - that has not yet reached the ERTS internal socket + that has not yet reached the ERTS internal socket implementation. Defaults to 4 kB.

Senders that are suspended because of either a busy message queue or a busy socket are resumed @@ -834,7 +834,7 @@ get_tcpi_sacked(Sock) ->

If the socket is in a busy state, the socket is set in a not busy state when the amount of data - queued internally by the ERTS socket implementation + queued internally by the ERTS socket implementation falls below this limit. Defaults to 4 kB.

Senders that are suspended because of a busy message queue or a busy socket are resumed @@ -954,7 +954,7 @@ setcap cap_sys_admin,cap_sys_ptrace,cap_dac_read_search+epi beam.smp are returned with the format according to HttpPacket described in - erlang:decode_packet/3 in ERTS. + erlang:decode_packet/3 in ERTS. A socket in passive mode returns {ok, HttpPacket} from gen_tcp:recv while an active socket sends messages like @@ -1130,7 +1130,7 @@ inet:setopts(Sock,[{raw,6,8,<<30:32/native>>}]),]]> can respond differently to this kind of option manipulation. Use with care.

Notice that the default options for TCP/IP sockets can be - changed with the Kernel configuration parameters mentioned in + changed with the Kernel configuration parameters mentioned in the beginning of this manual page.

diff --git a/lib/kernel/doc/src/init_stub.xml b/lib/kernel/doc/src/init_stub.xml index df89b174ca..1297c8264d 100644 --- a/lib/kernel/doc/src/init_stub.xml +++ b/lib/kernel/doc/src/init_stub.xml @@ -34,6 +34,6 @@ Coordination of system startup.

This module is moved to the - ERTS application.

+ ERTS application.

 diff --git a/lib/kernel/doc/src/kernel_app.xml b/lib/kernel/doc/src/kernel_app.xml index fb6421e1c5..df681a505f 100644 --- a/lib/kernel/doc/src/kernel_app.xml +++ b/lib/kernel/doc/src/kernel_app.xml @@ -31,12 +31,12 @@ kernel The Kernel application. -

The Kernel application has all the code necessary to run +

The Kernel application has all the code necessary to run the Erlang runtime system: file servers, code servers, and so on.

-

The Kernel application is the first application started. It is +

The Kernel application is the first application started. It is mandatory in the sense that the minimal system based on - Erlang/OTP consists of Kernel and STDLIB. Kernel + Erlang/OTP consists of Kernel and STDLIB. Kernel contains the following functional areas:

Start, stop, supervision, configuration, and distribution of applications @@ -53,13 +53,13 @@
Error Logger Event Handlers

Two standard error logger event handlers are defined in - the Kernel application. These are described in + the Kernel application. These are described in error_logger(3).

Configuration -

The following configuration parameters are defined for the Kernel +

The following configuration parameters are defined for the Kernel application. For more information about configuration parameters, see file app(4).

@@ -162,8 +162,8 @@ depth to which terms are printed by the error logger event handlers included in OTP. This configuration parameter is used by the two event handlers - defined by the Kernel application and the two event - handlers in the SASL application. + defined by the Kernel application and the two event + handlers in the SASL application. (If you have implemented your own error handlers, this configuration parameter has no effect on them.)

@@ -173,7 +173,7 @@ ~P and ~W, respectively, and Depth is used as the depth parameter. For details, see io:format/2 - in STDLIB.

+ in STDLIB.

A reasonable starting value for Depth is 30. We recommend to test crashing various processes in your @@ -241,7 +241,7 @@

The name (string) of an Inet user configuration file. For details, see section Inet Configuration - in the ERTS User's Guide.

+ in the ERTS User's Guide.

net_setuptime = SetupTime @@ -360,7 +360,7 @@ MaxT = TickTime + TickTime / 4 start_timer = true | false

Starts the timer_server if the parameter is - true (see stdlib:timer(3)). + true (see timer(3)). This parameter is to be set to true in an embedded system using this service.

Defaults to false.

diff --git a/lib/kernel/doc/src/net_kernel.xml b/lib/kernel/doc/src/net_kernel.xml index 3c1b3d5190..4e2b0c69db 100644 --- a/lib/kernel/doc/src/net_kernel.xml +++ b/lib/kernel/doc/src/net_kernel.xml @@ -55,7 +55,7 @@ $ erl -sname foobar erl.

Normally, connections are established automatically when another node is referenced. This functionality can be disabled - by setting Kernel configuration parameter + by setting Kernel configuration parameter dist_auto_connect to false, see kernel(6). In this case, connections must be established explicitly by calling @@ -146,7 +146,7 @@ $ erl -sname foobar are stopped. Two option lists are considered the same if they contain the same set of options.

-

As from Kernel version 2.11.4, and ERTS version +

As from Kernel version 2.11.4, and ERTS version 5.5.4, the following is guaranteed:

nodeup messages are delivered before delivery @@ -156,13 +156,13 @@ $ erl -sname foobar messages from the remote node that have been passed through the connection have been delivered.

 -

Notice that this is not guaranteed for Kernel +

Notice that this is not guaranteed for Kernel versions before 2.11.4.

-

As from Kernel version 2.11.4, subscriptions can also be +

As from Kernel version 2.11.4, subscriptions can also be made before the net_kernel server is started, that is, net_kernel:monitor_nodes/[1,2] does not return ignored.

-

As from Kernel version 2.13, and ERTS version +

As from Kernel version 2.13, and ERTS version 5.7, the following is guaranteed:

nodeup messages are delivered after the @@ -172,7 +172,7 @@ $ erl -sname foobar corresponding node has disappeared in results from erlang:nodes/X.

 -

Notice that this is not guaranteed for Kernel +

Notice that this is not guaranteed for Kernel versions before 2.13.

The format of the node status change messages depends on Options. If Options is diff --git a/lib/kernel/doc/src/notes.xml b/lib/kernel/doc/src/notes.xml index 3d35f6f57f..9e9be3f661 100644 --- a/lib/kernel/doc/src/notes.xml +++ b/lib/kernel/doc/src/notes.xml @@ -3482,7 +3482,7 @@ types (for instance, ensure_loaded/1 now only accepts an atom as documented; it used to accept a string too).

-

Dialyzer will generally emit warnings for any +

Dialyzer will generally emit warnings for any calls that use undocumented argument types. Even if the call happens to still work in R12B, you should correct your code. A future release will adhere to the diff --git a/lib/kernel/doc/src/rpc.xml b/lib/kernel/doc/src/rpc.xml index 8cad9fe4fc..5944e9321a 100644 --- a/lib/kernel/doc/src/rpc.xml +++ b/lib/kernel/doc/src/rpc.xml @@ -320,7 +320,7 @@ Information about a process.

Location transparent version of the BIF - erlang:process_info/1 in ERTS.

+ erlang:process_info/1 in ERTS.

@@ -330,7 +330,7 @@ Information about a process.

Location transparent version of the BIF - erlang:process_info/2 in ERTS.

+ erlang:process_info/2 in ERTS.

 diff --git a/lib/kernel/doc/src/zlib_stub.xml b/lib/kernel/doc/src/zlib_stub.xml index b111581b10..9ab9c4eb62 100644 --- a/lib/kernel/doc/src/zlib_stub.xml +++ b/lib/kernel/doc/src/zlib_stub.xml @@ -34,6 +34,6 @@ Zlib compression interface.

This module is moved to the - ERTS application.

+ ERTS application.

 diff --git a/lib/mnesia/doc/src/Mnesia_chap1.xml b/lib/mnesia/doc/src/Mnesia_chap1.xml index 9dfeb5efe4..035e934ed2 100644 --- a/lib/mnesia/doc/src/Mnesia_chap1.xml +++ b/lib/mnesia/doc/src/Mnesia_chap1.xml @@ -32,38 +32,38 @@ C Mnesia_chap1.xml
-

The Mnesia application provides a heavy duty real-time +

The Mnesia application provides a heavy duty real-time distributed database.

Scope

This User's Guide describes how to - build Mnesia database applications, and how to integrate - and use the Mnesia database management system with + build Mnesia database applications, and how to integrate + and use the Mnesia database management system with OTP. Programming constructs are described, and numerous programming examples are included to illustrate the use of - Mnesia.

+ Mnesia.

This User's Guide is organized as follows:

Mnesia provides an introduction to - Mnesia. + Mnesia. Getting Started - introduces Mnesia with an example database. Examples + introduces Mnesia with an example database. Examples are included how to start an Erlang session, specify a - Mnesia database directory, initialize a database - schema, start Mnesia, and create tables. Initial + Mnesia database directory, initialize a database + schema, start Mnesia, and create tables. Initial prototyping of record definitions is also discussed. Build a Mnesia Database more formally describes the steps - introduced in the previous section, namely the Mnesia - functions that define a database schema, start Mnesia, + introduced in the previous section, namely the Mnesia + functions that define a database schema, start Mnesia, and create the required tables. Transactions and Other Access Contexts - describes the transactions properties that make Mnesia into + describes the transactions properties that make Mnesia into a fault tolerant, real-time distributed database management system. This section also describes the concept of locking to ensure consistency in tables, and "dirty @@ -76,16 +76,16 @@ features include indexing, checkpoints, distribution and fault tolerance, disc-less nodes, replication manipulation, local content tables, concurrency, and object-based programming in - Mnesia. + Mnesia. Mnesia System Information describes the files contained in the - Mnesia database directory, database configuration data, + Mnesia database directory, database configuration data, core and table dumps, as well as the important subject of backup, fall-back, and disaster recovery principles. Combine Mnesia with - SNMP is a short section that outlines Mnesia + SNMP is a short section that outlines Mnesia integrated with SNMP. Appendix A: Backup diff --git a/lib/mnesia/doc/src/Mnesia_chap8.xml b/lib/mnesia/doc/src/Mnesia_chap8.xml index f1a469e315..4a2eed84d7 100644 --- a/lib/mnesia/doc/src/Mnesia_chap8.xml +++ b/lib/mnesia/doc/src/Mnesia_chap8.xml @@ -51,11 +51,11 @@

All these approaches have different advantages and - disadvantages. Mnesia applications can easily be opened to + disadvantages. Mnesia applications can easily be opened to the SNMP protocol. A direct 1-to-1 mapping can be established - between Mnesia tables and SNMP tables. This means - that a Mnesia table can be configured to be both - a Mnesia table and an SNMP table. A number of functions to + between Mnesia tables and SNMP tables. This means + that a Mnesia table can be configured to be both + a Mnesia table and an SNMP table. A number of functions to control this behavior are described in the Reference Manual.

diff --git a/lib/mnesia/doc/src/Mnesia_overview.xml b/lib/mnesia/doc/src/Mnesia_overview.xml index d2d597b85d..63f2309284 100644 --- a/lib/mnesia/doc/src/Mnesia_overview.xml +++ b/lib/mnesia/doc/src/Mnesia_overview.xml @@ -39,14 +39,14 @@ high level of fault tolerance that is required in many nonstop systems, combined with requirements on the DBMS to run in the same address space as the application, have led us to implement a new - DBMS, called Mnesia.

-

Mnesia is implemented in, and tightly connected to Erlang. + DBMS, called Mnesia.

+

Mnesia is implemented in, and tightly connected to Erlang. It provides the functionality that is necessary for the implementation of fault tolerant telecommunications systems.

-

Mnesia is a multiuser distributed DBMS specially made for +

Mnesia is a multiuser distributed DBMS specially made for industrial telecommunications applications written in Erlang, which is also the intended target language. - Mnesia tries to address all the data + Mnesia tries to address all the data management issues required for typical telecommunications systems. It has a number of features that are not normally found in traditional databases.

@@ -54,7 +54,7 @@ from the features provided by traditional DBMSs. The applications now implemented in Erlang need a mixture of a broad range of features, which generally are not satisfied by traditional DBMSs. - Mnesia is designed with requirements like the following in + Mnesia is designed with requirements like the following in mind:

Fast real-time key/value lookup @@ -71,9 +71,9 @@ Complex objects -

Mnesia is designed with the typical data management problems - of telecommunications applications in mind. This sets Mnesia - apart from most other DBMS. Hence Mnesia +

Mnesia is designed with the typical data management problems + of telecommunications applications in mind. This sets Mnesia + apart from most other DBMS. Hence Mnesia combines many concepts found in traditional databases such as transactions and queries with concepts found in data management systems for telecommunications applications, for example:

@@ -86,7 +86,7 @@ suspending it. -

Mnesia is also interesting because of its tight coupling to +

Mnesia is also interesting because of its tight coupling to Erlang, thus almost turning Erlang into a database programming language. This has many benefits, the foremost is that the impedance mismatch between the data format used by the DBMS @@ -97,7 +97,7 @@ Mnesia Database Management System (DBMS)

Features -

Mnesia contains the following features that combine to +

Mnesia contains the following features that combine to produce a fault-tolerant, distributed DBMS written in Erlang:

@@ -118,7 +118,7 @@ functions can be called within one transaction. Several transactions can run concurrently, and their execution - is fully synchronized by the DBMS. Mnesia ensures that no + is fully synchronized by the DBMS. Mnesia ensures that no two processes manipulate data simultaneously. Transactions can be assigned the property of being executed on @@ -132,29 +132,29 @@
Add-On Application -

Query List Comprehension (QLC) can be used with Mnesia +

Query List Comprehension (QLC) can be used with Mnesia to produce specialized functions that enhance the operational - ability of Mnesia. QLC has its own documentation as part + ability of Mnesia. QLC has its own documentation as part of the OTP documentation set. The main features of QLC - when used with Mnesia are as follows:

+ when used with Mnesia are as follows:

- QLC can optimize the query compiler for the Mnesia + QLC can optimize the query compiler for the Mnesia DBMS, essentially making the DBMS more efficient. QLC can be used as a database programming - language for Mnesia. It includes a notation called "list + language for Mnesia. It includes a notation called "list comprehensions" and can be used to make complex database queries over a set of tables.

For information about QLC, see the qlc manual page - in STDLIB.

+ in STDLIB.

When to Use Mnesia -

Use Mnesia with the following types of applications:

+

Use Mnesia with the following types of applications:

Applications that need to replicate data. @@ -166,7 +166,7 @@ Applications that use soft real-time characteristics. -

Mnesia is not as appropriate with the +

Mnesia is not as appropriate with the following types of applications:

Programs that process plain text or binary data files. @@ -176,14 +176,14 @@ library module dets, which is a disc-based version of the module ets. For information about dets, see the dets - manual page in STDLIB. + manual page in STDLIB. Applications that need disc logging facilities. Those applications can use the module disk_log by preference. For information about disk_log, see the disk_log - manual page in Kernel. + manual page in Kernel. Hard real-time systems. diff --git a/lib/mnesia/doc/src/mnesia.xml b/lib/mnesia/doc/src/mnesia.xml index b35214cde9..621b6047ee 100644 --- a/lib/mnesia/doc/src/mnesia.xml +++ b/lib/mnesia/doc/src/mnesia.xml @@ -37,7 +37,7 @@

The following are some of the most important and attractive - capabilities provided by Mnesia:

+ capabilities provided by Mnesia:

A relational/object hybrid data model that is suitable for telecommunications applications. @@ -62,15 +62,15 @@ reconfigured at runtime without stopping the system. -

This Reference Manual describes the Mnesia API. This - includes functions that define and manipulate Mnesia +

This Reference Manual describes the Mnesia API. This + includes functions that define and manipulate Mnesia tables.

All functions in this Reference Manual can be used in any combination with queries using the list comprehension notation. For information about the query notation, see the qlc - manual page in STDLIB.

-

Data in Mnesia is organized as a set of tables. Each table + manual page in STDLIB.

+

Data in Mnesia is organized as a set of tables. Each table has a name that must be an atom. Each table is made up of Erlang records. The user is responsible for the record definitions. Each table also has a set of properties. The @@ -121,14 +121,14 @@

index. This is a list of attribute names, or integers, which specify the tuple positions on which - Mnesia is to build and maintain an extra index + Mnesia is to build and maintain an extra index table.

local_content. When an application requires tables whose contents are local to each node, local_content tables can be used. The table name - is known to all Mnesia nodes, but its content is + is known to all Mnesia nodes, but its content is unique on each node. This means that access to such a table must be done locally. Set field local_content to true to enable the local_content @@ -143,7 +143,7 @@ avoid inconsistencies because of network splits.

 -

snmp. Each (set-based) Mnesia table can be +

snmp. Each (set-based) Mnesia table can be automatically turned into a Simple Network Management Protocol (SNMP) ordered table as well. This property specifies the types of the SNMP keys.

@@ -174,7 +174,7 @@ copy of each modified record during the transaction. During iteration, that is, mnesia:fold[lr]/4, mnesia:next/2, mnesia:prev/2, and - mnesia:snmp_get_next_index/2, Mnesia + mnesia:snmp_get_next_index/2, Mnesia compensates for every written or deleted record, which can reduce the performance.

If possible, avoid writing or deleting records in the same @@ -188,7 +188,7 @@

Makes the transaction silently return the tuple {aborted, Reason}. - Termination of a Mnesia transaction means that + Termination of a Mnesia transaction means that an exception is thrown to an enclosing catch. Thus, the expression catch mnesia:abort(x) does not terminate the transaction.

@@ -324,7 +324,7 @@ mnesia:ets. Argument AccessMod is the name of a callback module, which implements the mnesia_access behavior.

-

Mnesia forwards calls to the following functions:

+

Mnesia forwards calls to the following functions:

mnesia:lock/2 (read_lock_table/1, write_lock_table/1) @@ -391,15 +391,15 @@

ActivityId is a record that represents the identity - of the enclosing Mnesia activity. The first field + of the enclosing Mnesia activity. The first field (obtained with element(1, ActivityId)) contains an atom, which can be interpreted as the activity type: ets, async_dirty, sync_dirty, or tid. tid means that the activity is a transaction. The structure of the rest of the identity - record is internal to Mnesia.

+ record is internal to Mnesia.

Opaque is an opaque data structure that is internal - to Mnesia.

+ to Mnesia.

@@ -458,7 +458,7 @@ mnesia:add_table_index(person, age)

Calls the Fun in a context that is not protected by - a transaction. The Mnesia function calls performed in + a transaction. The Mnesia function calls performed in the Fun are mapped to the corresponding dirty functions. This still involves logging, replication, and subscriptions, but there is no locking, local transaction @@ -467,7 +467,7 @@ mnesia:add_table_index(person, age) for normal mnesia:dirty_* operations, the operations are performed semi-asynchronously. For details, see mnesia:activity/4 and the User's Guide.

-

The Mnesia tables can be manipulated without +

The Mnesia tables can be manipulated without using transactions. This has some serious disadvantages, but is considerably faster, as the transaction manager is not involved and no locks are set. A dirty operation does, @@ -480,7 +480,7 @@ mnesia:add_table_index(person, age) read records dirty than within a transaction.

Depending on the application, it can be a good idea to use the dirty functions for certain operations. Almost all - Mnesia functions that can be called within + Mnesia functions that can be called within transactions have a dirty equivalent, which is much more efficient.

However, notice that there is a risk that the database can @@ -497,7 +497,7 @@ mnesia:add_table_index(person, age) Backs up all tables in the database. -

Activates a new checkpoint covering all Mnesia tables, +

Activates a new checkpoint covering all Mnesia tables, including the schema, with maximum degree of redundancy, and performs a backup using backup_checkpoint/2/3. The default value of the backup callback module BackupMod @@ -529,16 +529,16 @@ mnesia:add_table_index(person, age) extra_db_nodes -

Value is a list of nodes that Mnesia +

Value is a list of nodes that Mnesia is to try to connect to. ReturnValue is those - nodes in Value that Mnesia is connected + nodes in Value that Mnesia is connected to.

Notice that this function must only be used to connect to newly started RAM nodes (N.D.R.S.N.) with an empty schema. If, for example, this function is used after the network has been partitioned, it can lead to inconsistent tables.

-

Notice that Mnesia can be connected to other +

Notice that Mnesia can be connected to other nodes than those returned in ReturnValue.

dc_dump_limit @@ -548,7 +548,7 @@ mnesia:add_table_index(person, age) Configuration Parameters. ReturnValue is the new value. Notice that this configuration parameter is not persistent. It is lost when - Mnesia has stopped.

+ Mnesia has stopped.

 @@ -562,9 +562,9 @@ mnesia:add_table_index(person, age) read_write but it can also be set to the atom read_only. If AccessMode is set to read_only, updates to the table cannot be - performed. At startup, Mnesia always loads + performed. At startup, Mnesia always loads read_only tables locally regardless of when and if - Mnesia is terminated on other nodes.

+ Mnesia is terminated on other nodes.

 @@ -620,13 +620,13 @@ mnesia:change_table_copy_type(person, node(), disc_copies)

Creates a new database on disc. Various files are - created in the local Mnesia directory of each node. + created in the local Mnesia directory of each node. Notice that the directory must be unique for each node. Two nodes must never share the same directory. If possible, use a local disc device to improve performance.

mnesia:create_schema/1 fails if any of the Erlang nodes given as DiscNodes are not alive, if - Mnesia is running on any of the nodes, or if any + Mnesia is running on any of the nodes, or if any of the nodes already have a schema. Use mnesia:delete_schema/1 to get rid of old faulty schemas.

@@ -638,10 +638,10 @@ mnesia:change_table_copy_type(person, node(), disc_copies) create_table(Name, TabDef) -> {atomic, ok} | {aborted, Reason} - Creates a Mnesia table called Namewith properties as described by argument TabDef. + Creates a Mnesia table called Namewith properties as described by argument TabDef. -

Creates a Mnesia table called +

Creates a Mnesia table called Name according to argument TabDef. This list must be a list of {Item, Value} tuples, where the following values are allowed:

@@ -652,8 +652,8 @@ mnesia:change_table_copy_type(person, node(), disc_copies) set to the atom read_only. If AccessMode is set to read_only, updates to the table cannot be performed.

-

At startup, Mnesia always loads read_only - table locally regardless of when and if Mnesia is +

At startup, Mnesia always loads read_only + table locally regardless of when and if Mnesia is terminated on other nodes. This argument returns the access mode of the table. The access mode can be read_only or read_write.

@@ -693,7 +693,7 @@ mnesia:change_table_copy_type(person, node(), disc_copies)

{index, Intlist}, where Intlist is a list of attribute names (atoms) or - record fields for which Mnesia is to build and + record fields for which Mnesia is to build and maintain an extra index table. The qlc query compiler may be able to optimize queries if there are indexes available.

@@ -735,10 +735,10 @@ mnesia:change_table_copy_type(person, node(), disc_copies) mnesia:create_table/2, the table is immediately accessible by SNMP. Therefore applications that use SNMP to manipulate and control the system can be - designed easily, since Mnesia provides a + designed easily, since Mnesia provides a direct mapping between the logical tables that make up an SNMP control application and the physical data that - makes up a Mnesia table.

+ makes up a Mnesia table.

{storage_properties, [{Backend, Properties}] @@ -746,7 +746,7 @@ mnesia:change_table_copy_type(person, node(), disc_copies) Backend can currently be ets or dets. Properties is a list of options sent to the back end storage during table creation. Properties - cannot contain properties already used by Mnesia, + cannot contain properties already used by Mnesia, such as type or named_table.

For example:

@@ -776,7 +776,7 @@ mnesia:create_table(table, [{ram_copies, [node()]}, {disc_only_copies, nodes()}, mnesia:create_table(person, [{ram_copies, [N1, N2]}, {attributes, record_info(fields, person)}]). -

If it is required that Mnesia must build and +

If it is required that Mnesia must build and maintain an extra index table on attribute address of all the person records that are inserted in the table, the following code would be issued:

@@ -819,8 +819,8 @@ mnesia:create_table(person, When the last replica is deleted with this function, the table disappears entirely.

This function can also be used to delete a replica of - the table named schema. The Mnesia node is - then removed. Notice that Mnesia must be + the table named schema. The Mnesia node is + then removed. Notice that Mnesia must be stopped on the node first.

 @@ -891,9 +891,9 @@ mnesia:create_table(person, mnesia:create_schema/1. mnesia:delete_schema/1 fails if any of the Erlang nodes given as DiscNodes are not alive, or if - Mnesia is running on any of the nodes.

+ Mnesia is running on any of the nodes.

After the database is deleted, it can still be possible - to start Mnesia as a disc-less node. This depends + to start Mnesia as a disc-less node. This depends on how configuration parameter schema_location is set.

@@ -1100,7 +1100,7 @@ mnesia:create_table(person, dirty_update_counter(Tab, Key, Incr) -> NewVal | exit({aborted, Reason}) Dirty update of a counter record. -

Mnesia has no special counter records. However, +

Mnesia has no special counter records. However, records of the form {Tab, Key, Integer} can be used as (possibly disc-resident) counters when Tab is a set. This function updates a counter with a positive @@ -1147,7 +1147,7 @@ mnesia:create_table(person,

Performs a user-initiated dump of the local log file. - This is usually not necessary, as Mnesia by default + This is usually not necessary, as Mnesia by default manages this automatically. See configuration parameters dump_log_time_threshold and @@ -1172,7 +1172,7 @@ mnesia:create_table(person, Dumps local tables into a text file. -

Dumps all local tables of a Mnesia system into a +

Dumps all local tables of a Mnesia system into a text file, which can be edited (by a normal text editor) and then be reloaded with mnesia:load_textfile/1. Only use this function for @@ -1182,10 +1182,10 @@ mnesia:create_table(person, error_description(Error) -> String - Returns a string describing a particular Mnesia error. + Returns a string describing a particular Mnesia error. -

All Mnesia transactions, including all the schema +

All Mnesia transactions, including all the schema update functions, either return value {atomic, Val} or the tuple {aborted, Reason}. Reason can be either of the atoms in the following list. The @@ -1264,8 +1264,8 @@ mnesia:create_table(person,

Calls the Fun in a raw context that is not protected by - a transaction. The Mnesia function call is performed in - the Fun and performed directly on the local ets + a transaction. The Mnesia function call is performed in + the Fun and performed directly on the local ETS tables on the assumption that the local storage type is ram_copies and the tables are not replicated to other nodes. Subscriptions are not triggered and checkpoints are @@ -1321,13 +1321,13 @@ mnesia:create_table(person, Forces a table to be loaded into the system. -

The Mnesia algorithm for table load can lead to a +

The Mnesia algorithm for table load can lead to a situation where a table cannot be loaded. This situation - occurs when a node is started and Mnesia concludes, or + occurs when a node is started and Mnesia concludes, or suspects, that another copy of the table was active after this local copy became inactive because of a system crash.

If this situation is not acceptable, this function can be - used to override the strategy of the Mnesia table + used to override the strategy of the Mnesia table load algorithm. This can lead to a situation where some transaction effects are lost with an inconsistent database as result, but for some applications high availability is more @@ -1402,9 +1402,9 @@ mnesia:create_table(person,

Prints system information on the terminal. - This function can be used even if Mnesia is not + This function can be used even if Mnesia is not started. However, more information is displayed if - Mnesia is started.

+ Mnesia is started.

 @@ -1431,7 +1431,7 @@ mnesia:create_table(person,

Installs a backup as fallback. The fallback is used to restore the database at the next startup. Installation of fallbacks requires Erlang to be operational on all the - involved nodes, but it does not matter if Mnesia + involved nodes, but it does not matter if Mnesia is running or not. The installation of the fallback fails if the local node is not one of the disc-resident nodes in the backup.

@@ -1465,14 +1465,14 @@ mnesia:create_table(person,

{mnesia_dir, AlternateDir}. This argument is only valid if the scope of the installation is local. Normally the installation - of a fallback is targeted to the Mnesia directory, + of a fallback is targeted to the Mnesia directory, as configured with configuration parameter -mnesia dir. But by explicitly supplying an AlternateDir, the fallback is installed there - regardless of the Mnesia directory configuration + regardless of the Mnesia directory configuration parameter setting. After installation of a fallback on - an alternative Mnesia directory, that directory - is fully prepared for use as an active Mnesia + an alternative Mnesia directory, that directory + is fully prepared for use as an active Mnesia directory.

This is a dangerous feature that must be used with care. By unintentional mixing of directories, @@ -1509,7 +1509,7 @@ mnesia:create_table(person,

Loads a series of definitions and data found in the text file (generated with mnesia:dump_to_textfile/1) - into Mnesia. This function also starts Mnesia + into Mnesia. This function also starts Mnesia and possibly creates a new schema. This function is intended for educational purposes only. It is recommended to use other functions to deal with real backups.

@@ -1558,7 +1558,7 @@ mnesia:create_table(person,

Conflicting lock requests are automatically queued if there is no risk of a deadlock. Otherwise the transaction must be - terminated and executed again. Mnesia does this + terminated and executed again. Mnesia does this automatically as long as the upper limit of the maximum retries is not reached. For details, see mnesia:transaction/3.

@@ -1726,19 +1726,19 @@ mnesia:create_table(person, report_event(Event) -> ok - Reports a user event to the Mnesia event handler. + Reports a user event to the Mnesia event handler. -

When tracing a system of Mnesia applications it is - useful to be able to interleave Mnesia own events with +

When tracing a system of Mnesia applications it is + useful to be able to interleave Mnesia own events with application-related events that give information about the application context.

Whenever the application begins a - new and demanding Mnesia task, or if it enters a new + new and demanding Mnesia task, or if it enters a new interesting phase in its execution, it can be a good idea to use mnesia:report_event/1. Event can be any term and generates a {mnesia_user, Event} event - for any processes that subscribe to Mnesia system + for any processes that subscribe to Mnesia system events.

 @@ -1748,7 +1748,7 @@ mnesia:create_table(person,

With this function, tables can be restored online from a - backup without restarting Mnesia. + backup without restarting Mnesia. Opaque is forwarded to the backup module. Args is a list of the following tuples:

@@ -1873,7 +1873,7 @@ mnesia:create_table(person,

For a complete description of select, see the ERTS User's Guide and the ets manual page in - STDLIB.

+ STDLIB.

For example, to find the names of all male persons older than 30 in table Tab:

@@ -1920,10 +1920,10 @@ mnesia:select(Tab,[{MatchHead, [Guard], [Result]}]), set_debug_level(Level) -> OldLevel - Changes the internal debug level of Mnesia. + Changes the internal debug level of Mnesia. -

Changes the internal debug level of Mnesia. +

Changes the internal debug level of Mnesia. For details, see Section Configuration Parameters.

@@ -1934,7 +1934,7 @@ mnesia:select(Tab,[{MatchHead, [Guard], [Result]}]), Sets the master nodes for all tables. -

For each table Mnesia determines its replica nodes +

For each table Mnesia determines its replica nodes (TabNodes) and starts mnesia:set_master_nodes(Tab, TabMasterNodes). where TabMasterNodes is the intersection of @@ -1952,16 +1952,16 @@ mnesia:select(Tab,[{MatchHead, [Guard], [Result]}]), that can have caused an inconsistent database, it can use the function mnesia:set_master_nodes(Tab, MasterNodes) to define from which nodes each table is to be loaded. - At startup, the Mnesia normal table load algorithm is + At startup, the Mnesia normal table load algorithm is bypassed and the table is loaded from one of the master nodes - defined for the table, regardless of when and if Mnesia + defined for the table, regardless of when and if Mnesia terminated on other nodes. MasterNodes can only contain nodes where the table has a replica. If the MasterNodes list is empty, the master node recovery mechanism for the particular table is reset, and the normal load mechanism is used at the next restart.

The master node setting is always local. It can be - changed regardless if Mnesia is started or not.

+ changed regardless if Mnesia is started or not.

The database can also become inconsistent if configuration parameter max_wait_for_decision is used or if mnesia:force_load_table/1 is used.

@@ -1976,7 +1976,7 @@ mnesia:select(Tab,[{MatchHead, [Guard], [Result]}]), snmp_get_mnesia_key(Tab, RowIndex) -> {ok, Key} | undefined - Gets the corresponding Mnesia key from an SNMP index. + Gets the corresponding Mnesia key from an SNMP index. Tab ::= atom() RowIndex ::= [integer()] @@ -1984,7 +1984,7 @@ mnesia:select(Tab,[{MatchHead, [Guard], [Result]}]), key() ::= integer() | string() | [integer()] -

Transforms an SNMP index to the corresponding Mnesia +

Transforms an SNMP index to the corresponding Mnesia key. If the SNMP table has multiple keys, the key is a tuple of the key columns.

 @@ -2020,7 +2020,7 @@ mnesia:select(Tab,[{MatchHead, [Guard], [Result]}]), snmp_open_table(Tab, SnmpStruct) -> {aborted, R} | {atomic, ok} - Organizes a Mnesia table as an SNMP table. + Organizes a Mnesia table as an SNMP table. Tab ::= atom() SnmpStruct ::= [{key, type()}] @@ -2029,14 +2029,14 @@ mnesia:select(Tab,[{MatchHead, [Guard], [Result]}]),

A direct one-to-one mapping can be established between - Mnesia tables and SNMP tables. Many telecommunication + Mnesia tables and SNMP tables. Many telecommunication applications are controlled and monitored by the SNMP - protocol. This connection between Mnesia and SNMP + protocol. This connection between Mnesia and SNMP makes it simple and convenient to achieve this mapping.

Argument SnmpStruct is a list of SNMP information. Currently, the only information needed is information about the key types in the table. Multiple - keys cannot be handled in Mnesia, but many SNMP + keys cannot be handled in Mnesia, but many SNMP tables have multiple keys. Therefore, the following convention is used: if a table has multiple keys, these must always be stored as a tuple of the keys. Information about @@ -2069,39 +2069,39 @@ mnesia:create_table(employee,

When a table is SNMP ordered, modifications are more expensive than usual, O(logN). Also, more memory is used.

Notice that only the lexicographical SNMP ordering is - implemented in Mnesia, not the actual SNMP monitoring.

+ implemented in Mnesia, not the actual SNMP monitoring.

 start() -> ok | {error, Reason} - Starts a local Mnesia system. + Starts a local Mnesia system. -

The startup procedure for a set of Mnesia nodes is a - fairly complicated operation. A Mnesia system consists - of a set of nodes, with Mnesia started locally on all +

The startup procedure for a set of Mnesia nodes is a + fairly complicated operation. A Mnesia system consists + of a set of nodes, with Mnesia started locally on all participating nodes. Normally, each node has a directory where - all the Mnesia files are written. This directory is - referred to as the Mnesia directory. Mnesia can + all the Mnesia files are written. This directory is + referred to as the Mnesia directory. Mnesia can also be started on disc-less nodes. For more information about disc-less nodes, see mnesia:create_schema/1 and the User's Guide.

-

The set of nodes that makes up a Mnesia system is kept - in a schema. Mnesia nodes can be added to or removed +

The set of nodes that makes up a Mnesia system is kept + in a schema. Mnesia nodes can be added to or removed from the schema. The initial schema is normally created on disc with the function mnesia:create_schema/1. On disc-less nodes, a tiny default schema is generated each time - Mnesia is started. During the startup procedure, - Mnesia exchanges schema information between the nodes + Mnesia is started. During the startup procedure, + Mnesia exchanges schema information between the nodes to verify that the table definitions are compatible.

Each schema has a unique cookie, which can be regarded as a unique schema identifier. The cookie must be the same on all - nodes where Mnesia is supposed to run. For details, + nodes where Mnesia is supposed to run. For details, see the User's Guide.

-

The schema file and all other files that Mnesia - needs are kept in the Mnesia directory. The +

The schema file and all other files that Mnesia + needs are kept in the Mnesia directory. The command-line option -mnesia dir Dir can be used to - specify the location of this directory to the Mnesia + specify the location of this directory to the Mnesia system. If no such command-line option is found, the name of the directory defaults to Mnesia.Node.

application:start(mnesia) can also be used.

@@ -2109,10 +2109,10 @@ mnesia:create_table(employee, stop() -> stopped - Stops Mnesia locally. + Stops Mnesia locally. -

Stops Mnesia locally on the current node.

+

Stops Mnesia locally on the current node.

application:stop(mnesia) can also be used.

 @@ -2132,7 +2132,7 @@ mnesia:create_table(employee,

Calls the Fun in a context that is not protected by - a transaction. The Mnesia function calls performed in + a transaction. The Mnesia function calls performed in the Fun are mapped to the corresponding dirty functions. It is performed in almost the same context as mnesia:async_dirty/1,2. The difference is that the @@ -2167,10 +2167,10 @@ mnesia:create_table(employee, system_info(InfoKey) -> Info | exit({aborted, Reason}) - Returns information about the Mnesia system. + Returns information about the Mnesia system. -

Returns information about the Mnesia system, such as +

Returns information about the Mnesia system, such as transaction statistics, db_nodes, and configuration parameters. The valid keys are as follows:

@@ -2188,7 +2188,7 @@ mnesia:create_table(employee,

auto_repair. Returns true or false - to indicate if Mnesia is configured to start the + to indicate if Mnesia is configured to start the auto-repair facility on corrupted disc files.

 @@ -2209,20 +2209,20 @@ mnesia:create_table(employee, in the list of nodes if they explicitly have been added to the schema, for example, with mnesia:add_table_copy/3. The function can be - started even if Mnesia is not yet running.

+ started even if Mnesia is not yet running.

debug. Returns the current debug level of - Mnesia.

+ Mnesia.

 -

directory. Returns the name of the Mnesia - directory. It can be called even if Mnesia is +

directory. Returns the name of the Mnesia + directory. It can be called even if Mnesia is not yet running.

dump_log_load_regulation. Returns a boolean that - tells if Mnesia is configured to regulate the + tells if Mnesia is configured to regulate the dumper process load.

This feature is temporary and will be removed in future releases.

@@ -2233,9 +2233,9 @@ mnesia:create_table(employee,

dump_log_update_in_place. Returns a boolean that - tells if Mnesia is configured to perform the - updates in the dets files directly, or if the - updates are to be performed in a copy of the dets + tells if Mnesia is configured to perform the + updates in the Dets files directly, or if the + updates are to be performed in a copy of the Dets files.

 @@ -2253,13 +2253,13 @@ mnesia:create_table(employee,

held_locks. Returns a list of all - locks held by the local Mnesia lock manager.

+ locks held by the local Mnesia lock manager.

is_running. Returns yes or no to - indicate if Mnesia is running. It can + indicate if Mnesia is running. It can also return starting or stopping. Can be - called even if Mnesia is not yet running.

+ called even if Mnesia is not yet running.

local_tables. Returns a list @@ -2272,7 +2272,7 @@ mnesia:create_table(employee,

log_version. Returns the version - number of the Mnesia transaction log format.

+ number of the Mnesia transaction log format.

master_node_tables. Returns a @@ -2280,25 +2280,25 @@ mnesia:create_table(employee,

protocol_version. Returns the version number of - the Mnesia inter-process communication protocol.

+ the Mnesia inter-process communication protocol.

running_db_nodes. Returns a list of nodes where - Mnesia currently is running. This function can be - called even if Mnesia is not yet running, but it + Mnesia currently is running. This function can be + called even if Mnesia is not yet running, but it then has slightly different semantics.

-

If Mnesia is down on the local node, the function +

If Mnesia is down on the local node, the function returns those other db_nodes and extra_db_nodes that for the moment are operational.

-

If Mnesia is started, the function returns - those nodes that Mnesia on the local node is fully - connected to. Only those nodes that Mnesia has +

If Mnesia is started, the function returns + those nodes that Mnesia on the local node is fully + connected to. Only those nodes that Mnesia has exchanged schema information with are included as running_db_nodes. After the merge of schemas, the - local Mnesia system is fully operable and + local Mnesia system is fully operable and applications can perform access of remote replicas. - Before the schema merge, Mnesia only operates + Before the schema merge, Mnesia only operates locally. Sometimes there are more nodes included in the running_db_nodes list than all db_nodes and extra_db_nodes together.

@@ -2322,17 +2322,17 @@ mnesia:create_table(employee,

transaction_failures. Returns a number that indicates how many transactions have - failed since Mnesia was started.

+ failed since Mnesia was started.

transaction_commits. Returns a number that indicates how many transactions have - terminated successfully since Mnesia was started.

+ terminated successfully since Mnesia was started.

transaction_restarts. Returns a number that indicates how many transactions have been - restarted since Mnesia was started.

+ restarted since Mnesia was started.

transaction_log_writes. @@ -2342,12 +2342,12 @@ mnesia:create_table(employee,

use_dir. Returns a boolean that indicates if - the Mnesia directory is used or not. Can be - started even if Mnesia is not yet running.

+ the Mnesia directory is used or not. Can be + started even if Mnesia is not yet running.

version. Returns the current - version number of Mnesia.

+ version number of Mnesia.

 @@ -2359,13 +2359,13 @@ mnesia:create_table(employee,

Returns a Query List Comprehension (QLC) query handle, see the qlc(3) - manual page in STDLIB. The module qlc - implements a query language that can use Mnesia + manual page in STDLIB. The module qlc + implements a query language that can use Mnesia tables as sources of data. Calling mnesia:table/1,2 is the means to make the mnesia table Tab usable to QLC.

-

Option can contain Mnesia - options or QLC options. Mnesia recognizes the +

Option can contain Mnesia + options or QLC options. Mnesia recognizes the following options (any other option is forwarded to QLC).

@@ -2374,7 +2374,7 @@ mnesia:create_table(employee, {n_objects,Number}, where n_objects specifies (roughly) the number of objects returned - from Mnesia to QLC. Queries to remote tables + from Mnesia to QLC. Queries to remote tables can need a larger chunk to reduce network overhead. By default, 100 objects at a time are returned. @@ -2413,7 +2413,7 @@ mnesia:create_table(employee,

The table_info/2 function takes two arguments. - The first is the name of a Mnesia table. + The first is the name of a Mnesia table. The second is one of the following keys:

@@ -2465,7 +2465,7 @@ mnesia:create_table(employee,

load_node. Returns the name of - the node that Mnesia loaded the table from. The + the node that Mnesia loaded the table from. The structure of the returned value is unspecified, but can be useful for debugging purposes.

 @@ -2476,7 +2476,7 @@ mnesia:create_table(employee,

load_reason. Returns the - reason of why Mnesia decided to load the table. + reason of why Mnesia decided to load the table. The structure of the returned value is unspecified, but can be useful for debugging purposes.

 @@ -2620,7 +2620,7 @@ raise(Name, Amount) -> several processes running on different nodes can concurrently execute the function raise/2 without interfering with each other.

-

Since Mnesia detects deadlocks, a transaction can be +

Since Mnesia detects deadlocks, a transaction can be restarted any number of times. This function attempts a restart as specified in Retries. Retries must be an integer greater than 0 or the atom infinity. @@ -2643,7 +2643,7 @@ raise(Name, Amount) ->

NewAttributeList and NewRecordName specify the attributes and the new record type of the converted table. Table name always remains unchanged. If - record_name is changed, only the Mnesia + record_name is changed, only the Mnesia functions that use table identifiers work, for example, mnesia:write/3 works, but not mnesia:write/1.

 @@ -2706,7 +2706,7 @@ raise(Name, Amount) -> distributed operation that is either performed on all nodes with disc resident schema, or none. Uninstallation of fallbacks requires Erlang to be operational on all - involved nodes, but it does not matter if Mnesia is + involved nodes, but it does not matter if Mnesia is running or not. Which nodes that are considered as disc-resident nodes is determined from the schema information in the local fallback.

@@ -2792,28 +2792,28 @@ raise(Name, Amount) ->
Configuration Parameters -

Mnesia reads the following application configuration +

Mnesia reads the following application configuration parameters:

-mnesia access_module Module. The name of the - Mnesia activity access callback module. Default is + Mnesia activity access callback module. Default is mnesia.

-mnesia auto_repair true | false. This flag - controls if Mnesia automatically tries to repair + controls if Mnesia automatically tries to repair files that have not been properly closed. Default is true.

-mnesia backup_module Module. The name of the - Mnesia backup callback module. Default is + Mnesia backup callback module. Default is mnesia_backup.

-mnesia debug Level. Controls the debug level - of Mnesia. The possible values are as follows:

+ of Mnesia. The possible values are as follows:

none @@ -2825,7 +2825,7 @@ raise(Name, Amount) -> events generate {mnesia_info, Format, Args} system events. Processes can subscribe to these events with mnesia:subscribe/1. The events are always sent to - the Mnesia event handler.

+ the Mnesia event handler.

 debug @@ -2834,15 +2834,15 @@ raise(Name, Amount) -> {mnesia_info, Format, Args} system events. Processes can subscribe to these events with mnesia:subscribe/1. The events are always sent to - the Mnesia event handler. On this debug level, - the Mnesia event handler starts subscribing to + the Mnesia event handler. On this debug level, + the Mnesia event handler starts subscribing to updates in the schema table.

 trace

Activates all events at the debug level. On this - level, the Mnesia event handler starts subscribing - to updates on all Mnesia tables. This level is + level, the Mnesia event handler starts subscribing + to updates on all Mnesia tables. This level is intended only for debugging small toy systems, as many large events can be generated.

 @@ -2856,7 +2856,7 @@ raise(Name, Amount) ->

-mnesia core_dir Directory. The name of the - directory where Mnesia core files is stored, or + directory where Mnesia core files is stored, or false. Setting it implies that also RAM-only nodes generate a core file if a crash occurs.

 @@ -2870,9 +2870,9 @@ raise(Name, Amount) ->

-mnesia dir Directory. The name of the directory - where all Mnesia data is stored. The directory name + where all Mnesia data is stored. The directory name must be unique for the current node. Two nodes must never - share the the same Mnesia directory. The results + share the the same Mnesia directory. The results are unpredictable.

 @@ -2915,44 +2915,44 @@ raise(Name, Amount) ->

-mnesia event_module Module. The name of the - Mnesia event handler callback module. Default is + Mnesia event handler callback module. Default is mnesia_event.

-mnesia extra_db_nodes Nodes specifies a list of nodes, in addition to the ones found in the schema, with - which Mnesia is also to establish contact. Default + which Mnesia is also to establish contact. Default is [] (empty list).

-mnesia fallback_error_function {UserModule, UserFunc}. Specifies a user-supplied callback function, which is - called if a fallback is installed and Mnesia goes - down on another node. Mnesia calls the function + called if a fallback is installed and Mnesia goes + down on another node. Mnesia calls the function with one argument, the name of the dying node, for example, - UserModule:UserFunc(DyingNode). Mnesia must + UserModule:UserFunc(DyingNode). Mnesia must be restarted, otherwise the database can be inconsistent. - The default behavior is to terminate Mnesia.

+ The default behavior is to terminate Mnesia.

-mnesia max_wait_for_decision Timeout. Specifies - how long Mnesia waits for other nodes to share their + how long Mnesia waits for other nodes to share their knowledge about the outcome of an unclear transaction. By default, Timeout is set to the atom infinity. - This implies that if Mnesia upon startup detects + This implies that if Mnesia upon startup detects a "heavyweight transaction" whose outcome is unclear, the - local Mnesia waits until Mnesia is started + local Mnesia waits until Mnesia is started on some (in the worst case all) of the other nodes that were involved in the interrupted transaction. This is a rare - situation, but if it occurs, Mnesia does not guess if + situation, but if it occurs, Mnesia does not guess if the transaction on the other nodes was committed or - terminated. Mnesia waits until it knows the outcome + terminated. Mnesia waits until it knows the outcome and then acts accordingly.

If Timeout is set to an integer value in - milliseconds, Mnesia forces "heavyweight transactions" + milliseconds, Mnesia forces "heavyweight transactions" to be finished, even if the outcome of the transaction for the moment is unclear. After Timeout milliseconds, - Mnesia commits or terminates the transaction and + Mnesia commits or terminates the transaction and continues with the startup. This can lead to a situation where the transaction is committed on some nodes and terminated on other nodes. If the transaction is a @@ -2976,14 +2976,14 @@ raise(Name, Amount) ->

-mnesia schema_location Loc. Controls where - Mnesia looks for its schema. Parameter + Mnesia looks for its schema. Parameter Loc can be one of the following atoms:

disc

Mandatory disc. The schema is assumed to be located - in the Mnesia directory. If the schema cannot - be found, Mnesia refuses to start. This is the + in the Mnesia directory. If the schema cannot + be found, Mnesia refuses to start. This is the old behavior.

 ram @@ -3001,10 +3001,10 @@ raise(Name, Amount) -> opt_disc

Optional disc. The schema can reside on disc or in - RAM. If the schema is found on disc, Mnesia + RAM. If the schema is found on disc, Mnesia starts as a disc-based node and the storage type of the schema table is disc_copies. If no schema is - found on disc, Mnesia starts as a disc-less node + found on disc, Mnesia starts as a disc-less node and the storage type of the schema table is ram_copies. Default value for the application parameter is opt_disc.

@@ -3012,7 +3012,7 @@ raise(Name, Amount) -> -

First, the SASL application parameters are checked, +

First, the SASL application parameters are checked, then the command-line flags are checked, and finally, the default value is chosen.

diff --git a/lib/mnesia/doc/src/mnesia_frag_hash.xml b/lib/mnesia/doc/src/mnesia_frag_hash.xml index 95f5f8aa07..51b32129b6 100644 --- a/lib/mnesia/doc/src/mnesia_frag_hash.xml +++ b/lib/mnesia/doc/src/mnesia_frag_hash.xml @@ -87,13 +87,13 @@ the new one.

NewState is stored as hash_state among the other frag_properties.

-

As a part of the add_frag procedure, Mnesia iterates +

As a part of the add_frag procedure, Mnesia iterates over all fragments corresponding to the IterFrags numbers and starts key_to_frag_number(NewState,RecordKey) for each record. If the new fragment differs from the old fragment, the record is moved to the new fragment.

As the add_frag procedure is a part of a schema - transaction, Mnesia acquires write locks on the + transaction, Mnesia acquires write locks on the affected tables. That is, both the fragments corresponding to IterFrags and those corresponding to AdditionalLockFrags.

@@ -112,7 +112,7 @@

NewState is stored as hash_state among the other frag_properties.

-

As a part of the del_frag procedure, Mnesia iterates +

As a part of the del_frag procedure, Mnesia iterates over all fragments corresponding to the IterFrags numbers and starts key_to_frag_number(NewState,RecordKey) for each record. If the new fragment differs from the old @@ -120,7 +120,7 @@

Notice that all records in the last fragment must be moved to another fragment, as the entire fragment is deleted.

As the del_frag procedure is a part of a schema - transaction, Mnesia acquires write locks on the + transaction, Mnesia acquires write locks on the affected tables. That is, both the fragments corresponding to IterFrags and those corresponding to AdditionalLockFrags.

@@ -134,7 +134,7 @@ Reason = term() -

Starts whenever Mnesia needs to determine +

Starts whenever Mnesia needs to determine which fragment a certain record belongs to. It is typically started at read, write, and delete.

 @@ -149,7 +149,7 @@ Reason = term() -

This function is called whenever Mnesia needs to determine +

This function is called whenever Mnesia needs to determine which fragments that need to be searched for a MatchSpec. It is typically called by select and match_object.

diff --git a/lib/mnesia/doc/src/mnesia_registry.xml b/lib/mnesia/doc/src/mnesia_registry.xml index cd778ae072..a76f716981 100644 --- a/lib/mnesia/doc/src/mnesia_registry.xml +++ b/lib/mnesia/doc/src/mnesia_registry.xml @@ -38,20 +38,20 @@ Dump support for registries in erl_interface.

This module is usually part of the erl_interface - application, but is currently part of the Mnesia + application, but is currently part of the Mnesia application.

This module is mainly intended for internal use within OTP, but it has two functions that are exported for public use.

On C-nodes, erl_interface has support for registry tables. These tables reside in RAM on the C-node, but can also - be dumped into Mnesia tables. By default, the dumping + be dumped into Mnesia tables. By default, the dumping of registry tables through erl_interface causes a - corresponding Mnesia table to be created with + corresponding Mnesia table to be created with mnesia_registry:create_table/1, if necessary.

Tables that are created with these functions can be - administered as all other Mnesia tables. They can be + administered as all other Mnesia tables. They can be included in backups, replicas can be added, and so on. - The tables are normal Mnesia tables owned by the user + The tables are normal Mnesia tables owned by the user of the corresponding erl_interface registries.

 @@ -68,7 +68,7 @@ that is, {ram_copies,[node()]} or {disc_copies,[node()]}.

This function is used by erl_interface to - create the Mnesia table if it does not already + create the Mnesia table if it does not already exist.

 diff --git a/lib/mnesia/doc/src/part.xml b/lib/mnesia/doc/src/part.xml index 101bdb29d4..d3ffe93937 100644 --- a/lib/mnesia/doc/src/part.xml +++ b/lib/mnesia/doc/src/part.xml @@ -30,7 +30,7 @@ part.sgml -

The Mnesia application is a distributed Database Management +

The Mnesia application is a distributed Database Management System (DBMS), appropriate for telecommunications applications and other Erlang applications, which require continuous operation and exhibit soft real-time properties.

diff --git a/lib/mnesia/doc/src/ref_man.xml b/lib/mnesia/doc/src/ref_man.xml index 662f0d61d6..7fb71b9c45 100644 --- a/lib/mnesia/doc/src/ref_man.xml +++ b/lib/mnesia/doc/src/ref_man.xml @@ -33,7 +33,7 @@ refman.sgml -

The Mnesia application is a distributed Database Management +

The Mnesia application is a distributed Database Management System (DBMS), appropriate for telecommunications applications and other Erlang applications, which require continuous operation and exhibit soft real-time properties.

diff --git a/lib/observer/doc/src/ttb.xml b/lib/observer/doc/src/ttb.xml index 94ecef24b4..42b0fa1d8a 100644 --- a/lib/observer/doc/src/ttb.xml +++ b/lib/observer/doc/src/ttb.xml @@ -485,7 +485,7 @@ ttb:p(all, call).

For a description of the match_spec() syntax, see section Match Specifications in Erlang - in ERTS, which explains the general match specification "language". + in ERTS, which explains the general match specification "language".

The system tracer for sequential tracing is diff --git a/lib/odbc/doc/src/notes.xml b/lib/odbc/doc/src/notes.xml index d3dd39616f..40f9339028 100644 --- a/lib/odbc/doc/src/notes.xml +++ b/lib/odbc/doc/src/notes.xml @@ -585,7 +585,7 @@ also been extended. The configure scripts of erl_interface and odbc now search for thread libraries and thread library quirks the - same way as erts do. The + same way as ERTS do. The configure script of the odbc application now also looks for odbc libraries in lib64 and lib/64 directories when building on a 64-bit diff --git a/lib/parsetools/doc/src/yecc.xml b/lib/parsetools/doc/src/yecc.xml index 6ec9fb5f0e..9188bd2a22 100644 --- a/lib/parsetools/doc/src/yecc.xml +++ b/lib/parsetools/doc/src/yecc.xml @@ -201,7 +201,7 @@

The grammar starts with an optional header section. The header is put first in the generated file, before the module declaration. The purpose of the header is to provide a means to - make the documentation generated by EDoc look nicer. Each + make the documentation generated by EDoc look nicer. Each header line should be enclosed in double quotes, and newlines will be inserted between the lines. For example:

diff --git a/lib/reltool/doc/src/notes.xml b/lib/reltool/doc/src/notes.xml index 6df4924d0a..25d983afd3 100644 --- a/lib/reltool/doc/src/notes.xml +++ b/lib/reltool/doc/src/notes.xml @@ -546,8 +546,8 @@

The handling of applications included in releases has been improved. Applications that are required to be started before other applications in a release are now - automatically included in the release. The kernel - and stdlib applications are always included as + automatically included in the release. The Kernel + and STDLIB applications are always included as they are mandatory.

Applications that are (explicitly or implicitly) included in a release are now automatically included as diff --git a/lib/reltool/doc/src/part.xml b/lib/reltool/doc/src/part.xml index 5904084879..e608d548ea 100644 --- a/lib/reltool/doc/src/part.xml +++ b/lib/reltool/doc/src/part.xml @@ -31,7 +31,7 @@ %VSN% -

Reltool is a release management tool. It analyses a given +

Reltool is a release management tool. It analyses a given Erlang/OTP installation and determines various dependencies between applications. The graphical frontend depicts the dependencies and enables interactive customization of a diff --git a/lib/reltool/doc/src/ref_man.xml b/lib/reltool/doc/src/ref_man.xml index 38f270b79a..1684f075ff 100644 --- a/lib/reltool/doc/src/ref_man.xml +++ b/lib/reltool/doc/src/ref_man.xml @@ -31,7 +31,7 @@ %VSN% -

Reltool is a release management tool. It analyses a given +

Reltool is a release management tool. It analyses a given Erlang/OTP installation and determines various dependencies between applications. The graphical frontend depicts the dependencies and enables interactive customization of a diff --git a/lib/reltool/doc/src/reltool.xml b/lib/reltool/doc/src/reltool.xml index 38448e7961..5bfbee966b 100644 --- a/lib/reltool/doc/src/reltool.xml +++ b/lib/reltool/doc/src/reltool.xml @@ -47,7 +47,7 @@

The tool uses an installed Erlang/OTP system as input. root_dir is the root directory of the analysed system and - it defaults to the system executing reltool. Applications + it defaults to the system executing Reltool. Applications may also be located outside root_dir. lib_dirs defines library directories where additional applications may reside and it defaults to the directories @@ -56,7 +56,7 @@

An application directory AppDir under a library directory is recognized by the existence of an AppDir/ebin - directory. If this does not exist, reltool will not + directory. If this does not exist, Reltool will not consider AppDir at all when looking for applications.

It is recommended that application directories are named as the @@ -81,14 +81,14 @@ config

This is the main option and it controls the configuration - of reltool. It can either be a sys tuple or + of Reltool. It can either be a sys tuple or a name of a file containing a sys tuple.

trap_exit

This option controls the error handling behavior of - reltool. By default the window processes traps + Reltool. By default the window processes traps exit, but this behavior can altered by setting trap_exit to false.

 diff --git a/lib/reltool/doc/src/reltool_intro.xml b/lib/reltool/doc/src/reltool_intro.xml index 8e232b8838..2980ad7977 100644 --- a/lib/reltool/doc/src/reltool_intro.xml +++ b/lib/reltool/doc/src/reltool_intro.xml @@ -34,7 +34,7 @@ %VSN% reltool_intro.xml -

Reltool is a release management tool. It analyses a given +

Reltool is a release management tool. It analyses a given Erlang/OTP installation and determines various dependencies between applications. The graphical frontend depicts the dependencies and enables interactive customization of a target system. The backend provides a @@ -82,7 +82,7 @@ and about the Erlang/OTP development system:

-

the Reference Manual of Reltool

+

the Reference Manual of Reltool

the Erlang/OTP System Principles

diff --git a/lib/runtime_tools/doc/src/dbg.xml b/lib/runtime_tools/doc/src/dbg.xml index 14a81b2293..db04bfdf7b 100644 --- a/lib/runtime_tools/doc/src/dbg.xml +++ b/lib/runtime_tools/doc/src/dbg.xml @@ -78,7 +78,7 @@

Pseudo function that by means of a parse_transform translates the literalfun() typed as parameter in the function call to a match specification as described in - the match_spec manual of ERTS users guide. + the match_spec manual of ERTS users guide. (with literal I mean that the fun() needs to textually be written as the parameter of the function, it cannot be held in a variable which in turn is passed to the diff --git a/lib/runtime_tools/doc/src/notes.xml b/lib/runtime_tools/doc/src/notes.xml index 6bec7cb9ca..b6dfb2dd28 100644 --- a/lib/runtime_tools/doc/src/notes.xml +++ b/lib/runtime_tools/doc/src/notes.xml @@ -668,7 +668,7 @@ also been extended. The configure scripts of erl_interface and odbc now search for thread libraries and thread library quirks the - same way as erts do. The + same way as ERTS do. The configure script of the odbc application now also looks for odbc libraries in lib64 and lib/64 directories when building on a 64-bit diff --git a/lib/sasl/doc/src/alarm_handler.xml b/lib/sasl/doc/src/alarm_handler.xml index 8550a88b28..4160757164 100644 --- a/lib/sasl/doc/src/alarm_handler.xml +++ b/lib/sasl/doc/src/alarm_handler.xml @@ -54,7 +54,7 @@ format is defined by the user. For example, an event handler for SNMP can be defined, together with an alarm Management Information Base (MIB).

-

The alarm handler is part of the SASL application.

+

The alarm handler is part of the SASL application.

When writing new event handlers for the alarm handler, the following events must be handled:

@@ -76,7 +76,7 @@ {NewHandler, Args}). NewHandler:init({Args, {alarm_handler, Alarms}}) is called. For more details, see gen_event(3) - in STDLIB.

+ in STDLIB.

 diff --git a/lib/sasl/doc/src/appup.xml b/lib/sasl/doc/src/appup.xml index 6fbdcb9f5b..a43a966dcb 100644 --- a/lib/sasl/doc/src/appup.xml +++ b/lib/sasl/doc/src/appup.xml @@ -362,12 +362,12 @@ point_of_no_return system is restarted.

 restart_new_emulator
-

This instruction is used when the application ERTS, - Kernel, STDLIB, or SASL is +

This instruction is used when the application ERTS, + Kernel, STDLIB, or SASL is upgraded. It shuts down the current emulator and starts a new one. All processes are terminated gracefully, and the new - version of ERTS, Kernel, STDLIB, and - SASL are used when the emulator restarts. + version of ERTS, Kernel, STDLIB, and + SASL are used when the emulator restarts. Only one restart_new_emulator instruction is allowed in the relup file, and it must be placed first. systools:make_relup/3,4 @@ -385,7 +385,7 @@ restart_new_emulator

As stated earlier, instruction restart_new_emulator causes the emulator to be restarted with new versions of - ERTS, Kernel, STDLIB, and SASL. + ERTS>, Kernel, STDLIB, and SASL. However, all other applications do at startup run their old versions in this new emulator. This is usually no problem, but every now and then incompatible changes occur to the diff --git a/lib/sasl/doc/src/error_logging.xml b/lib/sasl/doc/src/error_logging.xml index 8464a41ff9..4b2c960bbb 100644 --- a/lib/sasl/doc/src/error_logging.xml +++ b/lib/sasl/doc/src/error_logging.xml @@ -32,20 +32,20 @@ B error_logging.xml -

The SASL application introduces three types of reports:

+

The SASL application introduces three types of reports:

Supervisor report Progress report Crash report -

When the SASL application is started, it adds a handler that +

When the SASL application is started, it adds a handler that formats and writes these reports, as specified in the configuration - parameters for SASL, that is, the environment variables - in the SASL application specification, which is found in the - .app file of SASL. For details, see the + parameters for SASL, that is, the environment variables + in the SASL application specification, which is found in the + .app file of SASL. For details, see the sasl(6) application in the Reference Manual and the app(4) - file in the Kernel Reference Manual.

+ file in the Kernel Reference Manual.

Supervisor Report @@ -180,14 +180,14 @@

The report browser is used to browse and format error reports written by the error logger handler log_mf_h - defined in STDLIB.

+ defined in STDLIB.

The log_mf_h handler writes all reports to a report logging directory, which is specified when - configuring the SASL application.

+ configuring the SASL application.

If the report browser is used offline, the reports can be copied to another directory specified when starting the browser. If no such directory - is specified, the browser reads reports from the SASL + is specified, the browser reads reports from the SASL error_logger_mf_dir.

diff --git a/lib/sasl/doc/src/notes.xml b/lib/sasl/doc/src/notes.xml index dae73f8b23..bd713af932 100644 --- a/lib/sasl/doc/src/notes.xml +++ b/lib/sasl/doc/src/notes.xml @@ -824,7 +824,7 @@

Use an infinity timeout in all calls to - gen_server:call() in the sasl + gen_server:call() in the SASL application.

Own Id: OTP-8506 Aux Id: seq11509

diff --git a/lib/sasl/doc/src/part.xml b/lib/sasl/doc/src/part.xml index f531ed2dea..659710487e 100644 --- a/lib/sasl/doc/src/part.xml +++ b/lib/sasl/doc/src/part.xml @@ -30,7 +30,7 @@ part.xml -

The System Architecture Support Libraries SASL application +

The System Architecture Support Libraries SASL application provides support for alarm handling, release handling, and related functions.

 diff --git a/lib/sasl/doc/src/rb.xml b/lib/sasl/doc/src/rb.xml index 1ce19046eb..d5df4fd345 100644 --- a/lib/sasl/doc/src/rb.xml +++ b/lib/sasl/doc/src/rb.xml @@ -38,7 +38,7 @@

The Report Browser (RB) tool is used to browse and format error reports written by the error logger handler log_mf_h - in STDLIB.

+ in STDLIB.

@@ -62,7 +62,7 @@ reports that match that filter.

The reports are matched using the proplists - module in STDLIB. The report must be a proplist + module in STDLIB. The report must be a proplist to be matched against any of the filters.

If the filter has the form {Key, RegExp, re}, the report must contain an element with key equal to Key and @@ -102,7 +102,7 @@

For a definition of valid regular expressions and options, see the re module in - STDLIB and in particular function re:run/3.

+ STDLIB and in particular function re:run/3.

For details about data type mp(), see re:mp().

diff --git a/lib/sasl/doc/src/ref_man.xml b/lib/sasl/doc/src/ref_man.xml index 42045df5ec..78cf1eb26e 100644 --- a/lib/sasl/doc/src/ref_man.xml +++ b/lib/sasl/doc/src/ref_man.xml @@ -30,7 +30,7 @@ application.xml -

The SASL application provides support for alarm handling, +

The SASL application provides support for alarm handling, release handling, and related functions.

 diff --git a/lib/sasl/doc/src/rel.xml b/lib/sasl/doc/src/rel.xml index d6558c06b4..9356b2cd47 100644 --- a/lib/sasl/doc/src/rel.xml +++ b/lib/sasl/doc/src/rel.xml @@ -59,7 +59,7 @@ Vsn = string()

Release version.

 EVsn = string() -

ERTS version the release is intended for.

 +

ERTS version the release is intended for.

 Application = atom()

Name of an application included in the release.

 AppVsn = string() @@ -82,8 +82,8 @@ to the same value as in the application resource file.

 -

The list of applications must contain the Kernel and - STDLIB applications.

+

The list of applications must contain the Kernel and + STDLIB applications.
diff --git a/lib/sasl/doc/src/release_handler.xml b/lib/sasl/doc/src/release_handler.xml index bcbc5f5339..8f073807fb 100644 --- a/lib/sasl/doc/src/release_handler.xml +++ b/lib/sasl/doc/src/release_handler.xml @@ -31,7 +31,7 @@ release_handler Unpacking and Installation of Release Packages -

The release handler process belongs to the SASL +

The release handler process belongs to the SASL application, which is responsible for release handling, that is, unpacking, installation, and removal of release packages.

An introduction to release handling and an example is provided in @@ -44,7 +44,7 @@ directory of the previous version of the release, where $ROOT is the installation root directory, code:root_dir(). - Another releases directory can be specified using the SASL + Another releases directory can be specified using the SASL configuration parameter releases_dir or the OS environment variable RELDIR. The release handler must have write access to this directory to install the new release. @@ -56,7 +56,7 @@ A boot script, Name.boot

The .rel file contains information about the release: its name, - version, and which ERTS and application versions it uses.

+ version, and which ERTS and application versions it uses.

A release package can also contain:

A release upgrade file, relup @@ -115,7 +115,7 @@ System Documentation. In this case, the system configuration file sys.config is mandatory.

The installation of a new release can restart the system. Which - program to use is specified by the SASL configuration + program to use is specified by the SASL configuration parameter start_prg, which defaults to $ROOT/bin/start.

The emulator restart on Windows NT expects that the system is @@ -132,7 +132,7 @@ is made permanent.

The release handler at a node running on a diskless machine, or with a read-only file system, must be configured accordingly - using the following SASL configuration parameters (for + using the following SASL configuration parameters (for details, see sasl(6)):

masters @@ -287,7 +287,7 @@ returned, the emulator is restarted before the upgrade instructions are executed. This occurs if the emulator or any of the applications - Kernel, STDLIB, or SASL + Kernel, STDLIB, or SASL are updated. The new emulator version and these core applications execute after the restart. For all other applications the old versions are @@ -310,13 +310,13 @@ code_change_timeout

Defines the time-out for all calls to - stdlib:sys:change_code. + sys:change_code. If no value is specified or default is specified, the default value defined in sys is used.

 suspend_timeout

Defines the time-out for all calls to - stdlib:sys:suspend. + sys:suspend. If no value is specified, the values defined by the Timeout parameter of the upgrade or suspend instructions are used. If default is specified, the default value defined in @@ -342,7 +342,7 @@ release_handler:set_unpacked(RelFile, [{myapp,"1.0","/home/user"},...]). => {ok,NewVsn}

If NewVsn is installed with option {update_paths,true}, then - kernel:code:lib_dir(myapp) + code:lib_dir(myapp) returns /home/user/myapp-1.0.

@@ -801,7 +801,7 @@ release_handler:set_unpacked(RelFile, [{myapp,"1.0","/home/user"},...]). is an atom named from the Posix error codes, such as enoent, eacces, or eisdir. See file(3) - in Kernel.

+ in Kernel.

Posix

Some file operation failed, as for the previous item in the list.

 diff --git a/lib/sasl/doc/src/sasl_app.xml b/lib/sasl/doc/src/sasl_app.xml index 52f449c2a8..0576397f9b 100644 --- a/lib/sasl/doc/src/sasl_app.xml +++ b/lib/sasl/doc/src/sasl_app.xml @@ -31,17 +31,17 @@ sasl The SASL application -

The SASL application provides the following services:

+

The SASL application provides the following services:

alarm_handler rb release_handler systools -

The SASL application also includes error_logger event - handlers for formatting SASL error and crash reports.

+

The SASL application also includes error_logger event + handlers for formatting SASL error and crash reports.

-

The SASL application in OTP has nothing to do with +

The SASL application in OTP has nothing to do with "Simple Authentication and Security Layer" (RFC 4422).

 @@ -49,7 +49,7 @@
Error Logger Event Handlers

The following error logger event handlers are used by - the SASL application.

+ the SASL application.

sasl_report_tty_h @@ -57,7 +57,7 @@ reports, and progress reports to stdio. This error logger event handler uses error_logger_format_depth - in the Kernel application to limit how much detail is + in the Kernel application to limit how much detail is printed in crash and supervisor reports.

 sasl_report_file_h @@ -66,7 +66,7 @@ report, and progress report to a single file. This error logger event handler uses error_logger_format_depth - in the Kernel application to limit the details + in the Kernel application to limit the details printed in crash and supervisor reports.

log_mf_h @@ -75,9 +75,9 @@ error logger to disk. Multiple files and log rotation are used. For efficiency reasons, each event is written as a binary. For more information about this handler, - see the STDLIB Reference + see the STDLIB Reference Manual.

-

To activate this event handler, three SASL +

To activate this event handler, three SASL configuration parameters must be set, error_logger_mf_dir, error_logger_mf_maxbytes, and error_logger_mf_maxfiles. The next section provides @@ -88,9 +88,9 @@

Configuration -

The following configuration parameters are defined for the SASL +

The following configuration parameters are defined for the SASL application. For more information about configuration parameters, see - app(4) in Kernel.

+ app(4) in Kernel.

All configuration parameters are optional.

@@ -112,7 +112,7 @@ Use [append] to have the FileName open in append mode. FileName is a string.

false -

No SASL error logger handler is installed.

 +

No SASL error logger handler is installed.

 diff --git a/lib/sasl/doc/src/sasl_intro.xml b/lib/sasl/doc/src/sasl_intro.xml index b71dafb192..f74a7c1db8 100644 --- a/lib/sasl/doc/src/sasl_intro.xml +++ b/lib/sasl/doc/src/sasl_intro.xml @@ -32,7 +32,7 @@
Scope -

The SASL application provides support for:

+

The SASL application provides support for:

Error logging Alarm handling diff --git a/lib/sasl/doc/src/systools.xml b/lib/sasl/doc/src/systools.xml index 7446762de4..fa503fa573 100644 --- a/lib/sasl/doc/src/systools.xml +++ b/lib/sasl/doc/src/systools.xml @@ -85,7 +85,7 @@

If the emulator needs to be restarted after upgrading or - downgrading, that is, if the ERTS version differs + downgrading, that is, if the ERTS version differs between Name.rel and Name2.rel

 @@ -201,10 +201,10 @@ between the applications. Where there are no dependencies, the order in the .rel file is kept.

The function fails if the mandatory - applications Kernel and STDLIB are not + applications Kernel and STDLIB are not included in the .rel file and have start type permanent (which is default).

-

If SASL is not included as an application in +

If SASL is not included as an application in the .rel file, a warning is issued because such a release cannot be used in an upgrade. To turn off this warning, add option no_warn_sasl.

diff --git a/lib/ssh/doc/src/ssh.xml b/lib/ssh/doc/src/ssh.xml index e6c54d27bf..ef9f7cbd9b 100644 --- a/lib/ssh/doc/src/ssh.xml +++ b/lib/ssh/doc/src/ssh.xml @@ -4,7 +4,7 @@
- 20042015 + 20042016 Ericsson AB. All Rights Reserved. @@ -756,7 +756,7 @@

Utility function that starts the applications crypto, public_key, and ssh. Default type is temporary. For more information, see the application(3) - manual page in kernel.

+ manual page in Kernel.

@@ -769,7 +769,7 @@

Stops the ssh application. For more information, see the application(3) - manual page in kernel.

+ manual page in Kernel.

 diff --git a/lib/ssh/doc/src/ssh_app.xml b/lib/ssh/doc/src/ssh_app.xml index f6ce44c015..5cc4c24889 100644 --- a/lib/ssh/doc/src/ssh_app.xml +++ b/lib/ssh/doc/src/ssh_app.xml @@ -4,7 +4,7 @@
- 20122015 + 20122016 Ericsson AB. All Rights Reserved. @@ -203,7 +203,7 @@
Unicode support

Unicode filenames are supported if the emulator and the underlaying OS support it. See section DESCRIPTION in the - file manual page in kernel for information about this subject. + file manual page in Kernel for information about this subject.

The shell and the cli both support unicode.

diff --git a/lib/ssh/doc/src/ssh_channel.xml b/lib/ssh/doc/src/ssh_channel.xml index 907b0b3bec..7b598494f7 100644 --- a/lib/ssh/doc/src/ssh_channel.xml +++ b/lib/ssh/doc/src/ssh_channel.xml @@ -139,7 +139,7 @@ enters the ssh_channel process receive loop and become an ssh_channel process. The process must have been started using one of the start functions in proc_lib, see the proc_lib(3) manual page in stdlib. + marker="stdlib:proc_lib">proc_lib(3) manual page in STDLIB. The user is responsible for any initialization of the process and must call ssh_channel:init/1.

diff --git a/lib/ssl/doc/src/ssl_distribution.xml b/lib/ssl/doc/src/ssl_distribution.xml index 4bd5f67202..1150043e76 100644 --- a/lib/ssl/doc/src/ssl_distribution.xml +++ b/lib/ssl/doc/src/ssl_distribution.xml @@ -71,8 +71,8 @@
Building Boot Scripts Including the ssl Application

Boot scripts are built using the systools utility in the - sasl application. For more information on systools, - see the sasl documentation. This is only an example of + SASL application. For more information on systools, + see the SASL documentation. This is only an example of what can be done.

The simplest boot script possible includes only the Kernel diff --git a/lib/stdlib/doc/src/dets.xml b/lib/stdlib/doc/src/dets.xml index 3b134d00b7..2e4261d72e 100644 --- a/lib/stdlib/doc/src/dets.xml +++ b/lib/stdlib/doc/src/dets.xml @@ -391,7 +391,7 @@

{hash, Hash} - Describes which BIF is used to calculate the hash values of the objects stored in the - dets table. Possible values of Hash:

+ Dets table. Possible values of Hash:

hash - Implies that the erlang:hash/2 BIF diff --git a/lib/stdlib/doc/src/ets.xml b/lib/stdlib/doc/src/ets.xml index 3653c6a632..5f5d2b7f36 100644 --- a/lib/stdlib/doc/src/ets.xml +++ b/lib/stdlib/doc/src/ets.xml @@ -369,7 +369,7 @@ variable that in turn is passed to the function.

The parse transform is provided in the ms_transform module and the source must include - file ms_transform.hrl in STDLIB for this + file ms_transform.hrl in STDLIB for this pseudo function to work. Failing to include the hrl file in the source results in a runtime error, not a compile time error. The include file is easiest included by adding line @@ -1644,7 +1644,7 @@ is_integer(X), is_integer(Y), X + Y < 4711]]>

Whenever option extended_info is used, it results in a file not readable by versions of ETS before - that in STDLIB 1.15.1

+ that in STDLIB 1.15.1

If option sync is set to true, it ensures that the content of the file is written to the disk before tab2file returns. Defaults to {sync, false}.

@@ -1725,7 +1725,7 @@ is_integer(X), is_integer(Y), X + Y < 4711]]>

A tuple {Major,Minor} containing the major and minor version of the file format for ETS table dumps. This - version field was added beginning with STDLIB 1.5.1. + version field was added beginning with STDLIB 1.5.1. Files dumped with older versions return {0,0} in this field.

 diff --git a/lib/stdlib/doc/src/notes.xml b/lib/stdlib/doc/src/notes.xml index d8fec1147f..f0347703e7 100644 --- a/lib/stdlib/doc/src/notes.xml +++ b/lib/stdlib/doc/src/notes.xml @@ -526,7 +526,7 @@

- The stdlib reference manual is updated to show + The STDLIB reference manual is updated to show correct information about the return value of gen_fsm:reply/2.

@@ -6236,7 +6236,7 @@ documentation for compile on how to provide the key for encrypting, and the documentation for beam_lib on how to provide the key for decryption so that tools such - as the Debugger, xref, or cover can be used.

+ as the Debugger, Xref, or Cover can be used.

The beam_lib:chunks/2 functions now accepts an additional chunk type compile_info to retrieve the compilation information directly as a term. (Thanks diff --git a/lib/stdlib/doc/src/proc_lib.xml b/lib/stdlib/doc/src/proc_lib.xml index 58ca5644cf..da03c39a26 100644 --- a/lib/stdlib/doc/src/proc_lib.xml +++ b/lib/stdlib/doc/src/proc_lib.xml @@ -59,9 +59,9 @@

When a process that is started using proc_lib terminates abnormally (that is, with another exit reason than normal, shutdown, or {shutdown,Term}), a crash report - is generated, which is written to terminal by the default SASL + is generated, which is written to terminal by the default SASL event handler. That is, the crash report is normally only visible - if the SASL application is started; see + if the SASL application is started; see sasl(6) and section SASL Error Logging in the SASL User's Guide.

diff --git a/lib/stdlib/doc/src/stdlib_app.xml b/lib/stdlib/doc/src/stdlib_app.xml index cde73269a8..f857cc394b 100644 --- a/lib/stdlib/doc/src/stdlib_app.xml +++ b/lib/stdlib/doc/src/stdlib_app.xml @@ -31,14 +31,14 @@ STDLIB The STDLIB application. -

The STDLIB application is mandatory in the sense that the minimal - system based on Erlang/OTP consists of Kernel and STDLIB. - The STDLIB application contains no services.

+

The STDLIB application is mandatory in the sense that the minimal + system based on Erlang/OTP consists of Kernel and STDLIB. + The STDLIB application contains no services.
Configuration -

The following configuration parameters are defined for the STDLIB +

The following configuration parameters are defined for the STDLIB application. For more information about configuration parameters, see the app(4) module in Kernel.

diff --git a/lib/stdlib/doc/src/timer.xml b/lib/stdlib/doc/src/timer.xml index 8f2ce36b06..fcaccdb2cb 100644 --- a/lib/stdlib/doc/src/timer.xml +++ b/lib/stdlib/doc/src/timer.xml @@ -253,7 +253,7 @@ is needed. This is useful during development, but in a target system the server is to be started explicitly. Use configuration parameters for - Kernel for this.

+ Kernel for this.

diff --git a/lib/stdlib/doc/src/unicode_usage.xml b/lib/stdlib/doc/src/unicode_usage.xml index 7f79ac88a1..efc8b75075 100644 --- a/lib/stdlib/doc/src/unicode_usage.xml +++ b/lib/stdlib/doc/src/unicode_usage.xml @@ -274,8 +274,8 @@ marker="stdlib:io">io module, the file handling, the unicode module, and - the bit syntax). Today most modules in Kernel and - STDLIB, as well as the VM are Unicode-aware.

+ the bit syntax). Today most modules in Kernel and + STDLIB, as well as the VM are Unicode-aware.

File I/O @@ -765,7 +765,7 @@ Eshell V5.10.1 (abort with ^G) file system). The Unicode character list is used to denote filenames or directory names. If the file system content is listed, you also get Unicode lists as return value. The support - lies in the Kernel and STDLIB modules, which is why + lies in the Kernel and STDLIB modules, which is why most applications (that does not explicitly require the filenames to be in the ISO Latin-1 range) benefit from the Unicode support without change.

@@ -843,7 +843,7 @@ Eshell V5.10.1 (abort with ^G) Notes About Raw Filenames

Raw filenames were introduced together with Unicode filename support - in ERTS 5.8.2 (Erlang/OTP R14B01). The reason "raw + in ERTS 5.8.2 (Erlang/OTP R14B01). The reason "raw filenames" were introduced in the system was to be able to represent filenames, specified in different encodings on the same system, diff --git a/lib/stdlib/doc/src/zip.xml b/lib/stdlib/doc/src/zip.xml index de23608046..0b5eac1e16 100644 --- a/lib/stdlib/doc/src/zip.xml +++ b/lib/stdlib/doc/src/zip.xml @@ -138,7 +138,7 @@

File information as in file:read_file_info/1 - in Kernel

+ in Kernel

 comment @@ -345,7 +345,7 @@ prepended to filenames when extracting them from the zip archive. (Acting like - file:set_cwd/1 in Kernel, + file:set_cwd/1 in Kernel, but without changing the global cwd property.)

 @@ -420,7 +420,7 @@ (cwd). This is prepended to filenames when adding them, although not in the zip archive (acting like - file:set_cwd/1 in Kernel, but without + file:set_cwd/1 in Kernel, but without changing the global cwd property.).

{compress, What} diff --git a/lib/tools/doc/src/xref_chapter.xml b/lib/tools/doc/src/xref_chapter.xml index 8b14e03064..872793bdcb 100644 --- a/lib/tools/doc/src/xref_chapter.xml +++ b/lib/tools/doc/src/xref_chapter.xml @@ -234,7 +234,7 @@ operand of the intersection operator * is implicitly converted to the more special type of the second operand. xref:q(s, "(Mod) tools"). - All modules of the tools application. + All modules of the Tools application. xref:q(s, '"xref_.*" : Mod'). All modules with a name beginning with xref_. xref:q(s, "# E | X "). @@ -252,9 +252,9 @@ xref:q(s, "XC * (ME - strict ME)"). External calls within some module. xref:q(s, "E ||| kernel"). - All calls within the kernel application. + All calls within the Kernel application. xref:q(s, "closure E | kernel || kernel"). - All direct and indirect calls within the kernel + All direct and indirect calls within the Kernel application. Both the calling and the used functions of indirect calls are defined in modules of the kernel application, but it is possible that some functions outside -- cgit v1.2.3