.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "urxvt-font-size 1"
.TH urxvt-font-size 1 2024-02-20 9.31 RXVT-UNICODE
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
font\-size \- interactive font size setter
.SH USAGE
.IX Header "USAGE"
Put the font-size script into \f(CW$HOME\fR/.urxvt/ext/ and add it to the list
of enabled perl-extensions in ~/.Xresources:
.PP
.Vb 1
\&  URxvt.perl\-ext\-common: ...,font\-size
.Ve
.PP
The extension automatically binds Ctrl++ to the 'increase' function,
Ctrl+\- to 'decrease', and Ctrl+0 to 'reset'. To use the other available functions
or change the keys, add some keybindings of your own:
.PP
.Vb 6
\&  URxvt.keysym.C\-Up:     font\-size:increase
\&  URxvt.keysym.C\-Down:   font\-size:decrease
\&  URxvt.keysym.C\-S\-Up:   font\-size:incglobal
\&  URxvt.keysym.C\-S\-Down: font\-size:decglobal
\&  URxvt.keysym.C\-equal:  font\-size:reset
\&  URxvt.keysym.C\-slash:  font\-size:show
.Ve
.PP
Note that for urxvt versions older than 9.21 the resources have to look like this:
.PP
.Vb 6
\&  URxvt.keysym.C\-Up:     perl:font\-size:increase
\&  URxvt.keysym.C\-Down:   perl:font\-size:decrease
\&  URxvt.keysym.C\-S\-Up:   perl:font\-size:incglobal
\&  URxvt.keysym.C\-S\-Down: perl:font\-size:decglobal
\&  URxvt.keysym.C\-equal:  perl:font\-size:reset
\&  URxvt.keysym.C\-slash:  perl:font\-size:show
.Ve
.PP
Supported functions:
.IP \(bu 2
increase/decrease:
.Sp
.Vb 1
\&      increase or decrease the font size of the current terminal.
.Ve
.IP \(bu 2
incglobal/decglobal:
.Sp
.Vb 2
\&      same as above and also adjust the X server values so all newly
\&      started terminals will use the same fontsize.
.Ve
.IP \(bu 2
incsave/decsave:
.Sp
.Vb 3
\&      same as incglobal/decglobal and also modify the ~/.Xresources
\&      file so the changed font sizes will persist over a restart of
\&      the X server or a reboot.
.Ve
.IP \(bu 2
reset:
.Sp
.Vb 2
\&      reset the font size to the value of the resource when starting
\&      the terminal.
.Ve
.IP \(bu 2
show
.Sp
.Vb 1
\&      show the current value of the \*(Aqfont\*(Aq resource in a popup.
.Ve
.PP
You can also change the step size that the script will use to increase
the font size:
.PP
.Vb 1
\&  URxvt.font\-size.step: 4
.Ve
.PP
The default step size is 1. This means that with this setting a
size change sequence would be for example 8\->12\->16\->20 instead of
8\->9\->10\->11\->12 etc. Please note that many X11 fonts are only
available in specific sizes, though, and odd sizes are often not
available, resulting in an effective step size of 2 instead of 1
in that case.