aboutsummaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorRafael G. Martins <rafael@rafaelmartins.eng.br>2017-01-03 03:43:58 +0100
committerRafael G. Martins <rafael@rafaelmartins.eng.br>2017-01-03 03:43:58 +0100
commitf1497810051ffe86741fa7e0dc7a2b4db94d2c19 (patch)
tree122bb8f55ce2c610298bde562a0a058f1a20d63e /man
parenta4bddf83cbbac86c3734b8c399e65c7341385a85 (diff)
downloadblogc-f1497810051ffe86741fa7e0dc7a2b4db94d2c19.tar.gz
blogc-f1497810051ffe86741fa7e0dc7a2b4db94d2c19.tar.bz2
blogc-f1497810051ffe86741fa7e0dc7a2b4db94d2c19.zip
make: added initial man page
Diffstat (limited to 'man')
-rw-r--r--man/blogc-make.1.ronn79
-rw-r--r--man/index.txt1
2 files changed, 80 insertions, 0 deletions
diff --git a/man/blogc-make.1.ronn b/man/blogc-make.1.ronn
new file mode 100644
index 0000000..10819da
--- /dev/null
+++ b/man/blogc-make.1.ronn
@@ -0,0 +1,79 @@
+blogc-make(1) -- a simple build tool for blogc
+==============================================
+
+## SYNOPSIS
+
+`blogc-make` [`-V`] [`-f` <FILE>] [<RULE> ...]<br>
+`blogc-make` [`-h`|`-v`]
+
+## DESCRIPTION
+
+**blogc-make** is a simple build tool for blogc websites.
+
+EXPAND-ME!
+
+## OPTIONS
+
+ * `-V`:
+ Activates verbose mode, that will give more details of commands runs.
+
+ * `-f` <FILE>:
+ Reads <FILE> as `blogcfile`.
+
+ * `-v`:
+ Show program name, version and exit.
+
+ * `-h`:
+ Show help message and exit.
+
+## RULES
+
+TODO
+
+## FILES
+
+The `blogc-make` command expects a settings file, called `blogcfile` by default,
+or any other file passed to `-f` option. `blogcfile` must have valid UTF-8 content.
+
+The `blogc-make` command will read any files listed on `blogcfile`, and may write
+files to the configured output directory.
+
+## ENVIRONMENT
+
+ * `BLOGC`:
+ Path to `blogc(1)` binary. If not provided, the `blogc` binary in `$PATH` will
+ be used.
+
+ * `BLOGC_RUNSERVER`:
+ Path to `blogc-runserver(1)` binary. If not provided, the `blogc-runserver`
+ binary in `$PATH` will be used, if available.
+
+ * `OUTPUT_DIR`:
+ Path to the directory where `blogc-make` should write (or instruct blogc(1) to
+ write) output files. This is usually configured in `blogcfile`, but being able
+ to override it with an environment variable is useful for automated builds.
+
+Any other environment variables are inherited by blogc(1) and blogc-runserver(1),
+when called by `blogc-make`.
+
+## EXAMPLES
+
+Build all files:
+
+ $ blogc-make all
+
+Clean built files:
+
+ $ blogc-make clean
+
+## BUGS
+
+Please report any issues to: <https://github.com/blogc/blogc>
+
+## AUTHOR
+
+Rafael G. Martins &lt;<rafael@rafaelmartins.eng.br>&gt;
+
+## SEE ALSO
+
+blogc(1), blogc-runserver(1)
diff --git a/man/index.txt b/man/index.txt
index 4ca6e67..b588121 100644
--- a/man/index.txt
+++ b/man/index.txt
@@ -1,6 +1,7 @@
# manuals
blogc(1) blogc.1.ronn
blogc-git-receiver(1) blogc-git-receiver.1.ronn
+blogc-make(1) blogc-make.1.ronn
blogc-runserver(1) blogc-runserver.1.ronn
blogc-source(7) blogc-source.7.ronn
blogc-template(7) blogc-template.7.ronn