From 58cd8d022f045bcf19d40253c20fc4439f60d5d8 Mon Sep 17 00:00:00 2001
From: "Rafael G. Martins" <rafael@rafaelmartins.eng.br>
Date: Sat, 15 Oct 2016 02:53:24 +0200
Subject: 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.
---
 man/blogc.1.ronn | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

(limited to 'man/blogc.1.ronn')

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.
-- 
cgit v1.2.3-18-g5258