From b8fc56187ee8c2b726ccf0bc19305a2128f9c3fe Mon Sep 17 00:00:00 2001 From: Hiltjo Posthuma Date: Sun, 20 Dec 2015 21:34:40 +0100 Subject: update README and improve man pages --- urmoms.1 | 37 +++++++++++++++++++++++++++++++++++-- 1 file changed, 35 insertions(+), 2 deletions(-) (limited to 'urmoms.1') diff --git a/urmoms.1 b/urmoms.1 index 9f08667..c2204f6 100644 --- 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 -- cgit v1.2.3