1 files changed, 149 insertions, 0 deletions
diff --git a/res/lagrange.1 b/res/lagrange.1
new file mode 100644
index 00000000..7b8815c1
--- /dev/null
+++ b/res/lagrange.1
@@ -0,0 +1,149 @@
+.\" Automatically generated by Pandoc 2.9.2.1
+.\"
+.TH "LAGRANGE" "1" "January 2022" "" ""
+.hy
+.SH NAME
+.PP
+lagrange - a beautiful Gemini client
+.SH SYNOPSIS
+.PP
+\f[B]lagrange\f[R]
+[options]\ [\f[I]URL\f[R]]\&...\ [\f[I]FILE\f[R]]\&...
+.SH DESCRIPTION
+.PP
+Lagrange is a graphical client for the Gemini, Gopher, and Finger
+protocols.
+It offers modern conveniences familiar from web browsers, such as smooth
+scrolling, inline image viewing, multiple tabs, visual themes, Unicode
+fonts, and bookmarks.
+.SH OPTIONS
+.PP
+When multiple URLs and/or local files are specified, they are opened in
+separate tabs.
+.TP
+\f[B]-E\f[R], \f[B]--echo\f[R]
+Print all internal application events to stdout.
+Useful for debugging.
+.TP
+\f[B]--help\f[R]
+List the available command line options.
+.TP
+\f[B]-u\f[R], \f[B]--url-or-search\f[R] \f[I]URL\f[R] | \f[I]TEXT\f[R]
+Open a URL, or make a search query with given text.
+This only works if the search query URL has been configured.
+.TP
+\f[B]-V\f[R], \f[B]--version\f[R]
+Output the version number.
+.SS Window options:
+.TP
+\f[B]-h\f[R], \f[B]--height\f[R] \f[I]N\f[R]
+Set initial window height to \f[I]N\f[R] pixels.
+.TP
+\f[B]--sw\f[R]
+Disable hardware-accelerated rendering.
+.TP
+\f[B]-w\f[R], \f[B]--width\f[R] \f[I]N\f[R]
+Set initial window width to \f[I]N\f[R] pixels.
+.SS Control options:
+.PP
+These options are used to control the currently running Lagrange
+instance via the command line.
+.TP
+\f[B]--close-tab\f[R]
+Close the current tab.
+.TP
+\f[B]-L\f[R], \f[B]--list-tab-urls\f[R]
+Print the URLs of open tabs to stdout.
+If the app isn\[cq]t running, nothing is printed.
+.TP
+\f[B]--new-tab\f[R] [\f[I]URL\f[R]]
+Open a new tab.
+If the URL argument is omitted, the user\[cq]s homepage is opened.
+.TP
+\f[B]--tab-url\f[R]
+Print the URL of the active tab.
+.SH ENVIRONMENT
+.TP
+\f[B]\f[CB]LAGRANGE_OVERRIDE_DPI\f[B]\f[R]
+Override the autodetected screen DPI with a user-provided value.
+Some window systems and/or monitors may not provide an appropriate DPI
+value, so this enables further tuning the UI scaling in addition to the
+\[lq]UI scale factor\[rq] found in Preferences.
+.SH FILES
+.PP
+User-specific files such as bookmarks and navigation history are stored
+in the following operating system dependent locations:
+.IP \[bu] 2
+Windows:
+\[lq]C:\[rs]Users\[rs]Name\[rs]AppData\[rs]Roaming\[rs]fi.skyjake.Lagrange\[rq]
+.IP \[bu] 2
+macOS: \[lq]\[ti]/Library/Application Support/fi.skyjake.Lagrange\[rq]
+.IP \[bu] 2
+Other: \[lq]\[ti]/.config/lagrange\[rq]
+.PP
+The directory contains:
+.TP
+\f[B]bindings.txt\f[R]
+Customized key bindings.
+.TP
+\f[B]bookmarks.ini\f[R]
+Bookmarks in TOML format.
+.TP
+\f[B]feeds.txt\f[R]
+State of subscribed feeds: all the known entries and latest update
+timestamps.
+.TP
+\f[B]fonts.ini\f[R]
+Custom fonts to load at launch.
+.TP
+\f[B]idents.lgr\f[R]
+Information about identities.
+.TP
+\f[B]idents/\f[R]
+Subdirectory containing client certificates and private keys in PEM
+format.
+.TP
+\f[B]modmap.txt\f[R]
+Customized keyboard modifier mapping.
+.TP
+\f[B]mimehooks.txt\f[R]
+Configuration of external programs to filter page contents depending on
+MIME type.
+.TP
+\f[B]palette.txt\f[R]
+Colors of the UI palette.
+.TP
+\f[B]prefs.cfg\f[R]
+User\[cq]s preferences.
+This is a list of UI events that gets executed at launch (cf.\ output of
+\f[B]--echo\f[R]).
+.TP
+\f[B]state.lgr\f[R]
+Serialized UI state, specifying open tabs and sidebar state.
+.TP
+\f[B]sitespec.ini\f[R]
+Site-specific preferences in TOML format.
+.TP
+\f[B]trusted.2.txt\f[R]
+Fingerprints of trusted server certificates.
+.TP
+\f[B]visited.2.txt\f[R]
+List of visited URLs with timestamps.
+.SH STANDARDS
+.IP \[bu] 2
+Gemini Protocol
+Specification (https://gemini.circumlunar.space/docs/specification.gmi)
+.IP \[bu] 2
+Gempub Specification (https://codeberg.org/oppenlab/gempub)
+.IP \[bu] 2
+RFC 1436: The Internet Gopher
+Protocol (https://datatracker.ietf.org/doc/html/rfc1436)
+.IP \[bu] 2
+RFC 1288: The Finger User Information
+Protocol (https://datatracker.ietf.org/doc/html/rfc1288)
+.SH SEE ALSO
+.PP
+Open \[lq]about:help\[rq] in the application to view the complete Help
+page.
+.SH AUTHORS
+Jaakko Ker\[:a]nen (jaakko.keranen\[at]iki.fi).

diff --git a/res/lagrange.1 b/res/lagrange.1 new file mode 100644 index 00000000..7b8815c1 --- /dev/null +++ b/res/lagrange.1
@@ -0,0 +1,149 @@
	1	.\" Automatically generated by Pandoc 2.9.2.1
	2	.\"
	3	.TH "LAGRANGE" "1" "January 2022" "" ""
	4	.hy
	5	.SH NAME
	6	.PP
	7	lagrange - a beautiful Gemini client
	8	.SH SYNOPSIS
	9	.PP
	10	\f[B]lagrange\f[R]
	11	[options]\ [\f[I]URL\f[R]]\&...\ [\f[I]FILE\f[R]]\&...
	12	.SH DESCRIPTION
	13	.PP
	14	Lagrange is a graphical client for the Gemini, Gopher, and Finger
	15	protocols.
	16	It offers modern conveniences familiar from web browsers, such as smooth
	17	scrolling, inline image viewing, multiple tabs, visual themes, Unicode
	18	fonts, and bookmarks.
	19	.SH OPTIONS
	20	.PP
	21	When multiple URLs and/or local files are specified, they are opened in
	22	separate tabs.
	23	.TP
	24	\f[B]-E\f[R], \f[B]--echo\f[R]
	25	Print all internal application events to stdout.
	26	Useful for debugging.
	27	.TP
	28	\f[B]--help\f[R]
	29	List the available command line options.
	30	.TP
	31	\f[B]-u\f[R], \f[B]--url-or-search\f[R] \f[I]URL\f[R] \| \f[I]TEXT\f[R]
	32	Open a URL, or make a search query with given text.
	33	This only works if the search query URL has been configured.
	34	.TP
	35	\f[B]-V\f[R], \f[B]--version\f[R]
	36	Output the version number.
	37	.SS Window options:
	38	.TP
	39	\f[B]-h\f[R], \f[B]--height\f[R] \f[I]N\f[R]
	40	Set initial window height to \f[I]N\f[R] pixels.
	41	.TP
	42	\f[B]--sw\f[R]
	43	Disable hardware-accelerated rendering.
	44	.TP
	45	\f[B]-w\f[R], \f[B]--width\f[R] \f[I]N\f[R]
	46	Set initial window width to \f[I]N\f[R] pixels.
	47	.SS Control options:
	48	.PP
	49	These options are used to control the currently running Lagrange
	50	instance via the command line.
	51	.TP
	52	\f[B]--close-tab\f[R]
	53	Close the current tab.
	54	.TP
	55	\f[B]-L\f[R], \f[B]--list-tab-urls\f[R]
	56	Print the URLs of open tabs to stdout.
	57	If the app isn\[cq]t running, nothing is printed.
	58	.TP
	59	\f[B]--new-tab\f[R] [\f[I]URL\f[R]]
	60	Open a new tab.
	61	If the URL argument is omitted, the user\[cq]s homepage is opened.
	62	.TP
	63	\f[B]--tab-url\f[R]
	64	Print the URL of the active tab.
	65	.SH ENVIRONMENT
	66	.TP
	67	\f[B]\f[CB]LAGRANGE_OVERRIDE_DPI\f[B]\f[R]
	68	Override the autodetected screen DPI with a user-provided value.
	69	Some window systems and/or monitors may not provide an appropriate DPI
	70	value, so this enables further tuning the UI scaling in addition to the
	71	\[lq]UI scale factor\[rq] found in Preferences.
	72	.SH FILES
	73	.PP
	74	User-specific files such as bookmarks and navigation history are stored
	75	in the following operating system dependent locations:
	76	.IP \[bu] 2
	77	Windows:
	78	\[lq]C:\[rs]Users\[rs]Name\[rs]AppData\[rs]Roaming\[rs]fi.skyjake.Lagrange\[rq]
	79	.IP \[bu] 2
	80	macOS: \[lq]\[ti]/Library/Application Support/fi.skyjake.Lagrange\[rq]
	81	.IP \[bu] 2
	82	Other: \[lq]\[ti]/.config/lagrange\[rq]
	83	.PP
	84	The directory contains:
	85	.TP
	86	\f[B]bindings.txt\f[R]
	87	Customized key bindings.
	88	.TP
	89	\f[B]bookmarks.ini\f[R]
	90	Bookmarks in TOML format.
	91	.TP
	92	\f[B]feeds.txt\f[R]
	93	State of subscribed feeds: all the known entries and latest update
	94	timestamps.
	95	.TP
	96	\f[B]fonts.ini\f[R]
	97	Custom fonts to load at launch.
	98	.TP
	99	\f[B]idents.lgr\f[R]
	100	Information about identities.
	101	.TP
	102	\f[B]idents/\f[R]
	103	Subdirectory containing client certificates and private keys in PEM
	104	format.
	105	.TP
	106	\f[B]modmap.txt\f[R]
	107	Customized keyboard modifier mapping.
	108	.TP
	109	\f[B]mimehooks.txt\f[R]
	110	Configuration of external programs to filter page contents depending on
	111	MIME type.
	112	.TP
	113	\f[B]palette.txt\f[R]
	114	Colors of the UI palette.
	115	.TP
	116	\f[B]prefs.cfg\f[R]
	117	User\[cq]s preferences.
	118	This is a list of UI events that gets executed at launch (cf.\ output of
	119	\f[B]--echo\f[R]).
	120	.TP
	121	\f[B]state.lgr\f[R]
	122	Serialized UI state, specifying open tabs and sidebar state.
	123	.TP
	124	\f[B]sitespec.ini\f[R]
	125	Site-specific preferences in TOML format.
	126	.TP
	127	\f[B]trusted.2.txt\f[R]
	128	Fingerprints of trusted server certificates.
	129	.TP
	130	\f[B]visited.2.txt\f[R]
	131	List of visited URLs with timestamps.
	132	.SH STANDARDS
	133	.IP \[bu] 2
	134	Gemini Protocol
	135	Specification (https://gemini.circumlunar.space/docs/specification.gmi)
	136	.IP \[bu] 2
	137	Gempub Specification (https://codeberg.org/oppenlab/gempub)
	138	.IP \[bu] 2
	139	RFC 1436: The Internet Gopher
	140	Protocol (https://datatracker.ietf.org/doc/html/rfc1436)
	141	.IP \[bu] 2
	142	RFC 1288: The Finger User Information
	143	Protocol (https://datatracker.ietf.org/doc/html/rfc1288)
	144	.SH SEE ALSO
	145	.PP
	146	Open \[lq]about:help\[rq] in the application to view the complete Help
	147	page.
	148	.SH AUTHORS
	149	Jaakko Ker\[:a]nen (jaakko.keranen\[at]iki.fi).