-.Dd May 1, 2016
+.Dd February 6, 2019
.Dt STAGIT 1
.Os
.Sh NAME
.Sh SYNOPSIS
.Nm
.Op Fl c Ar cachefile
+.Op Fl l Ar commits
.Ar repodir
.Sh DESCRIPTION
.Nm
It is up to the user to make sure the state of the
.Ar cachefile
is in sync with the history of the repository.
+.It Fl l Ar commits
+Write a maximum number of
+.Ar commits
+to the log.html file only.
+However the commit files are written as usual.
.El
.Pp
+The options
+.Fl c
+and
+.Fl l
+cannot be used at the same time.
+.Pp
The following files will be written:
.Bl -tag -width Ds
.It atom.xml
.It files.html
List of files in the latest tree, 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 diffstat and diff of the commit.
+List of commits in reverse chronological applied commit order, each commit
+links to a page with a diffstat and diff of the commit.
.It refs.html
Lists references of the repository such as branches and tags.
.El