Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
How diverse parts of OpenSSL treat pass phrases character encoding
defines how windows should be treated by AfterStep depending on its name
getdp(1), GetDP(1)
a General environment for the treatment of Discrete Problems
How diverse parts of OpenSSL treat pass phrases character encoding
How diverse parts of OpenSSL treat pass phrases character encoding
sc_SCElementOp2(3), sc::SCElementOp2(3)
The SCElementOp2 class is very similar to the SCElementOp class except that pairs of blocks are treated simultaneously
sc_SCElementOp3(3), sc::SCElementOp3(3)
The SCElementOp3 class is very similar to the SCElementOp class except that a triplet of blocks is treated simultaneously
switch_default_texmode(3), switch_default_texmode (3)
Switch how the associated texture storage should treat coordinates outside the [0..1] range
treat perl arrays as binary heaps/priority queues
Treating a set of files as a single input stream
base class to treat unhandled method calls as no-ops
A return-value object that lets you treat it as as a boolean, array or object
base class to treat unhandled method calls as errors
Treat Google as a datasource for DBI
Row Directory Block tied hash class. A class that lets you treat the contents of a block (byte buffer) as a hash. Note: This implementation is almost, but not quite, a pushhash. The push hash implementation is Genezzo::Row::RSBlock. It also forms the basis of a tied array in Genezzo::Block::RDBArray
treat hashes as objects, with arbitrary accessors/mutators
Treat module source code as a template
treat arrays and hashes as lists
remark list of BBS is treated
remark of BBS is treated
article list of BBS is treated
kitty.conf Documentation kitty is highly customizable, everything from keyboard shortcuts, to rendering frames-per-second. See below for an overview of all customization possibilities. You can open the config file within kitty by pressing %ctrl+shift+f2. You can reload the config file within kitty by pressing %ctrl+shift+f5 or sending kitty the SIGUSR1 signal. You can also display the current configuration by pressing the %ctrl+shift+f6 key. kitty looks for a config file in the OS config directories (usually ~/.config/kitty/kitty.conf) but you can pass a specific path via the kitty --config option or use the KITTY_CONFIG_DIRECTORY environment variable. See the kitty --config option for full details. Comments can be added to the config file as lines starting with the # character. This works only if the # character is the first character in the line. You can include secondary config files via the include directive. If you use a relative path for include, it is resolved with respect to the location of the current config file. Note that environment variables are expanded, so ${USER}.conf becomes name.conf if USER=name. For example: 0.0 3.5 C include other.conf P NOTE: 0.0 3.5 Syntax highlighting for kitty.conf in vim is available via %vim-kitty. kitty has very powerful font management. You can configure individual font faces and even specify special fonts for particular characters. 0.0 font_family, bold_font, italic_font, bold_italic_font 0.0 3.5 C font_family monospace bold_font auto italic_font auto bold_italic_font auto P You can specify different fonts for the bold/italic/bold-italic variants. To get a full list of supported fonts use the kitty list-fonts command. By default they are derived automatically, by the OSes font system. Setting them manually is useful for font families that have many weight variants like Book, Medium, Thick, etc. For example: 0.0 3.5 C font_family Operator Mono Book bold_font Operator Mono Medium italic_font Operator Mono Book Italic bold_italic_font Operator Mono Medium Italic P 0.0 font_size 0.0 3.5 C font_size 11.0 P Font size (in pts) 0.0 force_ltr 0.0 3.5 C force_ltr no P kitty does not support BIDI (bidirectional text), however, for RTL scripts, words are automatically displayed in RTL. That is to say, in an RTL script, the words "HELLO WORLD" display in kitty as "WORLD HELLO", and if you try to select a substring of an RTL-shaped string, you will get the character that would be there had the the string been LTR. For example, assuming the Hebrew word ירושלים, selecting the character that on the screen appears to be ם actually writes into the selection buffer the character י. kitty(aqs default behavior is useful in conjunction with a filter to reverse the word order, however, if you wish to manipulate RTL glyphs, it can be very challenging to work with, so this option is provided to turn it off. Furthermore, this option can be used with the command line program %GNU FriBidi to get BIDI support, because it will force kitty to always treat the text as LTR, which FriBidi expects for terminals. 0.0 adjust_line_height, adjust_column_width 0.0 3.5 C adjust_line_height 0 adjust_column_width 0 P Change the size of each character cell kitty renders. You can use either numbers, which are interpreted as pixels or percentages (number followed by %), which are interpreted as percentages of the unmodified values. You can use negative pixels or percentages less than 100% to reduce sizes (but this might cause rendering artifacts). 0.0 adjust_baseline 0.0 3.5 C adjust_baseline 0 P Adjust the vertical alignment of text (the height in the cell at which text is positioned). You can use either numbers, which are interpreted as pixels or a percentages (number followed by %), which are interpreted as the percentage of the line height. A positive value moves the baseline up, and a negative value moves them down. The underline and strikethrough positions are adjusted accordingly. 0.0 symbol_map 0.0 3.5 C symbol_map U+E0A0-U+E0A3,U+E0C0-U+E0C7 PowerlineSymbols P Map the specified unicode codepoints to a particular font. Useful if you need special rendering for some symbols, such as for Powerline. Avoids the need for patched fonts. Each unicode code point is specified in the form U+<code point in hexadecimal>. You can specify multiple code points, separated by commas and ranges separated by hyphens. symbol_map itself can be specified multiple times. Syntax is: 0.0 3.5 C symbol_map codepoints Font Family Name P 0.0 disable_ligatures 0.0 3.5 C disable_ligatures never P Choose how you want to handle multi-character ligatures. The default is to always render them. You can tell kitty to not render them when the cursor is over them by using cursor to make editing easier, or have kitty never render them at all by using always, if you don(aqt like them. The ligature strategy can be set per-window either using the kitty remote control facility or by defining shortcuts for it in kitty.conf, for example: 0.0 3.5 C map alt+1 disable_ligatures_in active always map alt+2 disable_ligatures_in all never map alt+3 disable_ligatures_in tab cursor P Note that this refers to programming ligatures, typically implemented using the calt OpenType feature. For disabling general ligatures, use the %font_features setting. 0.0 font_features 0.0 3.5 C font_features none P Choose exactly which OpenType features to enable or disable. This is useful as some fonts might have features worthwhile in a terminal. For example, Fira Code Retina includes a discretionary feature, zero, which in that font changes the appearance of the zero (0), to make it more easily distinguishable from Ø. Fira Code Retina also includes other discretionary features known as Stylistic Sets which have the tags ss01 through ss20. For the exact syntax to use for individual features, see the %Harfbuzz documentation. Note that this code is indexed by PostScript name, and not the font family. This allows you to define very precise feature settings; e.g. you can disable a feature in the italic font but not in the regular font. On Linux, these are read from the FontConfig database first and then this, setting is applied, so they can be configured in a single, central place. To get the PostScript name for a font, use kitty + list-fonts --psnames: 0.0 3.5 C $ kitty + list-fonts --psnames | grep Fira Fira Code Fira Code Bold (FiraCode-Bold) Fira Code Light (FiraCode-Light) Fira Code Medium (FiraCode-Medium) Fira Code Regular (FiraCode-Regular) Fira Code Retina (FiraCode-Retina) P The part in brackets is the PostScript name. Enable alternate zero and oldstyle numerals: 0.0 3.5 C font_features FiraCode-Retina +zero +onum P Enable only alternate zero: 0.0 3.5 C font_features FiraCode-Retina +zero P Disable the normal ligatures, but keep the calt feature which (in this font) breaks up monotony: 0.0 3.5 C font_features TT2020StyleB-Regular -liga +calt P In conjunction with %force_ltr, you may want to disable Arabic shaping entirely, and only look at their isolated forms if they show up in a document. You can do this with e.g.: 0.0 3.5 C font_features UnifontMedium +isol -medi -fina -init P 0.0 box_drawing_scale 0.0 3.5 C box_drawing_scale 0.001, 1, 1.5, 2 P Change the sizes of the lines used for the box drawing unicode characters These values are in pts. They will be scaled by the monitor DPI to arrive at a pixel value. There must be four values corresponding to thin, normal, thick, and very thick lines. 0.0 cursor 0.0 3.5 C cursor #cccccc P Default cursor color 0.0 cursor_text_color 0.0 3.5 C cursor_text_color #111111 P Choose the color of text under the cursor. If you want it rendered with the background color of the cell underneath instead, use the special keyword: background 0.0 cursor_shape 0.0 3.5 C cursor_shape block P The cursor shape can be one of (block, beam, underline). Note that when reloading the config this will be changed only if the cursor shape has not been set by the program running in the terminal. 0.0 cursor_beam_thickness 0.0 3.5 C cursor_beam_thickness 1.5 P Defines the thickness of the beam cursor (in pts) 0.0 cursor_underline_thickness 0.0 3.5 C cursor_underline_thickness 2.0 P Defines the thickness of the underline cursor (in pts) 0.0 cursor_blink_interval 0.0 3.5 C cursor_blink_interval -1 P The interval (in seconds) at which to blink the cursor. Set to zero to disable blinking. Negative values mean use system default. Note that numbers smaller than %repaint_delay will be limited to %repaint_delay. 0.0 cursor_stop_blinking_after 0.0 3.5 C cursor_stop_blinking_after 15.0 P Stop blinking cursor after the specified number of seconds of keyboard inactivity. Set to zero to never stop blinking. 0.0 scrollback_lines 0.0 3.5 C scrollback_lines 2000 P Number of lines of history to keep in memory for scrolling back. Memory is allocated on demand. Negative numbers are (effectively) infinite scrollback. Note that using very large scrollback is not recommended as it can slow down performance of the terminal and also use large amounts of RAM. Instead, consider using %scrollback_pager_history_size. Note that on config reload if this is changed it will only affect newly created windows, not existing ones. 0.0 scrollback_pager 0.0 3.5 C scrollback_pager less --chop-long-lines --RAW-CONTROL-CHARS +INPUT_LINE_NUMBER P Program with which to view scrollback in a new window. The scrollback buffer is passed as STDIN to this program. If you change it, make sure the program you use can handle ANSI escape sequences for colors and text formatting. INPUT_LINE_NUMBER in the command line above will be replaced by an integer representing which line should be at the top of the screen. Similarly CURSOR_LINE and CURSOR_COLUMN will be replaced by the current cursor position. 0.0 scrollback_pager_history_size 0.0 3.5 C scrollback_pager_history_size 0 P Separate scrollback history size, used only for browsing the scrollback buffer (in MB). This separate buffer is not available for interactive scrolling but will be piped to the pager program when viewing scrollback buffer in a separate window. The current implementation stores the data in UTF-8, so approximatively 10000 lines per megabyte at 100 chars per line, for pure ASCII text, unformatted text. A value of zero or less disables this feature. The maximum allowed size is 4GB. Note that on config reload if this is changed it will only affect newly created windows, not existing ones. 0.0 scrollback_fill_enlarged_window 0.0 3.5 C scrollback_fill_enlarged_window no P Fill new space with lines from the scrollback buffer after enlarging a window. 0.0 wheel_scroll_multiplier 0.0 3.5 C wheel_scroll_multiplier 5.0 P Modify the amount scrolled by the mouse wheel. Note this is only used for low precision scrolling devices, not for high precision scrolling on platforms such as macOS and Wayland. Use negative numbers to change scroll direction. 0.0 touch_scroll_multiplier 0.0 3.5 C touch_scroll_multiplier 1.0 P Modify the amount scrolled by a touchpad. Note this is only used for high precision scrolling devices on platforms such as macOS and Wayland. Use negative numbers to change scroll direction. 0.0 mouse_hide_wait 0.0 3.5 C mouse_hide_wait 3.0 P Hide mouse cursor after the specified number of seconds of the mouse not being used. Set to zero to disable mouse cursor hiding. Set to a negative value to hide the mouse cursor immediately when typing text. Disabled by default on macOS as getting it to work robustly with the ever-changing sea of bugs that is Cocoa is too much effort. 0.0 url_color, url_style 0.0 3.5 C url_color #0087bd url_style curly P The color and style for highlighting URLs on mouse-over. url_style can be one of: none, single, double, curly 0.0 open_url_with 0.0 3.5 C open_url_with default P The program with which to open URLs that are clicked on. The special value default means to use the operating system(aqs default URL handler. 0.0 url_prefixes 0.0 3.5 C url_prefixes http https file ftp gemini irc gopher mailto news git P The set of URL prefixes to look for when detecting a URL under the mouse cursor. 0.0 detect_urls 0.0 3.5 C detect_urls yes P Detect URLs under the mouse. Detected URLs are highlighted with an underline and the mouse cursor becomes a hand over them. Even if this option is disabled, URLs are still clickable. 0.0 url_excluded_characters 0.0 3.5 C url_excluded_characters P Additional characters to be disallowed from URLs, when detecting URLs under the mouse cursor. By default, all characters legal in URLs are allowed. 0.0 copy_on_select 0.0 3.5 C copy_on_select no P Copy to clipboard or a private buffer on select. With this set to clipboard, simply selecting text with the mouse will cause the text to be copied to clipboard. Useful on platforms such as macOS that do not have the concept of primary selections. You can instead specify a name such as a1 to copy to a private kitty buffer instead. Map a shortcut with the paste_from_buffer action to paste from this private buffer. For example: 0.0 3.5 C map cmd+shift+v paste_from_buffer a1 P Note that copying to the clipboard is a security risk, as all programs, including websites open in your browser can read the contents of the system clipboard. 0.0 strip_trailing_spaces 0.0 3.5 C strip_trailing_spaces never P Remove spaces at the end of lines when copying to clipboard. A value of smart will do it when using normal selections, but not rectangle selections. always will always do it. 0.0 select_by_word_characters 0.0 3.5 C select_by_word_characters @-./_~?&=%+# P Characters considered part of a word when double clicking. In addition to these characters any character that is marked as an alphanumeric character in the unicode database will be matched. 0.0 click_interval 0.0 3.5 C click_interval -1.0 P The interval between successive clicks to detect double/triple clicks (in seconds). Negative numbers will use the system default instead, if available, or fallback to 0.5. 0.0 focus_follows_mouse 0.0 3.5 C focus_follows_mouse no P Set the active window to the window under the mouse when moving the mouse around 0.0 pointer_shape_when_grabbed 0.0 3.5 C pointer_shape_when_grabbed arrow P The shape of the mouse pointer when the program running in the terminal grabs the mouse. Valid values are: arrow, beam and hand 0.0 default_pointer_shape 0.0 3.5 C default_pointer_shape beam P The default shape of the mouse pointer. Valid values are: arrow, beam and hand 0.0 pointer_shape_when_dragging 0.0 3.5 C pointer_shape_when_dragging beam P The default shape of the mouse pointer when dragging across text. Valid values are: arrow, beam and hand
home | help