From 8c2f79f5128d49b95bd1cc69a494ef639ce9f1ed Mon Sep 17 00:00:00 2001 From: "Rafael G. Martins" Date: Thu, 2 May 2019 22:01:32 +0200 Subject: man: improvements --- man/blogc-pagination.7.ronn | 9 +++++---- man/blogcfile.5.ronn | 4 ++-- 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. -- cgit v1.2.3-18-g5258