aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRafael G. Martins <rafael@rafaelmartins.eng.br>2015-10-07 23:17:28 -0300
committerRafael G. Martins <rafael@rafaelmartins.eng.br>2015-10-07 23:17:28 -0300
commite9db16c49e4eadc40f5a4ad96acbcdea133b0030 (patch)
tree37569570b80cded4f62ae39c5da6b2e952d6deda
parente0bcd702525bc6e96813a42dfbd703d7bacac9ab (diff)
downloadblogc-e9db16c49e4eadc40f5a4ad96acbcdea133b0030.tar.gz
blogc-e9db16c49e4eadc40f5a4ad96acbcdea133b0030.tar.bz2
blogc-e9db16c49e4eadc40f5a4ad96acbcdea133b0030.zip
main: man: fixed '-l' docs
-rw-r--r--man/blogc-template.7.ronn7
-rw-r--r--man/blogc.1.ronn4
-rw-r--r--src/main.c4
3 files changed, 9 insertions, 6 deletions
diff --git a/man/blogc-template.7.ronn b/man/blogc-template.7.ronn
index d788f41..280a073 100644
--- a/man/blogc-template.7.ronn
+++ b/man/blogc-template.7.ronn
@@ -39,7 +39,7 @@ This is how an `entry` block is defined:
### listing block
The content of a `listing` block is included in the output file when blogc(1)
-is called with `-l` option, and with one or more source files. It is used
+is called with `-l` option, and with zero or more source files. It is used
to create a listing of entries, and its content will be included once for
each given source file (in the order that the source files were provided to
blogc(1)). All the variables defined in the source files are available
@@ -57,11 +57,14 @@ This is how a `listing` block is defined:
### listing_once block
The content of a `listing_once` block is included in the output file when
-blogc(1) is called with `-l` option, and with one or more source files. It is
+blogc(1) is called with `-l` option, and with zero or more source files. It is
like a `listing` block, but is only called once, and does not have access
to the local variables defined in the source files. It is useful to add
something before an entry listing.
+The content of a `listing_once` block is included even if no source file is
+provided.
+
This is how a `listing_once` block is defined:
{% block listing_once %}
diff --git a/man/blogc.1.ronn b/man/blogc.1.ronn
index 082eeff..7ee617f 100644
--- a/man/blogc.1.ronn
+++ b/man/blogc.1.ronn
@@ -4,8 +4,8 @@ blogc(1) -- a blog compiler
## SYNOPSIS
`blogc` [`-D` <KEY>=<VALUE> ...] `-t` <TEMPLATE> [`-o` <OUTPUT>] <SOURCE><br>
-`blogc` `-l` [`-D` <KEY>=<VALUE> ...] `-t` <TEMPLATE> [`-o` <OUTPUT>] <SOURCE> [<SOURCE> ...]<br>
-`blogc` `-l` `-p` <KEY> [`-D` <KEY>=<VALUE> ...] <SOURCE> [<SOURCE> ...]<br>
+`blogc` `-l` [`-D` <KEY>=<VALUE> ...] `-t` <TEMPLATE> [`-o` <OUTPUT>] [<SOURCE> ...]<br>
+`blogc` `-l` `-p` <KEY> [`-D` <KEY>=<VALUE> ...] [<SOURCE> ...]<br>
`blogc` [`-h`|`-v`]
## DESCRIPTION
diff --git a/src/main.c b/src/main.c
index 616641f..1847163 100644
--- a/src/main.c
+++ b/src/main.c
@@ -41,7 +41,7 @@ blogc_print_help(void)
printf(
"usage:\n"
" blogc [-h] [-v] [-l] [-D KEY=VALUE ...] [-p KEY] [-t TEMPLATE]\n"
- " [-o OUTPUT] SOURCE [SOURCE ...] - A blog compiler.\n"
+ " [-o OUTPUT] [SOURCE ...] - A blog compiler.\n"
"\n"
"positional arguments:\n"
" SOURCE source file(s)\n"
@@ -63,7 +63,7 @@ blogc_print_usage(void)
{
printf(
"usage: blogc [-h] [-v] [-l] [-D KEY=VALUE ...] [-p KEY] [-t TEMPLATE]\n"
- " [-o OUTPUT] SOURCE [SOURCE ...]\n");
+ " [-o OUTPUT] [SOURCE ...]\n");
}