commit 87db323e65c704c9186f9876bcec01012a891dd2
from: Tracey Emery <tracey@traceyemery.net>
date: Wed Jan 15 22:10:31 2020 UTC

gotweb.conf man

commit - b7ef5d91f727aa9b5bc2cdde423b0749d08183fb
commit + 87db323e65c704c9186f9876bcec01012a891dd2
blob - 442c15677a98e7798497295ffc5d4c25cf3fa992
blob + dc7cb15803cd952fb4cbdd56ba70b4d96445b7fc
--- gotweb/gotweb.conf.5
+++ gotweb/gotweb.conf.5
@@ -25,41 +25,45 @@ is the configuration file for gotweb.
 .Sh GLOBAL CONFIGURATION
 Here are the settings that can be set globally:
 .Bl -tag -width Ds
-.It Ic got_repos_path Ar string
-Set the default git repository path.
-This is a required setting.
-.It Ic got_www_path Ar string
-Set the public gotweb httpd path.
-This is a required setting.
-.It Ic got_max_repos Ar string
-Set the maximum amount of repositories gotweb will work with.
-.It Ic got_max_repos_display Ar string
-Set the maximum amount of repositories displayed on the index screen.
-.It Ic got_commits_display Ar string
+.It Ic got_commits_display Ar number
 Set the maximum amount of log lines displayed.
-.It Ic got_site_name Ar string
-Set the displayed site name title.
-.It Ic got_site_owner Ar string
-Set the displayed site owner.
-.It Ic got_site_link Ar string
-Set the displayed site link name for the index page.
 .It Ic got_logo Ar string
 Set the displayed logo.
 .It Ic got_logo_url Ar string
 Set the href link for the logo.
-.It Ic got_show_site_owner Ar string
-Set whether to display the site owner, or not.
-.It Ic got_repo_owner Ar string
-Set whether to display the repository owner, or not.
-This requires the owner to be added to config in the repository.
+.It Ic got_max_repos Ar number
+Set the maximum amount of repositories gotweb will work with.
+.It Ic got_max_repos_display Ar number
+Set the maximum amount of repositories displayed on the index screen.
 .It Ic got_repo_age Ar string
 Set whether to display the repository age, or not.
-.It Ic got_repo_description Ar string
-Set whether to display the repository description, or not.
-This requires the description file to be edited in the repository.
 .It Ic got_repo_cloneurl Ar string
 Set whether to display clone URLs for a repository.
 This requires the creation of a cloneurl file in the repository.
+.It Ic got_repo_description Ar string
+Set whether to display the repository description, or not.
+This requires the description file to be edited in the repository.
+.It Ic got_repos_path Ar string
+Set the default git repository path.
+.It Ic got_repo_owner Ar string
+Set whether to display the repository owner, or not.
+This requires the owner to be added to the config file in the repository.
+The gotweb code will parse either [gotweb] or [gitweb] owner information.
+For example:
+.Bd -literal -offset indent
+[gotweb]
+owner = "Your Name"
+.Ed
+.It Ic got_site_link Ar string
+Set the displayed site link name for the index page.
+.It Ic got_site_name Ar string
+Set the displayed site name title.
+.It Ic got_site_owner Ar string
+Set the displayed site owner.
+.It Ic got_show_site_owner Ar string
+Set whether to display the site owner, or not.
+.It Ic got_www_path Ar string
+Set the public gotweb httpd path.
 .El
 .Sh FILES
 .Bl -tag -width Ds -compact