diff options
Diffstat (limited to 'lib/kernel/doc/src')
| -rw-r--r-- | lib/kernel/doc/src/code.xml | 6 | ||||
| -rw-r--r-- | lib/kernel/doc/src/eep48_chapter.xml | 3 | ||||
| -rw-r--r-- | lib/kernel/doc/src/inet_res.xml | 56 | ||||
| -rw-r--r-- | lib/kernel/doc/src/notes.xml | 71 |
4 files changed, 110 insertions, 26 deletions
diff --git a/lib/kernel/doc/src/code.xml b/lib/kernel/doc/src/code.xml index 81186b6876..967b868b5e 100644 --- a/lib/kernel/doc/src/code.xml +++ b/lib/kernel/doc/src/code.xml @@ -87,7 +87,7 @@ directory described above, except that directories without an <c>ebin</c> directory are ignored.</p> <p>All application directories found in the additional directories - appears before the standard OTP applications, except for the + appear before the standard OTP applications, except for the 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 @@ -779,8 +779,8 @@ rpc:call(Node, code, load_binary, [Module, Filename, Binary]), <c>{error,missing}</c>. </p> <p>For more information about the documentation chunk see - <seeguide marker="erl_docgen:doc_storage">Documentation Storage</seeguide> - in Erl_Docgen's User's Guide.</p> + <seeguide marker="kernel:eep48_chapter">Documentation Storage and Format</seeguide> + in Kernel's User's Guide.</p> </desc> </func> <func> diff --git a/lib/kernel/doc/src/eep48_chapter.xml b/lib/kernel/doc/src/eep48_chapter.xml index db5d13eb7a..2173dfd949 100644 --- a/lib/kernel/doc/src/eep48_chapter.xml +++ b/lib/kernel/doc/src/eep48_chapter.xml @@ -38,6 +38,9 @@ <p>To fetch the EEP-48 documentation for a module you can use <seemfa marker="code#get_doc/1"><c>code:get_doc/1</c></seemfa>.</p> + <p>To render the EEP-48 documentation for an Erlang module you can use + <seemfa marker="stdlib:shell_docs#render/2"><c>shell_docs:render/2</c></seemfa>.</p> + <section> <title>the "Docs" storage</title> <p>To look for documentation for a module name example, a tool should:</p> diff --git a/lib/kernel/doc/src/inet_res.xml b/lib/kernel/doc/src/inet_res.xml index c30038f4cd..f50915a2e2 100644 --- a/lib/kernel/doc/src/inet_res.xml +++ b/lib/kernel/doc/src/inet_res.xml @@ -4,7 +4,7 @@ <erlref> <header> <copyright> - <year>2009</year><year>2018</year> + <year>2009</year><year>2020</year> <holder>Ericsson AB. All Rights Reserved.</holder> </copyright> <legalnotice> @@ -48,31 +48,41 @@ <section> <title>Name Resolving</title> <p>UDP queries are used unless resolver option - <c>usevc</c> is <c>true</c>, which forces TCP queries. - If the query is too large for UDP, TCP is used instead. - For regular DNS queries, 512 bytes is the size limit.</p> + <c>usevc</c> is <c>true</c>, which forces TCP queries. + If the query is too large for UDP, TCP is used instead. + For regular DNS queries, 512 bytes is the size limit.</p> + <p>When EDNS is enabled (resolver option - <c>edns</c> is set to the EDNS version (that is, <c>0</c> - instead of <c>false</c>), resolver option - <c>udp_payload_size</c> sets the limit. If a name server - replies with the TC bit set (truncation), indicating that - the answer is incomplete, the query is retried - to that name server using TCP. Resolver option - <c>udp_payload_size</c> also sets the advertised - size for the maximum allowed reply size, if EDNS is - enabled, otherwise the name server uses the limit - 512 bytes. If the reply is larger, it gets truncated, - forcing a TCP requery.</p> + <c>edns</c> is set to the EDNS version (that is, <c>0</c> + instead of <c>false</c>), resolver option + <c>udp_payload_size</c> sets the limit. If a name server + replies with the TC bit set (truncation), indicating that + the answer is incomplete, the query is retried + to that name server using TCP. Resolver option + <c>udp_payload_size</c> also sets the advertised + size for the maximum allowed reply size, if EDNS is + enabled, otherwise the name server uses the limit + 512 bytes. If the reply is larger, it gets truncated, + forcing a TCP requery.</p> + <p>For UDP queries, resolver options <c>timeout</c> - and <c>retry</c> control retransmission. - Each name server in the <c>nameservers</c> list is - tried with a time-out of <c>timeout</c>/<c>retry</c>. - Then all name servers are tried again, doubling the - time-out, for a total of <c>retry</c> times.</p> + and <c>retry</c> control retransmission. + Each name server in the <c>nameservers</c> list is + tried with a time-out of <c>timeout</c>/<c>retry</c>. + Then all name servers are tried again, doubling the + time-out, for a total of <c>retry</c> times.</p> + + <marker id="servfail_retry_timeout"/> + <p>But before all name servers are tried again, there is a + (user configurable) timeout, <c>servfail_retry_timeout</c>. + The point of this is to prevent the new query to be handled + by to the servfail cache (a client that is to eager will + actually only get what is in the servfail cache). </p> + <p>For queries not using the <c>search</c> list, - if the query to all <c>nameservers</c> results in - <c>{error,nxdomain}</c> or an empty answer, the same - query is tried for <c>alt_nameservers</c>.</p> + if the query to all <c>nameservers</c> results in + <c>{error,nxdomain}</c> or an empty answer, the same + query is tried for <c>alt_nameservers</c>.</p> </section> <section> diff --git a/lib/kernel/doc/src/notes.xml b/lib/kernel/doc/src/notes.xml index d69fbdcd13..27713c0acc 100644 --- a/lib/kernel/doc/src/notes.xml +++ b/lib/kernel/doc/src/notes.xml @@ -31,6 +31,77 @@ </header> <p>This document describes the changes made to the Kernel application.</p> +<section><title>Kernel 7.2</title> + + <section><title>Fixed Bugs and Malfunctions</title> + <list> + <item> + <p> + The <c>apply</c> call's in <c>logger.hrl</c> are now + called with <c>erlang</c> prefix to avoid clashed with + local <c>apply/3</c> functions.</p> + <p> + Own Id: OTP-16976 Aux Id: PR-2807 </p> + </item> + <item> + <p> + Fix memory leak in <c>pg</c>.</p> + <p> + Own Id: OTP-17034 Aux Id: PR-2866 </p> + </item> + <item> + <p> + Fix crash in <c>logger_proxy</c> due to stray + <c>gen_server:call</c> replies not being handled. The + stray replies come when logger is under heavy load and + the flow control mechanism is reaching its limit.</p> + <p> + Own Id: OTP-17038</p> + </item> + <item> + <p> + Fixed a bug in <c>erl_epmd:names()</c> that caused it to + return the illegal return value <c>noport</c> instead of + <c>{error, Reason}</c> where <c>Reason</c> is the actual + error reason. This bug also propagated to + <c>net_adm:names()</c>.</p> + <p> + This bug was introduced in <c>kernel</c> version 7.1 (OTP + 23.1).</p> + <p> + Own Id: OTP-17054 Aux Id: ERL-1424 </p> + </item> + </list> + </section> + + + <section><title>Improvements and New Features</title> + <list> + <item> + <p> + Add export of some resolver documented types.</p> + <p> + Own Id: OTP-16954 Aux Id: ERIERL-544 </p> + </item> + <item> + <p> + Add configurable retry timeout for resolver lookups.</p> + <p> + Own Id: OTP-16956 Aux Id: ERIERL-547 </p> + </item> + <item> + <p> + <c>gen_server:multi_call()</c> has been optimized in the + special case of only calling the local node with timeout + set to <c>infinity</c>.</p> + <p> + Own Id: OTP-17058 Aux Id: PR-2887 </p> + </item> + </list> + </section> + +</section> + <section><title>Kernel 7.1</title> <section><title>Fixed Bugs and Malfunctions</title> |