Merge branch 'sverker/add-since-doc/OTP-15460' into maint

* sverker/add-since-doc/OTP-15460:
  Fill in since for multi-clause functions in erlang.erl
  Fix since attribute for troubled function docs
  Add empty 'since' attribute for old modules and functions
  Add since attribute to dtd
  Add "since" attributes in xml for new functions and modules
  erl_docgen: Generate "since" OTP version in html
  erl_interface: Fix doc for return type 'struct hostent'

1 files changed, 39 insertions, 39 deletions

diff --git a/erts/doc/src/zlib.xml b/erts/doc/src/zlib.xml
index 6f4c42da27..38229456c9 100644
--- a/erts/doc/src/zlib.xml
+++ b/erts/doc/src/zlib.xml
@@ -29,7 +29,7 @@
     <rev></rev>
     <file>zlib.xml</file>
   </header>
-  <module>zlib</module>
+  <module since="">zlib</module>
   <modulesummary>zlib compression interface.</modulesummary>
   <description>
     <p>This module provides an API for the zlib library
@@ -120,7 +120,7 @@ list_to_binary([Compressed|Last])</pre>
 
   <funcs>
     <func>
-      <name name="adler32" arity="2"/>
+      <name name="adler32" arity="2" since=""/>
       <fsummary>Calculate the Adler checksum.</fsummary>
       <desc>
         <p>Calculates the Adler-32 checksum for <c><anno>Data</anno></c>.</p>
@@ -133,7 +133,7 @@ list_to_binary([Compressed|Last])</pre>
     </func>
 
     <func>
-      <name name="adler32" arity="3"/>
+      <name name="adler32" arity="3" since=""/>
       <fsummary>Calculate the Adler checksum.</fsummary>
       <desc>
         <p>Updates a running Adler-32 checksum for <c><anno>Data</anno></c>.
@@ -153,7 +153,7 @@ Crc = lists:foldl(fun(Data,Crc0) ->
     </func>
 
     <func>
-      <name name="adler32_combine" arity="4"/>
+      <name name="adler32_combine" arity="4" since=""/>
       <fsummary>Combine two Adler-32 checksums.</fsummary>
       <desc>
         <p>Combines two Adler-32 checksums into one. For two binaries or
@@ -172,7 +172,7 @@ Crc = lists:foldl(fun(Data,Crc0) ->
     </func>
 
     <func>
-      <name name="close" arity="1"/>
+      <name name="close" arity="1" since=""/>
       <fsummary>Close a stream.</fsummary>
       <desc>
         <p>Closes the stream referenced by <c><anno>Z</anno></c>.</p>
@@ -180,7 +180,7 @@ Crc = lists:foldl(fun(Data,Crc0) ->
     </func>
 
     <func>
-      <name name="compress" arity="1"/>
+      <name name="compress" arity="1" since=""/>
       <fsummary>Compress data with standard zlib functionality.</fsummary>
       <desc>
         <p>Compresses data with zlib headers and checksum.</p>
@@ -188,7 +188,7 @@ Crc = lists:foldl(fun(Data,Crc0) ->
     </func>
 
     <func>
-      <name name="crc32" arity="1"/>
+      <name name="crc32" arity="1" since=""/>
       <fsummary>Get current CRC.</fsummary>
       <desc>
         <p>Gets the current calculated CRC checksum.</p>
@@ -202,7 +202,7 @@ Crc = lists:foldl(fun(Data,Crc0) ->
     </func>
 
     <func>
-      <name name="crc32" arity="2"/>
+      <name name="crc32" arity="2" since=""/>
       <fsummary>Calculate CRC.</fsummary>
       <desc>
         <p>Calculates the CRC checksum for <c><anno>Data</anno></c>.</p>
@@ -215,7 +215,7 @@ Crc = lists:foldl(fun(Data,Crc0) ->
     </func>
 
     <func>
-      <name name="crc32" arity="3"/>
+      <name name="crc32" arity="3" since=""/>
       <fsummary>Calculate CRC.</fsummary>
       <desc>
         <p>Updates a running CRC checksum for <c><anno>Data</anno></c>.
@@ -235,7 +235,7 @@ Crc = lists:foldl(fun(Data,Crc0) ->
     </func>
 
     <func>
-      <name name="crc32_combine" arity="4"/>
+      <name name="crc32_combine" arity="4" since=""/>
       <fsummary>Combine two CRCs.</fsummary>
       <desc>
         <p>Combines two CRC checksums into one. For two binaries or iolists,
@@ -254,7 +254,7 @@ Crc = lists:foldl(fun(Data,Crc0) ->
     </func>
 
     <func>
-      <name name="deflate" arity="2"/>
+      <name name="deflate" arity="2" since=""/>
       <fsummary>Compress data.</fsummary>
       <desc>
         <p>Same as <c>deflate(<anno>Z</anno>, <anno>Data</anno>, none)</c>.</p>
@@ -262,7 +262,7 @@ Crc = lists:foldl(fun(Data,Crc0) ->
     </func>
 
     <func>
-      <name name="deflate" arity="3"/>
+      <name name="deflate" arity="3" since=""/>
       <fsummary>Compress data.</fsummary>
       <desc>
         <p>Compresses as much data as possible, and
@@ -300,7 +300,7 @@ list_to_binary([B1,B2])</pre>
     </func>
 
     <func>
-      <name name="deflateEnd" arity="1"/>
+      <name name="deflateEnd" arity="1" since=""/>
       <fsummary>End deflate session.</fsummary>
       <desc>
         <p>Ends the deflate session and cleans all data used. Notice that this
@@ -311,7 +311,7 @@ list_to_binary([B1,B2])</pre>
     </func>
 
     <func>
-      <name name="deflateInit" arity="1"/>
+      <name name="deflateInit" arity="1" since=""/>
       <fsummary>Initialize a session for compression.</fsummary>
       <desc>
         <p>Same as <c>zlib:deflateInit(<anno>Z</anno>, default)</c>.</p>
@@ -319,7 +319,7 @@ list_to_binary([B1,B2])</pre>
     </func>
 
     <func>
-      <name name="deflateInit" arity="2"/>
+      <name name="deflateInit" arity="2" since=""/>
       <fsummary>Initialize a session for compression.</fsummary>
       <desc>
         <p>Initializes a zlib stream for compression.</p>
@@ -334,7 +334,7 @@ list_to_binary([B1,B2])</pre>
     </func>
 
     <func>
-      <name name="deflateInit" arity="6"/>
+      <name name="deflateInit" arity="6" since=""/>
       <fsummary>Initialize a session for compression.</fsummary>
       <desc>
         <p>Initiates a zlib stream for compression.</p>
@@ -410,7 +410,7 @@ list_to_binary([B1,B2])</pre>
     </func>
 
     <func>
-      <name name="deflateParams" arity="3"/>
+      <name name="deflateParams" arity="3" since=""/>
       <fsummary>Dynamicly update deflate parameters.</fsummary>
       <desc>
         <p>Dynamically updates the compression level and compression
@@ -432,7 +432,7 @@ list_to_binary([B1,B2])</pre>
     </func>
 
     <func>
-      <name name="deflateReset" arity="1"/>
+      <name name="deflateReset" arity="1" since=""/>
       <fsummary>Reset the deflate session.</fsummary>
       <desc>
         <p>Equivalent to
@@ -446,7 +446,7 @@ list_to_binary([B1,B2])</pre>
     </func>
 
     <func>
-      <name name="deflateSetDictionary" arity="2"/>
+      <name name="deflateSetDictionary" arity="2" since=""/>
       <fsummary>Initialize the compression dictionary.</fsummary>
       <desc>
         <p>Initializes the compression dictionary from the specified byte
@@ -464,7 +464,7 @@ list_to_binary([B1,B2])</pre>
     </func>
 
     <func>
-      <name name="getBufSize" arity="1"/>
+      <name name="getBufSize" arity="1" since=""/>
       <fsummary>Get buffer size.</fsummary>
       <desc>
         <p>Gets the size of the intermediate buffer.</p>
@@ -476,7 +476,7 @@ list_to_binary([B1,B2])</pre>
     </func>
 
     <func>
-      <name name="gunzip" arity="1"/>
+      <name name="gunzip" arity="1" since=""/>
       <fsummary>Uncompress data with gz header.</fsummary>
       <desc>
         <p>Uncompresses data with gz headers and checksum.</p>
@@ -484,7 +484,7 @@ list_to_binary([B1,B2])</pre>
     </func>
 
     <func>
-      <name name="gzip" arity="1"/>
+      <name name="gzip" arity="1" since=""/>
       <fsummary>Compress data with gz header.</fsummary>
       <desc>
         <p>Compresses data with gz headers and checksum.</p>
@@ -492,7 +492,7 @@ list_to_binary([B1,B2])</pre>
     </func>
 
     <func>
-      <name name="inflate" arity="2"/>
+      <name name="inflate" arity="2" since=""/>
       <fsummary>Decompress data.</fsummary>
       <desc>
         <p>Equivalent to
@@ -502,7 +502,7 @@ list_to_binary([B1,B2])</pre>
     </func>
 
     <func>
-      <name name="inflate" arity="3"/>
+      <name name="inflate" arity="3" since="OTP 20.1"/>
       <fsummary>Decompress data.</fsummary>
       <desc>
         <p>Decompresses as much data as possible. It can introduce some output
@@ -524,7 +524,7 @@ list_to_binary([B1,B2])</pre>
     </func>
 
     <func>
-      <name name="inflateChunk" arity="1"/>
+      <name name="inflateChunk" arity="1" since="OTP 18.0"/>
       <fsummary>Read next uncompressed chunk.</fsummary>
       <desc>
         <warning>
@@ -540,7 +540,7 @@ list_to_binary([B1,B2])</pre>
     </func>
 
     <func>
-      <name name="inflateChunk" arity="2"/>
+      <name name="inflateChunk" arity="2" since="OTP 18.0"/>
       <fsummary>Decompress data with limited output size.</fsummary>
       <desc>
         <warning>
@@ -584,7 +584,7 @@ loop(Z, Handler, Uncompressed) ->
     </func>
 
     <func>
-      <name name="inflateEnd" arity="1"/>
+      <name name="inflateEnd" arity="1" since=""/>
       <fsummary>End inflate session.</fsummary>
       <desc>
         <p>Ends the inflate session and cleans all data used. Notice
@@ -595,7 +595,7 @@ loop(Z, Handler, Uncompressed) ->
     </func>
 
     <func>
-      <name name="inflateGetDictionary" arity="1"/>
+      <name name="inflateGetDictionary" arity="1" since="OTP 20.0"/>
       <fsummary>Return the decompression dictionary.</fsummary>
       <desc>
         <p>Returns the decompression dictionary currently in use
@@ -607,7 +607,7 @@ loop(Z, Handler, Uncompressed) ->
     </func>
 
     <func>
-      <name name="inflateInit" arity="1"/>
+      <name name="inflateInit" arity="1" since=""/>
       <fsummary>Initialize a session for decompression.</fsummary>
       <desc>
         <p>Initializes a zlib stream for decompression.</p>
@@ -615,7 +615,7 @@ loop(Z, Handler, Uncompressed) ->
     </func>
 
     <func>
-      <name name="inflateInit" arity="2"/>
+      <name name="inflateInit" arity="2" since=""/>
       <fsummary>Initialize a session for decompression.</fsummary>
       <desc>
         <p>Initializes a decompression session on zlib stream.</p>
@@ -634,7 +634,7 @@ loop(Z, Handler, Uncompressed) ->
     </func>
 
     <func>
-      <name name="inflateReset" arity="1"/>
+      <name name="inflateReset" arity="1" since=""/>
       <fsummary>>Reset the inflate session.</fsummary>
       <desc>
         <p>Equivalent to
@@ -648,7 +648,7 @@ loop(Z, Handler, Uncompressed) ->
     </func>
 
     <func>
-      <name name="inflateSetDictionary" arity="2"/>
+      <name name="inflateSetDictionary" arity="2" since=""/>
       <fsummary>Initialize the decompression dictionary.</fsummary>
       <desc>
         <p>Initializes the decompression dictionary from the specified
@@ -688,7 +688,7 @@ new_unpack(Z, Compressed, Dict) ->
     </func>
 
     <func>
-      <name name="open" arity="0"/>
+      <name name="open" arity="0" since=""/>
       <fsummary>Open a stream and return a stream reference.</fsummary>
       <desc>
         <p>Opens a zlib stream.</p>
@@ -696,7 +696,7 @@ new_unpack(Z, Compressed, Dict) ->
     </func>
 
     <func>
-      <name name="safeInflate" arity="2"/>
+      <name name="safeInflate" arity="2" since="OTP 20.1"/>
       <fsummary>Decompress data with limited output size.</fsummary>
       <desc>
         <p>Like <seealso marker="#inflate/2"><c>inflate/2</c></seealso>,
@@ -733,7 +733,7 @@ loop(Z, Handler, {finished, Output}) ->
     </func>
 
     <func>
-      <name name="setBufSize" arity="2"/>
+      <name name="setBufSize" arity="2" since=""/>
       <fsummary>Set buffer size.</fsummary>
       <desc>
         <p>Sets the intermediate buffer size.</p>
@@ -745,7 +745,7 @@ loop(Z, Handler, {finished, Output}) ->
     </func>
 
     <func>
-      <name name="set_controlling_process" arity="2"/>
+      <name name="set_controlling_process" arity="2" since="OTP 20.1.3"/>
       <fsummary>Transfers ownership of a zlib stream.</fsummary>
       <desc>
         <p>Changes the controlling process of <c><anno>Z</anno></c> to
@@ -754,7 +754,7 @@ loop(Z, Handler, {finished, Output}) ->
     </func>
 
     <func>
-      <name name="uncompress" arity="1"/>
+      <name name="uncompress" arity="1" since=""/>
       <fsummary>Uncompress data with standard zlib functionality.</fsummary>
       <desc>
         <p>Uncompresses data with zlib headers and checksum.</p>
@@ -762,7 +762,7 @@ loop(Z, Handler, {finished, Output}) ->
     </func>
 
     <func>
-      <name name="unzip" arity="1"/>
+      <name name="unzip" arity="1" since=""/>
       <fsummary>Uncompress data without the zlib headers.</fsummary>
       <desc>
         <p>Uncompresses data without zlib headers and checksum.</p>
@@ -770,7 +770,7 @@ loop(Z, Handler, {finished, Output}) ->
     </func>
 
     <func>
-      <name name="zip" arity="1"/>
+      <name name="zip" arity="1" since=""/>
       <fsummary>Compress data without the zlib headers.</fsummary>
       <desc>
         <p>Compresses data without zlib headers and checksum.</p>