reference/hash/functions/hash-hkdf.xml
91e303f2d27cbca485137230fa7d2e50e75f19a6
...
...
@@ -83,20 +83,46 @@
83
83
&reftitle.returnvalues;
84
84
<para>
85
85
Returns a string containing a raw binary representation of the derived key
86
-
(also known as output keying material - OKM); or &false; on failure.
86
+
(also known as output keying material - OKM).
87
87
</para>
88
88
</refsect1>
89
89

90
90
<refsect1 role="errors">
91
91
&reftitle.errors;
92
92
<para>
93
-
An <constant>E_WARNING</constant> will be raised if <parameter>key</parameter>
93
+
Throws a <classname>ValueError</classname> exception if <parameter>key</parameter>
94
94
is empty, <parameter>algo</parameter> is unknown/non-cryptographic,
95
95
<parameter>length</parameter> is less than <literal>0</literal> or too large
96
96
(greater than 255 times the size of the hash function).
97
97
</para>
98
98
</refsect1>
99
99

100
+
<refsect1 role="changelog">
101
+
&reftitle.changelog;
102
+
<para>
103
+
<informaltable>
104
+
<tgroup cols="2">
105
+
<thead>
106
+
<row>
107
+
<entry>&Version;</entry>
108
+
<entry>&Description;</entry>
109
+
</row>
110
+
</thead>
111
+
<tbody>
112
+
<row>
113
+
<entry>8.0.0</entry>
114
+
<entry>
115
+
Now throws a <classname>ValueError</classname> exception on error.
116
+
Previously, &false; was returned and an <constant>E_WARNING</constant>
117
+
message was emitted.
118
+
</entry>
119
+
</row>
120
+
</tbody>
121
+
</tgroup>
122
+
</informaltable>
123
+
</para>
124
+
</refsect1>
125
+

100
126
<refsect1 role="examples">
101
127
&reftitle.examples;
102
128
<para>
103
129