commit 7de3dcd8748cb8495689313b2e71f03163e5f3f2
from: Omar Polo <op@omarpolo.com>
date: Sun Aug 13 21:54:22 2023 UTC

improve the manpage

commit - df45d6962d38786fd6de4dd9667608348e3000b2
commit + 7de3dcd8748cb8495689313b2e71f03163e5f3f2
blob - 7d1d5cd70b6140eaa365089f3648c5de8b1bda78
blob + 409b8f1300c123ad0a8eb2fc8b735ef3c2e048e0
--- README.md
+++ README.md
@@ -1,12 +1,27 @@
-# pkg_fcgi - FastCGI interface for the OpenBSD package archive
+# pkg_fcgi - FastCGI interface for the OpenBSD ports tree
 
 pkg_fcgi is meant to be the replacement of gempkg, a Python CGI script
 that allows to browse the OpenBSD package archive via Gemini.
 
+There's a hosted version updated daily available at
+<gemini://gemini.omarpolo.com/cgi/gempkg/>.
+
 pkg_fcgi depends on libevent and sqlite3.  To build, please run
 
 	$ ./configure
 	$ make
 	$ doas make install
 
-As pkg_fcgi is WIP, the documentation is too.
+To operate, pkg_fcgi needs an augmented version of the sqlite database
+installed by the sqlports package.  To generate it, issue;
+
+	# install -d -o www /var/www/pkg_fcgi/
+	# cp /usr/local/share/sqlports /var/www/pkg_fcgi/pkgs.sqlite3
+	# sqlite3 /var/www/pkg_fcgi/pkgs.sqlite3 <schema.sql
+
+A sample configuration for gmid is:
+
+	server "localhost" {
+		listen on *
+		fastcgi socket "/run/pkg_fcgi.sock"
+	}