From b075fbda0ad0a711344011fb365b00acd5b64760 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B6rn=20Gustavsson?= Date: Wed, 3 Apr 2019 13:20:37 +0200 Subject: Fix broken links A multitude of broken links were found when a bug was fixed in the link checker. --- erts/doc/src/alt_disco.xml | 2 +- erts/doc/src/communication.xml | 2 +- erts/doc/src/crash_dump.xml | 2 +- erts/doc/src/erl_driver.xml | 24 +++++++++++------------ erts/doc/src/erl_ext_dist.xml | 6 +++--- erts/doc/src/erl_nif.xml | 4 ++-- erts/doc/src/erlang.xml | 6 ++++-- erts/doc/src/notes.xml | 10 ++++------ lib/common_test/doc/src/ct_master.xml | 2 +- lib/common_test/doc/src/event_handler_chapter.xml | 2 +- lib/erl_docgen/src/docgen_xmerl_xml_cb.erl | 1 + lib/jinterface/doc/src/jinterface_users_guide.xml | 8 ++++---- lib/kernel/doc/src/application.xml | 2 +- lib/kernel/doc/src/auth.xml | 6 +++--- lib/kernel/doc/src/erl_ddll.xml | 4 ++-- lib/kernel/doc/src/gen_sctp.xml | 2 +- lib/kernel/doc/src/logger_chapter.xml | 2 +- lib/public_key/doc/src/public_key.xml | 3 ++- lib/stdlib/doc/src/dets.xml | 4 ++-- lib/stdlib/doc/src/digraph_utils.xml | 2 +- lib/stdlib/doc/src/proc_lib.xml | 2 +- lib/stdlib/doc/src/slave.xml | 4 ++-- system/doc/efficiency_guide/commoncaveats.xml | 5 ++--- system/doc/tutorial/overview.xml | 6 +++--- 24 files changed, 56 insertions(+), 55 deletions(-) diff --git a/erts/doc/src/alt_disco.xml b/erts/doc/src/alt_disco.xml index d04221b9b3..148d6f549e 100644 --- a/erts/doc/src/alt_disco.xml +++ b/erts/doc/src/alt_disco.xml @@ -63,7 +63,7 @@ EPMD module. However, instead of communicating with EPMD you can connect to any service to find out connection details of other nodes. A discovery module is enabled - by setting -epmd_module + by setting -epmd_module when starting erlang. The discovery module must implement the following callbacks:

diff --git a/erts/doc/src/communication.xml b/erts/doc/src/communication.xml index 7e18a73aa8..251b52dc65 100644 --- a/erts/doc/src/communication.xml +++ b/erts/doc/src/communication.xml @@ -64,7 +64,7 @@ a synchronous communication operation consists of two asynchronous signals; one request signal and one reply signal. An example of such a synchronous communication is a call to - + erlang:process_info/2 when the first argument is not self(). The caller sends an asynchronous signal requesting information, and then diff --git a/erts/doc/src/crash_dump.xml b/erts/doc/src/crash_dump.xml index a9aeb1888c..33d0903622 100644 --- a/erts/doc/src/crash_dump.xml +++ b/erts/doc/src/crash_dump.xml @@ -290,7 +290,7 @@ Slogan: <reason> Memory Information

Under the tag =memory is shown information similar to what can be obtainted on a living node with - + erlang:memory().

diff --git a/erts/doc/src/erl_driver.xml b/erts/doc/src/erl_driver.xml index 58678f2393..3e2d3bb447 100644 --- a/erts/doc/src/erl_driver.xml +++ b/erts/doc/src/erl_driver.xml @@ -230,7 +230,7 @@

With these functions, the driver sends data back to the emulator. The data is received as messages by the port owner process, see - + erlang:open_port/2. The vector function and the function taking a driver binary are faster, as they avoid copying the data buffer. There is also a fast way of sending @@ -1154,27 +1154,27 @@ r = driver_async(myPort, &myKey, myData, myFunc); ]]> start - Called from + Called from erlang:open_port/2. output - Called from + Called from erlang:send/2 and - + erlang:port_command/2. outputv - Called from + Called from erlang:send/2 and - + erlang:port_command/2. control - Called from + Called from erlang:port_control/3. call - Called from + Called from erlang:port_call/3.

Notice that this function is not thread-safe, not @@ -2305,7 +2305,7 @@ r = driver_async(myPort, &myKey, myData, myFunc); ]]> *value_size has been set to the buffer size needed.

This function reads the emulated environment used by - os:getenv/1 and not + os:getenv/1 and not the environment used by libc's getenv(3) or similar. Drivers that require that these are in sync will need to do so themselves, but keep in mind that they are segregated for a reason; @@ -2656,7 +2656,7 @@ erl_drv_output_term(driver_mk_port(drvport), spec, sizeof(spec) / sizeof(spec[0]

This function modifies the emulated environment used by - os:putenv/2 and not + os:putenv/2 and not the environment used by libc's putenv(3) or similar. Drivers that require that these are in sync will need to do so themselves, but keep in mind that they are segregated for a reason; @@ -2849,7 +2849,7 @@ erl_drv_output_term(driver_mk_port(drvport), spec, sizeof(spec) / sizeof(spec[0]

Sets the os_pid seen when doing - + erlang:port_info/2 on this port.

port is the port handle of the port (driver instance) to set the pid on. pidis the pid to set.

@@ -3204,7 +3204,7 @@ erl_drv_output_term(driver_mk_port(drvport), spec, sizeof(spec) / sizeof(spec[0] control driver entry function will return data to the port owner process. (The control function is called from - + erlang:port_control/3.)

Currently there are only two meaningful values for flags: 0 means that data is returned in a list, diff --git a/erts/doc/src/erl_ext_dist.xml b/erts/doc/src/erl_ext_dist.xml index 4721747097..6b7a6db943 100644 --- a/erts/doc/src/erl_ext_dist.xml +++ b/erts/doc/src/erl_ext_dist.xml @@ -399,7 +399,7 @@ REFERENCE_EXT

Encodes a reference object (an object generated with - erlang:make_ref/0). + erlang:make_ref/0). The Node term is an encoded atom, that is, ATOM_UTF8_EXT, SMALL_ATOM_UTF8_EXT, or @@ -437,7 +437,7 @@ PORT_EXT

Encodes a port object (obtained from - + erlang:open_port/2). The ID is a node-specific identifier for a local port. Port operations are not allowed across node boundaries. @@ -467,7 +467,7 @@ PID_EXT

Encodes a process identifier object (obtained from - erlang:spawn/3 or + erlang:spawn/3 or friends). The ID and Creation fields works just like in REFERENCE_EXT, while the Serial field is used to improve safety. diff --git a/erts/doc/src/erl_nif.xml b/erts/doc/src/erl_nif.xml index cf1994887a..c0be715678 100644 --- a/erts/doc/src/erl_nif.xml +++ b/erts/doc/src/erl_nif.xml @@ -546,8 +546,8 @@ int writeiovec(ErlNifEnv *env, ERL_NIF_TERM term, ERL_NIF_TERM *tail,

Many operations communicating with a process executing a dirty NIF can, however, complete while it executes the dirty NIF. For example, retrieving information about it through - - erlang:process_info, setting its group leader, + + process_info, setting its group leader, register/unregister its name, and so on.

Termination of a process executing a dirty NIF can only be completed up to a certain point while it executes the dirty NIF. diff --git a/erts/doc/src/erlang.xml b/erts/doc/src/erlang.xml index 0d94f83493..2b444ccf01 100644 --- a/erts/doc/src/erlang.xml +++ b/erts/doc/src/erlang.xml @@ -126,7 +126,7 @@ instance.

One can get an approximation of the native time unit by calling - + erlang:convert_time_unit(1, second, native). The result equals the number of whole native time units per second. If @@ -4663,6 +4663,7 @@ RealSystem = system + MissedSystem Information about the memory size of a port. +

Bytes is the total number of bytes allocated for this port by the runtime system. The port itself can have allocated memory that is not @@ -5387,6 +5388,7 @@ RealSystem = system + MissedSystem {memory, Size} +

Size is the size in bytes of the process. This includes call stack, heap, and internal structures.

@@ -6676,7 +6678,7 @@ lists:map( async Async threads are used by various linked-in drivers (mainly the file drivers) do offload non-CPU intensive work. See - erl +A for more details. + erl +A for more details. aux Takes care of any work that is not specifically assigned to a scheduler. diff --git a/erts/doc/src/notes.xml b/erts/doc/src/notes.xml index 7c5a8aefad..13cd4129ac 100644 --- a/erts/doc/src/notes.xml +++ b/erts/doc/src/notes.xml @@ -8363,8 +8363,7 @@ Erlang/OTP has been ported to the realtime operating system OSE. The port supports both smp and non-smp emulator. For details around the port and how to started - see the User's Guide in the ose application.

+ see the User's Guide in the ose application.

Note that not all parts of Erlang/OTP has been ported.

@@ -9470,9 +9469,9 @@ fix_alloc allocator, a different strategy for management of fix blocks will be used. The information returned from erlang:system_info({allocator, + marker="erlang#system_info_allocator_tuple">erlang:system_info({allocator, A}), and erlang:system_info({allocator_sizes, + marker="erlang#system_info_allocator_sizes">erlang:system_info({allocator_sizes, A}) will be slightly different when this feature has been enabled. An mbcs_pool tuple will be present giving information about abandoned carriers, @@ -10281,8 +10280,7 @@ information about signal ordering guarantees, see the chapter on communication in - the ERTS user's guide. The +n command line flag of + the ERTS user's guide. The +n command line flag of erl(1) can be helpful when trying to find signaling order bugs in Erlang code that have been exposed by these diff --git a/lib/common_test/doc/src/ct_master.xml b/lib/common_test/doc/src/ct_master.xml index 2ab421fe9e..f003b7de11 100644 --- a/lib/common_test/doc/src/ct_master.xml +++ b/lib/common_test/doc/src/ct_master.xml @@ -210,7 +210,7 @@

Tests are spawned on Node using - ct:run_test/1

+ ct:run_test/1

diff --git a/lib/common_test/doc/src/event_handler_chapter.xml b/lib/common_test/doc/src/event_handler_chapter.xml index bd9ed21cb4..182abba7ca 100644 --- a/lib/common_test/doc/src/event_handler_chapter.xml +++ b/lib/common_test/doc/src/event_handler_chapter.xml @@ -378,7 +378,7 @@

To ensure that printouts to stdout (or printouts made with ct:log/2,3 or - ct:pal,2,3) get written to the test case log + ct:pal,2,3) get written to the test case log file, and not to the Common Test framework log, you can synchronize with the Common Test server by matching on evvents tc_start and tc_done. In the period between these events, all I/O is directed to the diff --git a/lib/erl_docgen/src/docgen_xmerl_xml_cb.erl b/lib/erl_docgen/src/docgen_xmerl_xml_cb.erl index 59d4dccfb7..9d69143c3c 100644 --- a/lib/erl_docgen/src/docgen_xmerl_xml_cb.erl +++ b/lib/erl_docgen/src/docgen_xmerl_xml_cb.erl @@ -87,6 +87,7 @@ convert_tag(underline, Attrs) -> {em, Attrs}; convert_tag(Tag, Attrs) -> {Tag, Attrs}. is_url("http:"++_) -> true; +is_url("https:"++_) -> true; is_url("../"++_) -> true; is_url(FileRef) -> case filename:extension(FileRef) of diff --git a/lib/jinterface/doc/src/jinterface_users_guide.xml b/lib/jinterface/doc/src/jinterface_users_guide.xml index 56f88124bf..504c77f339 100644 --- a/lib/jinterface/doc/src/jinterface_users_guide.xml +++ b/lib/jinterface/doc/src/jinterface_users_guide.xml @@ -366,20 +366,20 @@ OtpNode node = new OtpNode("gurka"); OtpEpmd class. Nodes wishing to contact other nodes must first request information from Epmd before a connection can be set up, however this is done automatically - by OtpSelf.connect() when necessary.

-

When you use OtpSelf.connect() to connect to an Erlang node, + by OtpSelf.connect() when necessary.

+

When you use OtpSelf.connect() to connect to an Erlang node, a connection is first made to epmd and, if the node is known, a connection is then made to the Erlang node.

Java nodes can also register themselves with epmd if they want other nodes in the system to be able to find and connect to them. - This is done by call to method OtpEpmd.publishPort().

+ This is done by call to method OtpEpmd.publishPort().

Be aware that on some systems (such as VxWorks), a failed node will not be detected by this mechanism since the operating system does not automatically close descriptors that were left open when the node failed. If a node has failed in this way, epmd will prevent you from registering a new node with the old name, since it thinks that the old name is still in use. In this case, you must unregister the name - explicitly, by using OtpEpmd.unPublishPort()

+ explicitly, by using OtpEpmd.unPublishPort()

This will cause epmd to close the connection from the far end. Note that if the name was in fact still in use by a node, the results of this operation are unpredictable. Also, doing this does not cause the diff --git a/lib/kernel/doc/src/application.xml b/lib/kernel/doc/src/application.xml index 83a83ebad2..f4ec2c610f 100644 --- a/lib/kernel/doc/src/application.xml +++ b/lib/kernel/doc/src/application.xml @@ -582,7 +582,7 @@ Nodes = [cp1@cave, {cp2@cave, cp3@cave}] the primary application) for the primary application and all included applications, for which the start phase is defined.

For a description of StartType, see - Module:start/2.

+ Module:start/2.

diff --git a/lib/kernel/doc/src/auth.xml b/lib/kernel/doc/src/auth.xml index a57da18de9..c735d02fed 100644 --- a/lib/kernel/doc/src/auth.xml +++ b/lib/kernel/doc/src/auth.xml @@ -46,7 +46,7 @@ Magic cookie for local node (deprecated).

Use - erlang:get_cookie() + erlang:get_cookie() in ERTS instead.

 @@ -58,7 +58,7 @@

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

 @@ -94,7 +94,7 @@

Sets the magic cookie of Node to Cookie and verifies the status of the authorization. Equivalent to calling - erlang:set_cookie(Node, Cookie), followed by + erlang:set_cookie(Node, Cookie), followed by auth:is_auth(Node).

diff --git a/lib/kernel/doc/src/erl_ddll.xml b/lib/kernel/doc/src/erl_ddll.xml index f2d5e1b397..52d5bcd079 100644 --- a/lib/kernel/doc/src/erl_ddll.xml +++ b/lib/kernel/doc/src/erl_ddll.xml @@ -200,7 +200,7 @@ Remove a monitor for a driver.

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

Creates a driver monitor and works in many ways as - erlang:monitor/2 + erlang:monitor/2 in ERTS, does for processes. When a driver changes state, the monitor results in a monitor message that is sent to the calling diff --git a/lib/kernel/doc/src/gen_sctp.xml b/lib/kernel/doc/src/gen_sctp.xml index f70d6c24db..61ac1485c1 100644 --- a/lib/kernel/doc/src/gen_sctp.xml +++ b/lib/kernel/doc/src/gen_sctp.xml @@ -253,7 +253,7 @@ connect(Socket, Ip, Port>,

Assigns a new controlling process Pid to Socket. Same implementation as - gen_udp:controlling_process/2. + gen_udp:controlling_process/2.

diff --git a/lib/kernel/doc/src/logger_chapter.xml b/lib/kernel/doc/src/logger_chapter.xml index 8458ffa042..1aa4b7a3a2 100644 --- a/lib/kernel/doc/src/logger_chapter.xml +++ b/lib/kernel/doc/src/logger_chapter.xml @@ -718,7 +718,7 @@ logger:debug(#{got => connection_request, id => Id, state => State},

For all other values of HandlerId, this entry adds a new handler, equivalent to calling

- 

+	    

 		logger:add_handler(HandlerId, Module, HandlerConfig)
 	    

 	    
Multiple entries of this type are allowed.

diff --git a/lib/public_key/doc/src/public_key.xml b/lib/public_key/doc/src/public_key.xml
index fb81ea68a4..8db5620686 100644
--- a/lib/public_key/doc/src/public_key.xml
+++ b/lib/public_key/doc/src/public_key.xml
@@ -813,7 +813,8 @@ fun(#'DistributionPoint'{}, #'CertificateList'{},
       
The {OtherRefId,term()} is defined by the user and is passed to the match_fun, if defined.
       If the term in OtherRefId is a binary, it will be converted to a string.
       

-      
The ip Reference ID takes an inet:ip_address()
+      
The ip Reference ID takes an
+      inet:ip_address()
       or an ip address in string format (E.g "10.0.1.1" or "1234::5678:9012") as second element.
       

       
The options are:

diff --git a/lib/stdlib/doc/src/dets.xml b/lib/stdlib/doc/src/dets.xml
index 8e4e002000..8b9502a3b1 100644
--- a/lib/stdlib/doc/src/dets.xml
+++ b/lib/stdlib/doc/src/dets.xml
@@ -1090,8 +1090,8 @@ ok
           
           
             
select - The table is traversed by calling
-              dets:select/3 and
-              dets:select/1.
+              dets:select/3 and
+              dets:select/1.
               Option n_objects determines the number of objects
               returned (the third argument of select/3). The
               match specification (the second argument of
diff --git a/lib/stdlib/doc/src/digraph_utils.xml b/lib/stdlib/doc/src/digraph_utils.xml
index 13b0aaad9e..a23b02c6c1 100644
--- a/lib/stdlib/doc/src/digraph_utils.xml
+++ b/lib/stdlib/doc/src/digraph_utils.xml
@@ -371,7 +371,7 @@
           the default, the type of Digraph is used
           for the subgraph as well. Otherwise the option value of type
           is used as argument to
-          digraph:new/1.

+        digraph:new/1.

         
If the value of option keep_labels is true,
           which is the default,
           the labels of vertices and edges
diff --git a/lib/stdlib/doc/src/proc_lib.xml b/lib/stdlib/doc/src/proc_lib.xml
index aeb9f48735..bb983903a9 100644
--- a/lib/stdlib/doc/src/proc_lib.xml
+++ b/lib/stdlib/doc/src/proc_lib.xml
@@ -166,7 +166,7 @@
       Hibernate a process until a message is sent to it.
       
         
This function does the same as (and does call) the
-          
+          
           hibernate/3 BIF,
           but ensures that exception handling and logging continues to
           work as expected when the process wakes up.

diff --git a/lib/stdlib/doc/src/slave.xml b/lib/stdlib/doc/src/slave.xml
index 778c5f66e5..f9e42ad47d 100644
--- a/lib/stdlib/doc/src/slave.xml
+++ b/lib/stdlib/doc/src/slave.xml
@@ -51,7 +51,7 @@
 
     
An alternative to the ssh program can be specified on
       the command line to
-      erl(1) as follows:

+      erl(1) as follows:

 
     
 -rsh Program

@@ -140,7 +140,7 @@ rpc:call(N, slave, pseudo, [node(), [pxw_server]]).
         
Argument Args is used to set erl
           command-line arguments. If provided, it is passed to the new
           node and can be used for a variety of purposes; see
-          erl(1).

+          erl(1).

         
As an example, suppose that you want to start a slave node at
           host H with node name Name@H and
           want the slave node to have the following properties:

diff --git a/system/doc/efficiency_guide/commoncaveats.xml b/system/doc/efficiency_guide/commoncaveats.xml
index 367da09ba3..7b2128d888 100644
--- a/system/doc/efficiency_guide/commoncaveats.xml
+++ b/system/doc/efficiency_guide/commoncaveats.xml
@@ -36,10 +36,9 @@
      Timer Module
 
      
Creating timers using erlang:send_after/3
+     marker="erts:erlang#send_after/3">erlang:send_after/3
      and
-     erlang:start_timer/3
-,
+     erlang:start_timer/3,
      is much more efficient than using the timers provided by the
      timer module in STDLIB.
      The timer module uses a separate process to manage the timers.
diff --git a/system/doc/tutorial/overview.xml b/system/doc/tutorial/overview.xml
index 255c22f2c1..bd652b1e4b 100644
--- a/system/doc/tutorial/overview.xml
+++ b/system/doc/tutorial/overview.xml
@@ -245,13 +245,13 @@ Term = binary_to_term(Binary)
- IC + IC and CORBA

IC (Erlang IDL Compiler) is an interface generator that, given an IDL interface specification, automatically generates stub code in Erlang, C, or Java. See the IC User's Guide and IC Reference Manual.

-

For details, see the ic - manual page in IC.

+

For details, see the + corba repository.

-- cgit v1.2.3