pathman: documentation update

zilder · zilder · commit 64757018d2bb · 2016-02-01T10:14:49.000+03:00
diff --git a/contrib/pg_pathman/README.md b/contrib/pg_pathman/README.md
@@ -63,17 +63,32 @@ create_range_partitions(
     start_value ANYELEMENT,
     interval ANYELEMENT,
     premake INTEGER)
-```
-Performs RANGE partitioning for `relation` by partitioning key `attribute`. `start_value` argument specifies initial value, `interval` sets the range of values in a single partition, `premake` is the number of premade partitions (the only one partition will be created if `premake` is 0).
-```
+
 create_range_partitions(
     relation TEXT,
     attribute TEXT,
     start_value ANYELEMENT,
     interval INTERVAL,
     premake INTEGER)
 ```
-Same as above but suitable for `DATE` and `TIMESTAMP` partitioning keys.
+Performs RANGE partitioning for `relation` by partitioning key `attribute`. `start_value` argument specifies initial value, `interval` sets the range of values in a single partition, `premake` is the number of premade partitions.
+
+```
+create_partitions_from_range(
+    relation TEXT,
+    attribute TEXT,
+    start_value ANYELEMENT,
+    end_value ANYELEMENT,
+    interval ANYELEMENT)
+
+create_partitions_from_range(
+    relation TEXT,
+    attribute TEXT,
+    start_value ANYELEMENT,
+    end_value ANYELEMENT,
+    interval INTERVAL)
+```
+Performs RANGE-partitioning from specified range for `relation` by partitioning key `attribute`.
 
 ### Utilities
 ```
@@ -159,9 +174,9 @@ INSERT INTO range_rel (dt) SELECT g FROM generate_series('2010-01-01'::date, '20
 ```
 Run create_range_partitions() function to create partitions so that each partition would contain data for one month:
 ```
-SELECT create_range_partitions('range_rel', 'dt', '2010-01-01'::date, '1 month'::interval, 59);
+SELECT create_range_partitions('range_rel', 'dt', '2010-01-01'::date, '1 month'::interval, 60);
 ```
-It will create 60 partitions (one partition is created regardless of `premake` parameter). Now move data from the parent to partitions.
+It will create 60 partitions. Now let's move data from the parent to partitions.
 ```
 SELECT partition_data('range_rel');
 ```
diff --git a/contrib/pg_pathman/README.rus.md b/contrib/pg_pathman/README.rus.md
@@ -65,17 +65,32 @@ create_range_partitions(
     start_value ANYELEMENT,
     interval ANYELEMENT,
     premake INTEGER)
-```
-Выполняет RANGE-секционирование таблицы `relation` по полю `attribute`. Аргумент `start_value` задает начальное значение, `interval` -- диапазон значений внутри одной секции, `premake` -- количество заранее создаваемых секций (если 0, то будет создана единственная секция).
-```
+
 create_range_partitions(
     relation TEXT,
     attribute TEXT,
     start_value ANYELEMENT,
     interval INTERVAL,
     premake INTEGER)
 ```
-Аналогично предыдущей с тем лишь отличием, что данная функция предназначена для секционирования по полю типа `DATE` или `TIMESTAMP`.
+Выполняет RANGE-секционирование таблицы `relation` по полю `attribute`. Аргумент `start_value` задает начальное значение, `interval` -- диапазон значений внутри одной секции, `premake` -- количество заранее создаваемых секций.
+
+```
+create_partitions_from_range(
+    relation TEXT,
+    attribute TEXT,
+    start_value ANYELEMENT,
+    end_value ANYELEMENT,
+    interval ANYELEMENT)
+
+create_partitions_from_range(
+    relation TEXT,
+    attribute TEXT,
+    start_value ANYELEMENT,
+    end_value ANYELEMENT,
+    interval INTERVAL)
+```
+Выполняет RANGE-секционирование для заданного диапазона таблицы `relation` по полю `attribute`.
 
 ### Утилиты
 ```
@@ -162,9 +177,8 @@ INSERT INTO range_rel (dt) SELECT g FROM generate_series('2010-01-01'::date, '20
 ```
 Разобьем таблицу на 60 секций так, чтобы каждая секция содержала данные за один месяц:
 ```
-SELECT create_range_partitions('range_rel', 'dt', '2010-01-01'::date, '1 month'::interval, 59);
+SELECT create_range_partitions('range_rel', 'dt', '2010-01-01'::date, '1 month'::interval, 60);
 ```
-> Значение `premake` равно 59, а не 60, т.к. 1 секция создается независимо от значения `premake`
 
 Перенесем данные из родительской таблицы в дочерние секции.
 ```
