diff options
author | Rafael G. Martins <rafael@rafaelmartins.eng.br> | 2017-01-03 03:43:58 +0100 |
---|---|---|
committer | Rafael G. Martins <rafael@rafaelmartins.eng.br> | 2017-01-03 03:43:58 +0100 |
commit | f1497810051ffe86741fa7e0dc7a2b4db94d2c19 (patch) | |
tree | 122bb8f55ce2c610298bde562a0a058f1a20d63e /man | |
parent | a4bddf83cbbac86c3734b8c399e65c7341385a85 (diff) | |
download | blogc-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.ronn | 79 | ||||
-rw-r--r-- | man/index.txt | 1 |
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 <<rafael@rafaelmartins.eng.br>> + +## 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 |