A fully featured Gemini client library written in C using libtls.
Go to file
styan 2a67a406ca Fix mimedef parsing & add the `-l' option 2020-06-20 22:44:05 +00:00
LICENSE Add a LICENSE file 2020-04-29 10:31:23 +00:00
Makefile Fix a typo 2020-06-20 11:44:34 +00:00
README Add the ENVIRONMENT VARIABLES section 2020-06-20 12:02:59 +00:00
gemini-cat.1 Add `gemini_envinit', add proxy support, simplfy header handling 2020-06-20 04:56:34 +00:00
gemini-cat.c Add `gemini_envinit', add proxy support, simplfy header handling 2020-06-20 04:56:34 +00:00
gemini-pipe.1 Fix mimedef parsing & add the `-l' option 2020-06-20 22:44:05 +00:00
gemini-pipe.c Fix mimedef parsing & add the `-l' option 2020-06-20 22:44:05 +00:00
libgeminiclient.3 Add `gemini_envinit', add proxy support, simplfy header handling 2020-06-20 04:56:34 +00:00
libgeminiclient.c Deduplicate error printing 2020-06-20 22:07:15 +00:00
libgeminiclient.h Add `gemini_envinit', add proxy support, simplfy header handling 2020-06-20 04:56:34 +00:00

README

PREREQUISITES

	LibreSSL's `libtls'[1], and pkg-config(1) or pkgconf(1)
	for automatic configuration.
	`libbsd' for readpassphrase(3) in gemini-cat(1).

BUILDING

	To build libgeminiclient(3) configured automagically:
		make
	or
		make magic-libgeminiclient

	To build everything configured automagically:
		make all
	or
		make magic

	To build libgeminiclient(3) configured manually:
		export CFLAGS=-I/path/to/libtls/includes
		make libgeminiclient.a

	To build gemini-cat(1) configured manually:
		export CFLAGS='-I/path/to/libtls -I/path/to/libbsd'
		export LDFLAGS='-L/path/to/libtls -ltls'
		make gemini-cat

	To build gemini-pipe(1) configured manually:
		export CFLAGS='-I/path/to/libtls -I/path/to/libbsd'
		export LDFLAGS='-L/path/to/libtls -ltls'
		make gemini-pipe

INSTALLING

	To install libgeminiclient(3) on the system:
		make install

	To install gemini-cat(1) on the system:
		make install-gemini-cat

	To install gemini-pipe(1) on the system:
		make install-gemini-pipe

	To install everything on the system:
		make install-all

	To install gemini-cat(1) in your home-directory:
		make linstall-gemini-cat

	To install gemini-pipe(1) in your home-directory:
		make linstall-gemini-pipe

MAGIC

	The ``magic'' make(1) targets attempt to use pkg-config(1) for
	libraries and their flags.

ENVIRONMENT VARIABLES

	``DESTDIR''
		The destination directory for `install', normally blank.

	``PREFIX''
		The installation prefix, normally "/usr/local".

	``MANDIR''
		The man-page sub-directory, normally "man".
		On some systems it should be set to "share/man".


PREPROCESSOR DEFINES

	``BUFFER_SIZE''
		The size of the buffer for gemini-cat(1) to use,
		and the default buffer size for gemini-pipe(1).

REFERENCES
	1: https://www.libressl.org/