diff --git a/reference/mhash/book.xml b/reference/mhash/book.xml index fb140b2334..488ae62363 100644 --- a/reference/mhash/book.xml +++ b/reference/mhash/book.xml @@ -15,12 +15,12 @@ message digests, message authentication codes, and more. - This is an interface to the mhash library. mhash supports a wide + This is an interface to the mhash library. Mhash supports a wide variety of hash algorithms such as MD5, SHA1, GOST, and many others. For a complete list of supported hashes, refer to the - documentation of mhash. The general rule is that you can access - the hash algorithm from PHP with MHASH_HASHNAME. For example, to - access TIGER you use the PHP constant MHASH_TIGER. + constants page. The general rule is that you can access + the hash algorithm from PHP with MHASH_hashname. For example, to + access TIGER you use the PHP constant MHASH_TIGER. @@ -57,4 +57,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> - diff --git a/reference/mhash/configure.xml b/reference/mhash/configure.xml index dd8a336aa7..f97526b5bc 100644 --- a/reference/mhash/configure.xml +++ b/reference/mhash/configure.xml @@ -5,13 +5,13 @@ You need to compile PHP with the parameter to enable - this extension. DIR is the mhash install directory. + this extension. DIR is the mhash installation directory. As of PHP 5.3.0, the mhash extension is emulated thru the - Hash extension. This makes the directory - to the mhash installation have no effect, and requires the hash extension - to be enabled for mhash support to be available. + Hash extension. This makes + the mhash installation directory have no effect, and requires + the hash extension enabled to make the mhash support available. diff --git a/reference/mhash/constants.xml b/reference/mhash/constants.xml index dac561fde0..5c5cae6c06 100644 --- a/reference/mhash/constants.xml +++ b/reference/mhash/constants.xml @@ -5,8 +5,8 @@ &extension.constants; Here is a list of hashes which are currently supported by mhash. If a - hash is not listed here, but is listed by mhash as supported, you can - safely assume that this documentation is outdated. + hash is not listed here, but it is listed in the mhash documentation + as supported, you can safely assume that this documentation is outdated. @@ -39,41 +39,91 @@ - - MHASH_HAVAL192 - - + + MHASH_HAVAL192 + + + + + MHASH_HAVAL224 + + MHASH_HAVAL256 - - MHASH_MD4 - - + + MHASH_MD2 + + + + + MHASH_MD4 + + MHASH_MD5 - - MHASH_RIPEMD160 - - + + MHASH_RIPEMD128 + + + + + MHASH_RIPEMD256 + + + + + MHASH_RIPEMD320 + + MHASH_SHA1 - - MHASH_SHA256 - - + + MHASH_SHA192 + + + + MHASH_SHA224 + + + + + MHASH_SHA256 + + + + + MHASH_SHA384 + + + + + MHASH_SHA512 + + + + + MHASH_SNEFRU128 + + + + + MHASH_SNEFRU256 + + + MHASH_TIGER @@ -84,10 +134,15 @@ - - MHASH_TIGER160 - - + + MHASH_TIGER160 + + + + + MHASH_WHIRLPOOL + + @@ -111,4 +166,4 @@ End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file diff --git a/reference/mhash/examples.xml b/reference/mhash/examples.xml index 6af4e3c1db..852fcffb1d 100644 --- a/reference/mhash/examples.xml +++ b/reference/mhash/examples.xml @@ -5,7 +5,7 @@ &reftitle.examples; - Compute the MD5 digest and hmac and print it out as hex + Computes the MD5 digest and hmac and print it out as hex \n"; ]]> - This will produce: + &example.outputs; - diff --git a/reference/mhash/functions/mhash-count.xml b/reference/mhash/functions/mhash-count.xml index 382186f9fe..5e301fc109 100644 --- a/reference/mhash/functions/mhash-count.xml +++ b/reference/mhash/functions/mhash-count.xml @@ -3,7 +3,7 @@ mhash_count - Get the highest available hash id + Gets the highest available hash ID @@ -13,15 +13,15 @@ - Gets the highest available hash id. + Gets the highest available hash ID. &reftitle.returnvalues; - Returns the highest available hash id. Hashes are numbered from 0 to this - hash id. + Returns the highest available hash ID. Hashes are numbered from 0 to this + hash ID. diff --git a/reference/mhash/functions/mhash-get-block-size.xml b/reference/mhash/functions/mhash-get-block-size.xml index 05115d2145..b887d891c3 100644 --- a/reference/mhash/functions/mhash-get-block-size.xml +++ b/reference/mhash/functions/mhash-get-block-size.xml @@ -3,7 +3,7 @@ mhash_get_block_size - Get the block size of the specified hash + Gets the block size of the specified hash @@ -25,7 +25,7 @@ hash - The hash id. One of the MHASH_XXX constants. + The hash ID. One of the MHASH_hashname constants. diff --git a/reference/mhash/functions/mhash-get-hash-name.xml b/reference/mhash/functions/mhash-get-hash-name.xml index 4b5246a9f5..2e0fca04d2 100644 --- a/reference/mhash/functions/mhash-get-hash-name.xml +++ b/reference/mhash/functions/mhash-get-hash-name.xml @@ -3,7 +3,7 @@ mhash_get_hash_name - Get the name of the specified hash + Gets the name of the specified hash @@ -25,7 +25,7 @@ hash - The hash id. One of the MHASH_XXX constants. + The hash ID. One of the MHASH_hashname constants. @@ -44,7 +44,7 @@ &reftitle.examples; - <function>mhash_get_hash_name</function> example + <function>mhash_get_hash_name</function> Example intbytes - Generates a key according to the hash given a user + Generates a key according to the given hash, using an user provided password. @@ -41,8 +41,8 @@ hash - The hash id used to create the key. - One of the MHASH_XXX constants. + The hash ID used to create the key. + One of the MHASH_hashname constants. @@ -50,7 +50,7 @@ password - User supplied password. + An user supplied password. @@ -59,10 +59,10 @@ Must be different and random enough for every key you generate in - order to create different keys. That salt must be known when you check - the keys, thus it is a good idea to append the key to it. Salt has a - fixed length of 8 bytes and will be padded with zeros if you supply - less bytes. + order to create different keys. Because salt + must be known when you check the keys, it is a good idea to append + the key to it. Salt has a fixed length of 8 bytes and will be padded + with zeros if you supply less bytes. diff --git a/reference/mhash/functions/mhash.xml b/reference/mhash/functions/mhash.xml index 38987233a9..776c06d3fc 100644 --- a/reference/mhash/functions/mhash.xml +++ b/reference/mhash/functions/mhash.xml @@ -3,7 +3,7 @@ mhash - Compute hash + Computes hash @@ -28,7 +28,7 @@ hash - The hash id. One of the MHASH_XXX constants. + The hash ID. One of the MHASH_hashname constants. @@ -59,7 +59,7 @@ &reftitle.returnvalues; Returns the resulting hash (also called digest) or HMAC as a string, or - &false; on errors. + &false; on error.