aboutsummaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorRafael G. Martins <rafael@rafaelmartins.eng.br>2016-10-15 02:53:24 +0200
committerRafael G. Martins <rafael@rafaelmartins.eng.br>2016-10-15 02:53:24 +0200
commit58cd8d022f045bcf19d40253c20fc4439f60d5d8 (patch)
treea733e3f98f8bc56bf2a7503d0e47c61d47ab25ac /man
parent613f53b44279c44a8f53783d2dc4410584133431 (diff)
downloadblogc-58cd8d022f045bcf19d40253c20fc4439f60d5d8.tar.gz
blogc-58cd8d022f045bcf19d40253c20fc4439f60d5d8.tar.bz2
blogc-58cd8d022f045bcf19d40253c20fc4439f60d5d8.zip
blogc: add cli option to read list of source files from stdin
this patch adds `-i` option to command line. it will instruct blogc to read stdin and parse it as a file where each source file is a line and empty lines and lines starting with `#` are ignored. this patch makes it possible to use blogc to build big blogs with lots of pages, that would hit the operating system max command line length when calling blogc to build pages.
Diffstat (limited to 'man')
-rw-r--r--man/blogc.1.ronn19
1 files changed, 16 insertions, 3 deletions
diff --git a/man/blogc.1.ronn b/man/blogc.1.ronn
index a97122b..fc865b8 100644
--- a/man/blogc.1.ronn
+++ b/man/blogc.1.ronn
@@ -3,9 +3,15 @@ blogc(1) -- a blog compiler
## SYNOPSIS
-`blogc` `-d` [`-D` <KEY>=<VALUE> ...] `-t` <TEMPLATE> [`-o` <OUTPUT>] <SOURCE><br>
-`blogc` `-d` `-l` [`-D` <KEY>=<VALUE> ...] `-t` <TEMPLATE> [`-o` <OUTPUT>] [<SOURCE> ...]<br>
-`blogc` `-d` `-l` `-p` <KEY> [`-D` <KEY>=<VALUE> ...] [<SOURCE> ...]<br>
+`blogc` [`-d`] [`-D` <KEY>=<VALUE> ...] `-t` <TEMPLATE> [`-o` <OUTPUT>] <SOURCE><br>
+`blogc` `-l` [`-d`] [`-D` <KEY>=<VALUE> ...] `-t` <TEMPLATE> [`-o` <OUTPUT>] [<SOURCE> ...]<br>
+`blogc` `-l` `-p` <KEY> [`-d`] [`-D` <KEY>=<VALUE> ...] [<SOURCE> ...]<br>
+`blogc` `-i` [`-d`] [`-D` <KEY>=<VALUE> ...] `-t` <TEMPLATE> [`-o` <OUTPUT>] &lt; <FILE_LIST><br>
+`blogc` `-i` `-l` [`-d`] [`-D` <KEY>=<VALUE> ...] `-t` <TEMPLATE> [`-o` <OUTPUT>] &lt; <FILE_LIST><br>
+`blogc` `-i` `-l` `-p` <KEY> [`-d`] [`-D` <KEY>=<VALUE> ...] &lt; <FILE_LIST><br>
+`echo` `-e` "<SOURCE>\n..." | `blogc` `-i` [`-d`] [`-D` <KEY>=<VALUE> ...] `-t` <TEMPLATE> [`-o` <OUTPUT>]<br>
+`echo` `-e` "<SOURCE>\n..." | `blogc` `-i` `-l` [`-d`] [`-D` <KEY>=<VALUE> ...] `-t` <TEMPLATE> [`-o` <OUTPUT>]<br>
+`echo` `-e` "<SOURCE>\n..." | `blogc` `-i` `-l` `-p` <KEY> [`-d`] [`-D` <KEY>=<VALUE> ...]<br>
`blogc` [`-h`|`-v`]
## DESCRIPTION
@@ -33,6 +39,13 @@ designed to be used with make(1).
* `-d`:
Activates debug.
+ * `-i`:
+ Reads list of source files from standard input. Content of standard input is
+ parsed as a file where each line is a file path. Empty lines and lines
+ starting with `#` are ignored. If some source files are provided to command
+ line while using this option, they will be parsed **before** the files read
+ from standard input.
+
* `-l`:
Activates listing mode, allowing user to provide multiple source files. See
blogc-source(7) for details.