Docs(hash_functions): fix javaHash & hiveHash functions

docs/en/query_language/functions/hash_functions.md

@@ -177,15 +177,65 @@ SELECT farmHash64(array('e','x','a'), 'mple', 10, toDateTime('2019-06-15 23:00:0
 
 ## javaHash {#hash_functions-javahash}
 
-Calculates [JavaHash](http://hg.openjdk.java.net/jdk8u/jdk8u/jdk/file/478a4add975b/src/share/classes/java/lang/String.java#l1452)
- from a string.
-Accepts a String-type argument. Returns Int32.
+Calculates [JavaHash](http://hg.openjdk.java.net/jdk8u/jdk8u/jdk/file/478a4add975b/src/share/classes/java/lang/String.java#l1452) from a string. This hash function is neither fast nor having a good quality. The only reason to use it is when this algorithm is already used in another system and you have to calculate exactly the same result.
 
-## hiveHash
+```sql
+SELECT javaHash('');
+```
+
+**Returned value**
+
+A `Int32` data type hash value.
+
+Type: `javaHash`.
+
+**Example**
+
+Query:
+
+```sql
+SELECT javaHash('Hello, world!');
+```
+
+Result:
+
+```text
+┌─javaHash('Hello, world!')─┐
+│               -1880044555 │
+└───────────────────────────┘
+```
+
+## hiveHash {#hash_functions-hivehash}
+
+Calculates `HiveHash` from a string.
 
-Calculates HiveHash from a string.
-Accepts a String-type argument. Returns Int32.
-This is just [JavaHash](#hash_functions-javahash) with zeroed out sign bit. This function is used in [Apache Hive](https://en.wikipedia.org/wiki/Apache_Hive) for versions before 3.0.
+```sql
+SELECT hiveHash('');
+```
+
+This is just [JavaHash](#hash_functions-javahash) with zeroed out sign bit. This function is used in [Apache Hive](https://en.wikipedia.org/wiki/Apache_Hive) for versions before 3.0. This hash function is neither fast nor having a good quality. The only reason to use it is when this algorithm is already used in another system and you have to calculate exactly the same result.
+
+**Returned value**
+
+A `Int32` data type hash value.
+
+Type: `hiveHash`.
+
+**Example**
+
+Query:
+
+```sql
+SELECT hiveHash('Hello, world!');
+```
+
+Result:
+
+```text
+┌─hiveHash('Hello, world!')─┐
+│                 267439093 │
+└───────────────────────────┘
+```
 
 ## metroHash64
 

docs/ru/query_language/functions/hash_functions.md

@@ -179,14 +179,65 @@ SELECT farmHash64(array('e','x','a'), 'mple', 10, toDateTime('2019-06-15 23:00:0
 
 ## javaHash {#hash_functions-javahash}
 
-Вычисляет [JavaHash](http://hg.openjdk.java.net/jdk8u/jdk8u/jdk/file/478a4add975b/src/share/classes/java/lang/String.java#l1452) от строки.
-Принимает аргумент типа String. Возвращает значение типа Int32.
+Вычисляет [JavaHash](http://hg.openjdk.java.net/jdk8u/jdk8u/jdk/file/478a4add975b/src/share/classes/java/lang/String.java#l1452) от строки. `JavaHash` не отличается ни скоростью, ни качеством, поэтому эту функцию следует считать устаревшей. Используйте эту функцию, если вам необходимо получить значение хэша по такому же алгоритму.
 
-## hiveHash
+```sql
+SELECT javaHash('');
+```
+
+**Возвращаемое значение**
+
+Хэш-значение типа `Int32`.
+
+Тип: `javaHash`.
+
+**Пример**
+
+Запрос:
+
+```sql
+SELECT javaHash('Hello, world!');
+```
+
+Ответ:
+
+```text
+┌─javaHash('Hello, world!')─┐
+│               -1880044555 │
+└───────────────────────────┘
+```
+
+## hiveHash {#hash_functions-hivehash}
+
+Вычисляет `HiveHash` от строки.
 
-Вычисляет HiveHash от строки.
-Принимает аргумент типа String. Возвращает значение типа Int32.
-HiveHash — это результат [JavaHash](#hash_functions-javahash) с обнулённым битом знака числа.  Функция используется в [Apache Hive](https://en.wikipedia.org/wiki/Apache_Hive) вплоть до версии  3.0.
+```sql
+SELECT hiveHash('');
+```
+
+`HiveHash` — это результат [JavaHash](#hash_functions-javahash) с обнулённым битом знака числа. Функция используется в [Apache Hive](https://en.wikipedia.org/wiki/Apache_Hive) вплоть до версии  3.0.
+
+**Возвращаемое значение**
+
+Хэш-значение типа `Int32`.
+
+Тип: `hiveHash`.
+
+**Пример**
+
+Запрос:
+
+```sql
+SELECT hiveHash('Hello, world!');
+```
+
+Ответ:
+
+```text
+┌─hiveHash('Hello, world!')─┐
+│                 267439093 │
+└───────────────────────────┘
+```
 
 ## metroHash64