-.TH bollux.conf 5 0.4.0\r
-.SH NAME\r
-.B bollux.conf\r
-\- configuration file for\r
-.BR bollux (1)\r
-.SH DESCRIPTION\r
-.BR bollux (1)\r
-uses a number of environment variables that can be sourced from an external file,\r
-usually placed in\r
-.IR $XDG_CONFIG_HOME/bollux/bollux.conf .\r
-The location can be changed at runtime by invoking\r
-.BR "bollux \-c CONFIG" .\r
-.SH VARIABLES\r
-.SS Variables you might actually want to set\r
-Here are actually useful variables that are good things to set in your\r
-.IR bollux.conf ,\r
-in order of usefulness.\r
-.TP\r
-.BR BOLLUX_URL\r
-valid values are URLs; default is ''.\r
-.br\r
-If\r
-.B BOLLUX_URL\r
-is set,\r
-.BR bollux (1)\r
-loads that resource;\r
-otherwise it asks the user for where to go.\r
-Setting this variable works like setting a home page.\r
-.TP\r
-.BR BOLLUX_DOWNDIR\r
-valid values are directories; default is '.'.\r
-.br\r
-The directory to attempt to save downloads in.\r
-.BR bollux (1)\r
-will attempt to download anything whose mimetype isn't\r
-.IR text/* ,\r
-and it tries to place it in\r
-.BR BOLLUX_DOWNDIR .\r
-If it can't open the directory, save the file,\r
-or if there's another file with the same name,\r
-.BR bollux (1)\r
-will report the name of the temporary file it saved.\r
-.TP\r
-.BR BOLLUX_DATADIR\r
-valid values are directories; default is '$XDG_DATA_DIR/bollux'.\r
-.br\r
-The directory\r
-.BR bollux (1)\r
-will put its data files, such as history, cert fingerprints, etc.\r
-.TP\r
-.BR BOLLUX_MAXREDIR\r
-valid values are integers; default is '5'.\r
-.br\r
-The maximum number of redirects before\r
-.BR bollux (1)\r
-decides to quit.\r
-The default is 5 as per some RFC spec.\r
-.TP\r
-.BR BOLLUX_LOGLEVEL\r
-valid values are '', DEBUG or QUIET; default is ''.\r
-.br\r
-How verbose\r
-.BR bollux (1)\r
-should be.\r
-.I DEBUG\r
-prints debug-level messages.\r
-.I QUIET\r
-suppresses even error-level messages.\r
-I'm going to be honest,\r
-the difference between the levels is somewhat arbitrary.\r
-So.\r
-.SS Typesetting\r
-.BR bollux (1)\r
-typesets text/gemini content using the\r
-.I typeset_gemini\r
-function.\r
-While it's probably possible to redefine the function in\r
-.BR bollux.conf (5),\r
-the default function is pretty nice (at least in my opinion).\r
-The following variables control how text/gemini content is rendered:\r
-.TP\r
-.BR T_MARGIN\r
-valid values are integers; default is 4.\r
-.br\r
-The left margin for text.\r
-Should be at least 3, since line-markers will be displayed in the left margin.\r
-.TP\r
-.BR T_WIDTH\r
-valid values are integers; default is 0.\r
-.br\r
-The total width of the window, including\r
-.BR T_MARGIN .\r
-If set to 0, attempts to use the width of the terminal,\r
-falling back to 80.\r
-.SS Colors\r
-The different line-types in text/gemini documents are rendered with\r
-.I m-class\r
-terminal escapes (e.g., '\\e[31m').\r
-The following variables should hold the values between\r
-.I \\e[\r
-and\r
-.IR m ,\r
-meaning valid values are anything between those that are valid terminal\r
-color escapes.\r
-.TP\r
-.BR C_SIGIL\r
-default: 35 (fg: magenta)\r
-.br\r
-The color of the line type as defined by text/gemini.\r
-.TP\r
-.BR C_LINK_NUMBER\r
-default: 1 (bold)\r
-.br\r
-The color of the link number added by typeset_gemini.\r
-.TP\r
-.BR C_LINK_TITLE\r
-default: 4 (underline)\r
-.br\r
-The color of the link's title, or if titleless, the URL.\r
-.TP\r
-.BR C_LINK_URL\r
-default: 36 (fg: cyan)\r
-.br\r
-The color of the link's URL.\r
-If the link doesn't have a title, this isn't used.\r
-.TP\r
-.BI C_HEADER "x where x is 1, 2, or 3"\r
-The color of text/gemini headers.\r
-The default for level 1 is\r
-.IR 1;4 ,\r
-for level 2 is\r
-.IR 1 ,\r
-for level 3 is\r
-.IR 3 .\r
-.TP\r
-.BR C_LIST\r
-default: 0 (no formatting)\r
-.br\r
-The color of list items.\r
-.TP\r
-.BR C_PRE\r
-default: 0 (no formatting)\r
-.br\r
-The color of preformatted lines, as delimited by '```'.\r
-.SS Variables that could be configured, but probably shouldn't be\r
-These variables control deeper aspects of\r
-.BR bollux (1)'s\r
-workings.\r
-It's possible they could be tweaked to make\r
-.BR bollux (1)\r
-work differently, like browsing gopher instead of gemini,\r
-but that capability has not been tested.\r
-.TP\r
-.BR BOLLUX_PORT\r
-valid values are port numbers (1-65535); default is '1965'.\r
-.br\r
-The port\r
-.BR bollux (1)\r
-tries to connect to on the server.\r
-.TP\r
-.BR BOLLUX_PROTO\r
-valid values are protocol names (strings); default is 'gemini'.\r
-.br\r
-The protocol to use.\r
-.TP\r
-.BR BOLLUX_TIMEOUT\r
-valid values are as specified in 'help read'; default is '30'.\r
-.br\r
-The request timeout duration.\r
-Specified in seconds.\r
-.TP\r
-.BR BOLLUX_LESSKEY\r
-valid values are files; default is '$BOLLUX_DATADIR/lesskey'.\r
-.br\r
-Where to store the generated\r
-.BR lesskey (1)\r
-file.\r
-.TP\r
-.BR BOLLUX_PAGESRC\r
-valid values are files; default is '$BOLLUX_DATADIR/pagesrc'.\r
-.br\r
-Where to store the page source of the site being visited.\r
-It's not used right now by\r
-.BR bollux (1),\r
-but you could ...\r
-.BR cat (1)\r
-it?\r
-.SH FILES\r
-.I $XDG_CONFIG_HOME/bollux/bollux.conf\r
-.SH SEE ALSO\r
-.BR bollux (1)\r
+.TH bollux.conf 5 0.4.0
+.SH NAME
+.B bollux.conf
+\- configuration file for
+.BR bollux (1)
+.SH DESCRIPTION
+.BR bollux (1)
+uses a number of environment variables that can be sourced from an external file,
+usually placed in
+.IR $XDG_CONFIG_HOME/bollux/bollux.conf .
+The location can be changed at runtime by invoking
+.BR "bollux \-c CONFIG" .
+.SH VARIABLES
+.SS Variables you might actually want to set
+Here are actually useful variables that are good things to set in your
+.IR bollux.conf ,
+in order of usefulness.
+.TP
+.BR BOLLUX_URL
+valid values are URLs; default is ''.
+.br
+If
+.B BOLLUX_URL
+is set,
+.BR bollux (1)
+loads that resource;
+otherwise it asks the user for where to go.
+Setting this variable works like setting a home page.
+.TP
+.BR BOLLUX_DOWNDIR
+valid values are directories; default is '.'.
+.br
+The directory to attempt to save downloads in.
+.BR bollux (1)
+will attempt to download anything whose mimetype isn't
+.IR text/* ,
+and it tries to place it in
+.BR BOLLUX_DOWNDIR .
+If it can't open the directory, save the file,
+or if there's another file with the same name,
+.BR bollux (1)
+will report the name of the temporary file it saved.
+.TP
+.BR BOLLUX_DATADIR
+valid values are directories; default is '$XDG_DATA_DIR/bollux'.
+.br
+The directory
+.BR bollux (1)
+will put its data files, such as history, cert fingerprints, etc.
+.TP
+.BR BOLLUX_MAXREDIR
+valid values are integers; default is '5'.
+.br
+The maximum number of redirects before
+.BR bollux (1)
+decides to quit.
+The default is 5 as per some RFC spec.
+.TP
+.BR BOLLUX_LOGLEVEL
+valid values are '', DEBUG or QUIET; default is ''.
+.br
+How verbose
+.BR bollux (1)
+should be.
+.I DEBUG
+prints debug-level messages.
+.I QUIET
+suppresses even error-level messages.
+I'm going to be honest,
+the difference between the levels is somewhat arbitrary.
+So.
+.SS Typesetting
+.BR bollux (1)
+typesets text/gemini content using the
+.I typeset_gemini
+function.
+While it's probably possible to redefine the function in
+.BR bollux.conf (5),
+the default function is pretty nice (at least in my opinion).
+The following variables control how text/gemini content is rendered:
+.TP
+.BR T_MARGIN
+valid values are integers; default is 4.
+.br
+The left margin for text.
+Should be at least 3, since line-markers will be displayed in the left margin.
+.TP
+.BR T_WIDTH
+valid values are integers; default is 0.
+.br
+The total width of the window, including
+.BR T_MARGIN .
+If set to 0, attempts to use the width of the terminal,
+falling back to 80.
+.SS Colors
+The different line-types in text/gemini documents are rendered with
+.I m-class
+terminal escapes (e.g., '\\e[31m').
+The following variables should hold the values between
+.I \\e[
+and
+.IR m ,
+meaning valid values are anything between those that are valid terminal
+color escapes.
+.TP
+.BR C_SIGIL
+default: 35 (fg: magenta)
+.br
+The color of the line type as defined by text/gemini.
+.TP
+.BR C_LINK_NUMBER
+default: 1 (bold)
+.br
+The color of the link number added by typeset_gemini.
+.TP
+.BR C_LINK_TITLE
+default: 4 (underline)
+.br
+The color of the link's title, or if titleless, the URL.
+.TP
+.BR C_LINK_URL
+default: 36 (fg: cyan)
+.br
+The color of the link's URL.
+If the link doesn't have a title, this isn't used.
+.TP
+.BI C_HEADER "x where x is 1, 2, or 3"
+The color of text/gemini headers.
+The default for level 1 is
+.IR 1;4 ,
+for level 2 is
+.IR 1 ,
+for level 3 is
+.IR 3 .
+.TP
+.BR C_LIST
+default: 0 (no formatting)
+.br
+The color of list items.
+.TP
+.BR C_PRE
+default: 0 (no formatting)
+.br
+The color of preformatted lines, as delimited by '```'.
+.SS Variables that could be configured, but probably shouldn't be
+These variables control deeper aspects of
+.BR bollux (1)'s
+workings.
+It's possible they could be tweaked to make
+.BR bollux (1)
+work differently, like browsing gopher instead of gemini,
+but that capability has not been tested.
+.TP
+.BR BOLLUX_PORT
+valid values are port numbers (1-65535); default is '1965'.
+.br
+The port
+.BR bollux (1)
+tries to connect to on the server.
+.TP
+.BR BOLLUX_PROTO
+valid values are protocol names (strings); default is 'gemini'.
+.br
+The protocol to use.
+.TP
+.BR BOLLUX_TIMEOUT
+valid values are as specified in 'help read'; default is '30'.
+.br
+The request timeout duration.
+Specified in seconds.
+.TP
+.BR BOLLUX_LESSKEY
+valid values are files; default is '$BOLLUX_DATADIR/lesskey'.
+.br
+Where to store the generated
+.BR lesskey (1)
+file.
+.TP
+.BR BOLLUX_PAGESRC
+valid values are files; default is '$BOLLUX_DATADIR/pagesrc'.
+.br
+Where to store the page source of the site being visited.
+It's not used right now by
+.BR bollux (1),
+but you could ...
+.BR cat (1)
+it?
+.SH FILES
+.I $XDG_CONFIG_HOME/bollux/bollux.conf
+.SH SEE ALSO
+.BR bollux (1)