From d4003fcfc88df94831cb4a20e890816954f64129 Mon Sep 17 00:00:00 2001 From: "Rafael G. Martins" Date: Fri, 29 Apr 2016 01:17:38 +0200 Subject: man: added man page for blogc-runserver --- Makefile.am | 13 ++++++++++++ blogc.spec.in | 1 + man/blogc-git-receiver.1.ronn | 2 +- man/blogc-runserver.1.ronn | 48 +++++++++++++++++++++++++++++++++++++++++++ man/index.txt | 1 + 5 files changed, 64 insertions(+), 1 deletion(-) create mode 100644 man/blogc-runserver.1.ronn diff --git a/Makefile.am b/Makefile.am index 78b29e0..6b428cb 100644 --- a/Makefile.am +++ b/Makefile.am @@ -180,9 +180,11 @@ endif if BUILD_RUNSERVER EXTRA_DIST += \ + man/blogc-runserver.1.ronn \ $(NULL) dist_man_MANS += \ + blogc-runserver.1 \ $(NULL) endif @@ -208,6 +210,14 @@ blogc-git-receiver.1: man/blogc-git-receiver.1.ronn --manual "$(PACKAGE_NAME) Manual" \ $(top_srcdir)/man/blogc-git-receiver.1.ronn > blogc-git-receiver.1 +blogc-runserver.1: man/blogc-runserver.1.ronn + $(AM_V_GEN)$(RONN) \ + --roff \ + --pipe \ + --organization "Rafael G. Martins" \ + --manual "$(PACKAGE_NAME) Manual" \ + $(top_srcdir)/man/blogc-runserver.1.ronn > blogc-runserver.1 + blogc-source.7: man/blogc-source.7.ronn $(AM_V_GEN)$(RONN) \ --roff \ @@ -232,6 +242,9 @@ blogc.1: blogc-git-receiver.1: $(AM_V_GEN)echo "error: ronn not found. failed to build man page: $@"; exit 1 +blogc-runserver.1: + $(AM_V_GEN)echo "error: ronn not found. failed to build man page: $@"; exit 1 + blogc-source.7: $(AM_V_GEN)echo "error: ronn not found. failed to build man page: $@"; exit 1 diff --git a/blogc.spec.in b/blogc.spec.in index 65af54f..292ed17 100644 --- a/blogc.spec.in +++ b/blogc.spec.in @@ -53,6 +53,7 @@ rm -rf $RPM_BUILD_ROOT %license LICENSE %files runserver +%{_mandir}/man*/blogc-runserver.* %{_bindir}/blogc-runserver %license LICENSE diff --git a/man/blogc-git-receiver.1.ronn b/man/blogc-git-receiver.1.ronn index 4eadece..e26ed09 100644 --- a/man/blogc-git-receiver.1.ronn +++ b/man/blogc-git-receiver.1.ronn @@ -1,4 +1,4 @@ -blogc-git-receiver(1) -- A simple login shell/git hook to deploy blogc websites +blogc-git-receiver(1) -- a simple login shell/git hook to deploy blogc websites =============================================================================== ## SYNOPSIS diff --git a/man/blogc-runserver.1.ronn b/man/blogc-runserver.1.ronn new file mode 100644 index 0000000..a306fbe --- /dev/null +++ b/man/blogc-runserver.1.ronn @@ -0,0 +1,48 @@ +blogc-runserver(1) -- a simple HTTP server to test blogc websites +================================================================= + +## SYNOPSIS + +`blogc-runserver` [`-t` ] [`-p` ]
+`blogc-runserver` [`-h`|`-v`] + +## DESCRIPTION + +**blogc-runserver** is a simple HTTP server that makes it easy to test blogc websites. +Users just need to point it to the directory where the target files where built. It +comes with a few pre-defined rules, similar to production webservers, that allow users +to quickly test their websites without configuring a webserver. + +`blogc-runserver` is part of `blogc` project, but isn't tied to blogc(1). It may be +able to serve any website built by static site generators. + +## OPTIONS + + * `-t` : + HTTP server listen address, defaults to `127.0.0.1`. + + * `-p` : + HTTP server listen port, defaults to `8080`. + + * `-v`: + Show program name, version and exit. + + * `-h`: + Show help message and exit. + +## ARGUMENTS + + * : + HTTP server document root. + +## BUGS + +Please report any issues to: + +## AUTHOR + +Rafael G. Martins <> + +## SEE ALSO + +blogc(1) diff --git a/man/index.txt b/man/index.txt index 7f78f2a..40a80d6 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-runserver(1) blogc-runserver.1.ronn blogc-source(7) blogc-source.7.ronn blogc-template(7) blogc-template.7.ronn -- cgit v1.2.3-18-g5258