commit: b8fc56187ee8c2b726ccf0bc19305a2128f9c3fe
parent 2e4ed81390ff8ed331d10d3fba13dfdc2f6b6b20
Author: Hiltjo Posthuma <hiltjo@codemadness.org>
Date: Sun, 20 Dec 2015 21:34:40 +0100
update README and improve man pages
Diffstat:
3 files changed, 53 insertions(+), 6 deletions(-)
diff --git a/README b/README
@@ -4,7 +4,7 @@ Usage
mkdir -p htmldir
cd htmldir
-urmoms <path-to-repo>
+urmoms path-to-repo
Install
@@ -27,3 +27,4 @@ Features
- Show file tree.
- Detect README and LICENSE file to make a webpage.
- Atom feed git log.
+- Make index page for multiple repositories.
diff --git a/urmoms-index.1 b/urmoms-index.1
@@ -1,14 +1,27 @@
-.Dd December 15, 2015
+.Dd December 20, 2015
.Dt URMOMS-INDEX 1
.Os
.Sh NAME
.Nm urmoms-index
-.Nd static git page generator (repo list)
+.Nd static git index page generator
.Sh SYNOPSIS
.Nm
.Op Ar repodir...
.Sh DESCRIPTION
.Nm
-is undocumented
+will create an index HTML page for the repositories specified and writes
+the HTML data to stdout.
+.Pp
+For changing the style of the page you can use the following files:
+.Bl -tag -width Ds
+.It logo.png
+32x32 logo.
+.It favicon.png
+favicon image.
+.It style.css
+CSS stylesheet.
+.El
+.Sh SEE ALSO
+.Xr urmoms 1
.Sh AUTHORS
.An Hiltjo Posthuma Aq Mt hiltjo@codemadness.org
diff --git a/urmoms.1 b/urmoms.1
@@ -1,4 +1,4 @@
-.Dd December 15, 2015
+.Dd December 20, 2015
.Dt URMOMS 1
.Os
.Sh NAME
@@ -9,6 +9,39 @@
.Op Ar repodir
.Sh DESCRIPTION
.Nm
-is undocumented
+writes HTML pages for the repository
+.Ar repodir
+to the current directory. The following files will be written:
+.Bl -tag -width Ds
+.It atom.xml
+Atom XML feed
+.It files.html
+List of files in the latest HEAD commit, linking to the file.
+.It log.html
+List of commits in order of most recent to old of the commits (top to bottom),
+each commit links to a page with a diff and diffstat of the commit.
+.El
+.Pp
+For each file in HEAD a file will be written in the format:
+file/filepath.html. This file will contain the textual data of the file
+prefixed by line numbers. The file will have the string "binary file"
+if the data is considered to be non-textual.
+.Pp
+For each commit a file will be written in the format:
+commit/commitid.html . This file will contain the diff and diffstat of the
+commit. It will write the string "binary files differ" if the data is
+considered to be non-textual.
+.Pp
+For changing the style of the page you can use the following files:
+.Bl -tag -width Ds
+.It logo.png
+32x32 logo.
+.It favicon.png
+favicon image.
+.It style.css
+CSS stylesheet.
+.El
+.Sh SEE ALSO
+.Xr urmoms-index 1
.Sh AUTHORS
.An Hiltjo Posthuma Aq Mt hiltjo@codemadness.org
