man: improvements

2 files changed, 7 insertions, 6 deletions

diff --git a/man/blogc-pagination.7.ronn b/man/blogc-pagination.7.ronn
index cca8aba..ceb41d6 100644
--- a/man/blogc-pagination.7.ronn
+++ b/man/blogc-pagination.7.ronn
@@ -31,14 +31,15 @@ files passed as arguments to it:
 
   * `FILTER_REVERSE`:
     Boolean (1/y/yes/true/on), if set, blogc(1) will list files in reverse order.
-    This is always the first filter applied to the files. All the previous filters
-    will get the files already in the reverse order, and won't care about this.
+    This filter is combined with `FILTER_SORT`, and all the other filters will
+    get the files already in the reverse order.
 
   * `FILTER_SORT`:
     Boolean (1/y/yes/true/on), if set, blogc(1) will sort files using the `DATE`
     variable provided in the files, instead of respecting the order of the
-    source files provided to blogc(1). All the previous filters will get the
-    files already sorted, and won't care about this.
+    source files provided to blogc(1). The files are sorted in descending order
+    and combined with `FILTER_REVERSE`, that will result in the files sorted in
+    ascending order. All the other filters will get the files already sorted.
 
 ## TEMPLATE VARIABLES
 
diff --git a/man/blogcfile.5.ronn b/man/blogcfile.5.ronn
index fd77e1c..3d4f482 100644
--- a/man/blogcfile.5.ronn
+++ b/man/blogcfile.5.ronn
@@ -117,8 +117,8 @@ however these rules can be customized with the following settings, from the
 
   * `posts_sort` (default: `false`):
     If true, blogc(1) will sort the posts by date, despite the order of the posts
-    in the `[posts]` section. It is compatible with `html_order` and `atom_order`
-    settings.
+    in the `[posts]` section, in descending order. This setting is compatible with
+    `html_order` and `atom_order` settings, to control the order of the posts.
 
   * `source_ext` (default: `.txt`):
     The extension of the source files.