Various cleanups and improvements, INSTALL-DEV instructions

2 files changed, 79 insertions, 34 deletions

diff --git a/etc/brep-apache2.conf b/etc/brep-apache2.conf
new file mode 100644
index 0000000..6f806e8
--- /dev/null
+++ b/etc/brep-apache2.conf
@@ -0,0 +1,49 @@
+# The brep.conf file can be included once into Apache configuration file in
+# the <VirtualHost> section or in the main server context.
+#
+LoadModule brep_module modules/mod_brep.so
+LoadModule alias_module modules/mod_alias.so
+
+# Alternatively, if loading the modules in another place, make sure they
+# are loaded.
+#
+<IfModule !brep_module>
+  Error "mod_brep is not loaded"
+</IfModule>
+
+<IfModule !alias_module>
+  Error "mod_alias is not loaded"
+</IfModule>  
+
+# To use a repository root other than /pkg/, replace all occurrences of
+# /pkg/ with the desired alternative root (use '/' for webserver root).
+#
+brep-root            /pkg/
+brep-db-host         localhost
+brep-db-port         5432
+brep-search-results  10
+brep-pager-pages     5
+brep-description-len 500
+brep-changes-len     5000
+brep-log-verbosity   0
+
+# To override brep module options place them into the separate configuration
+# file, suppressing the "brep-" prefix.
+#
+#brep-conf /path/to/brep-site.conf
+
+SetHandler brep
+
+# Location of the brep static content (CSS files).
+#
+Alias /pkg/@/ /usr/share/brep/static/
+
+<Directory "/usr/share/brep/static">
+  Require all granted
+</Directory>
+
+# Serve repository files from the repository root path. For example:
+#
+#   http://example.org/pkg/1/...  -> /path/to/repo/1/...
+#
+#AliasMatch ^/pkg/(\d+)/(.+) /path/to/repo/$1/$2
diff --git a/etc/brep.conf b/etc/brep.conf
index 6f806e8..05981be 100644
--- a/etc/brep.conf
+++ b/etc/brep.conf
@@ -1,49 +1,45 @@
-# The brep.conf file can be included once into Apache configuration file in
-# the <VirtualHost> section or in the main server context.
+# Configuration file for the brep module (note: this is not an apache2 .conf
+# file). See brep(1) for detailed description of each configuration option.
+# Commented out options indicate their default values.
 #
-LoadModule brep_module modules/mod_brep.so
-LoadModule alias_module modules/mod_alias.so
 
-# Alternatively, if loading the modules in another place, make sure they
-# are loaded.
+# Repository root. Use '/' (default) for web server root.
 #
-<IfModule !brep_module>
-  Error "mod_brep is not loaded"
-</IfModule>
+root /pkg/
 
-<IfModule !alias_module>
-  Error "mod_alias is not loaded"
-</IfModule>  
 
-# To use a repository root other than /pkg/, replace all occurrences of
-# /pkg/ with the desired alternative root (use '/' for webserver root).
+# Number of results per page.
 #
-brep-root            /pkg/
-brep-db-host         localhost
-brep-db-port         5432
-brep-search-results  10
-brep-pager-pages     5
-brep-description-len 500
-brep-changes-len     5000
-brep-log-verbosity   0
+# search-results 10
 
-# To override brep module options place them into the separate configuration
-# file, suppressing the "brep-" prefix.
+
+# Number of pages in navigation (pager).
+#
+# search-pages   5
+
+
+# Number of package description characters to display in brief pages.
 #
-#brep-conf /path/to/brep-site.conf
+# package-description 500
 
-SetHandler brep
 
-# Location of the brep static content (CSS files).
+# Number of package changes characters to display in brief pages.
 #
-Alias /pkg/@/ /usr/share/brep/static/
+# package-changes     5000
 
-<Directory "/usr/share/brep/static">
-  Require all granted
-</Directory>
 
-# Serve repository files from the repository root path. For example:
+# Database connection configuration. By default, brep will try to connect to
+# the local instance of PostgreSQL with the operating system-default mechanism
+# (Unix-domain socket, etc) and use operating system (login) user name and the
+# database called 'brep'. See brep(1) for details.
 #
-#   http://example.org/pkg/1/...  -> /path/to/repo/1/...
+# db-user
+# db-password
+# db-name      brep
+# db-host
+# db-port
+
+
+# Trace verbosity. Disabled by default.
 #
-#AliasMatch ^/pkg/(\d+)/(.+) /path/to/repo/$1/$2
+# verbosity 1