D7net
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
usr
/
share
/
doc
/
info
/
html
/
Filename :
Variables.html
back
Copy
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ --> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <!-- This manual is for Stand-alone GNU Info (version 6.8, 22 November 2020), a program for viewing documents in Info format (usually created from Texinfo source files). Copyright (C) 1992, 1993, 1996, 1997, 1998, 1999, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License" in the Texinfo manual. This document is part of a collection distributed under the GNU Free Documentation License. If you want to distribute this document separately from the collection, you can do so by adding a copy of the license to the document, as described in section 6 of the license. --> <title>Variables (Stand-alone GNU Info 6.8)</title> <meta name="description" content="Variables (Stand-alone GNU Info 6.8)"> <meta name="keywords" content="Variables (Stand-alone GNU Info 6.8)"> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="texi2any"> <meta name="viewport" content="width=device-width,initial-scale=1"> <link href="index.html" rel="start" title="Top"> <link href="Index.html" rel="index" title="Index"> <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> <link href="index.html" rel="up" title="Top"> <link href="Colors-and-Styles.html" rel="next" title="Colors and Styles"> <link href="Miscellaneous-Commands.html" rel="prev" title="Miscellaneous Commands"> <style type="text/css"> <!-- a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em} a.summary-letter {text-decoration: none} blockquote.indentedblock {margin-right: 0em} div.display {margin-left: 3.2em} div.example {margin-left: 3.2em} kbd {font-style: oblique} pre.display {font-family: inherit} pre.format {font-family: inherit} pre.menu-comment {font-family: serif} pre.menu-preformatted {font-family: serif} span.nolinebreak {white-space: nowrap} span.roman {font-family: initial; font-weight: normal} span.sansserif {font-family: sans-serif; font-weight: normal} span:hover a.copiable-anchor {visibility: visible} ul.no-bullet {list-style: none} --> </style> </head> <body lang="en"> <div class="chapter" id="Variables"> <div class="header"> <p> Next: <a href="Colors-and-Styles.html" accesskey="n" rel="next">Colors and Styles</a>, Previous: <a href="Miscellaneous-Commands.html" accesskey="p" rel="prev">Miscellaneous Commands</a>, Up: <a href="index.html" accesskey="u" rel="up">Stand-alone GNU Info</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p> </div> <hr> <span id="Manipulating-Variables"></span><h2 class="chapter">12 Manipulating Variables</h2> <p>GNU Info uses several internal <em>variables</em> whose values are looked at by various Info commands. You can change the values of these variables, and thus change the behavior of Info, if desired. </p> <p>There are three ways to set the value of a variable, listed here in order of precedence: </p> <ol> <li> interactively, using the <code>set-variable</code> command described below; </li><li> on the command line, using the <samp>-v</samp> (<samp>--variable</samp>) command line option (see <a href="Invoking-Info.html#variable_002dassignment">variable-assignment</a>); </li><li> in the <code>#var</code> section of the <code>.infokey</code> file (see <a href="Custom-Key-Bindings.html">Customizing Key Bindings and Variables</a>). </li></ol> <dl compact="compact"> <dt id='index-variables_002c-setting'><span><kbd>M-x set-variable</kbd><a href='#index-variables_002c-setting' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-set_002dvariable"></span> <p>Read the name of a variable, and the value for it, in the echo area and then set the variable to that value. Completion is available when reading the variable name (see <a href="The-Echo-Area.html">The Echo Area</a>); completion is also available when reading the value when that makes sense. </p> </dd> <dt id='index-variables_002c-describing'><span><kbd>M-x describe-variable</kbd><a href='#index-variables_002c-describing' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-describe_002dvariable"></span> <p>Read the name of a variable in the echo area and display its value and a brief description. </p></dd> </dl> <p>Here is a list of the variables that you can set in Info. </p> <dl compact="compact"> <dt id='index-automatic_002dfootnotes'><span><code>automatic-footnotes</code><a href='#index-automatic_002dfootnotes' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-_002aFootnotes_002a-window"></span> <span id="index-footnotes-window"></span> <p>When set to <code>On</code>, footnotes appear and disappear automatically; else, they appear at the bottom of the node text. This variable is <code>Off</code> by default. When a node is selected, a window containing the footnotes which appear in that node is created, and the footnotes are displayed within the new window. The window that Info creates to contain the footnotes is called <code>*Footnotes*</code>. If a node is selected which contains no footnotes, and a <code>*Footnotes*</code> window is on the screen, the <code>*Footnotes*</code> window is deleted. Footnote windows created in this fashion are not automatically tiled so that they can use as little of the display as is possible. </p> </dd> <dt id='index-automatic_002dtiling'><span><code>automatic-tiling</code><a href='#index-automatic_002dtiling' class='copiable-anchor'> ¶</a></span></dt> <dd><p>When set to <code>On</code>, creating or deleting a window resizes other windows. This variable is <code>Off</code> by default. Normally, typing ‘<samp>C-x 2</samp>’ divides the current window into two equal parts. When <code>automatic-tiling</code> is set to <code>On</code>, all of the windows are resized automatically, keeping an equal number of lines visible in each window. Any <code>*Completions*</code> and <code>*Footnotes*</code> windows are exceptions to the automatic tiling; they retain their original size. </p> <span id="cursor_002dmovement_002dscrolls"></span></dd> <dt id='index-cursor_002dmovement_002dscrolls'><span><code>cursor-movement-scrolls</code><a href='#index-cursor_002dmovement_002dscrolls' class='copiable-anchor'> ¶</a></span></dt> <dd><p>When set to <code>On</code>, when cursor movement commands reach the top or bottom of a node, another node is loaded depending on the value of <code>scroll-behavior</code> (see below). This is the default. When this variable is set to <code>Off</code>, cursor movements stop at the top or bottom of a node. </p> </dd> <dt id='index-errors_002dring_002dbell'><span><code>errors-ring-bell</code><a href='#index-errors_002dring_002dbell' class='copiable-anchor'> ¶</a></span></dt> <dd><p>When set to <code>On</code> (the default), errors cause the bell to ring. </p> </dd> <dt id='index-follow_002dstrategy'><span><code>follow-strategy</code><a href='#index-follow_002dstrategy' class='copiable-anchor'> ¶</a></span></dt> <dd><p>When set to <code>remain</code> (the default), Info tries to remain within the directory containing the currently displayed Info file when following a cross-reference to an external manual, before looking for the referenced manual in the search path. The alternative value is <code>path</code>, which means to look through the search path right away. </p> <p><code>remain</code> is intended to be useful for several Texinfo manuals that all reference each other and whose versions should match each other. (For example, various manuals relating to a particular version of Emacs.) </p> <p>The alternative behavior, with <code>path</code>, may be useful when your Info file search path parallels your command shell’s search path, and you always want to find documentation of the version of the program that the shell would execute. </p> </dd> <dt id='index-gc_002dcompressed_002dfiles'><span><code>gc-compressed-files</code><a href='#index-gc_002dcompressed_002dfiles' class='copiable-anchor'> ¶</a></span></dt> <dd><p>When set to <code>On</code>, Info garbage collects files which had to be uncompressed. The default value of this variable is <code>Off</code>. Whenever a node is visited in Info, the Info file containing that node is read into memory, and Info reads information about the tags and nodes contained in that file. Once the tags information is read by Info, it is never forgotten. However, the actual text of the nodes does not need to be retained unless a particular Info window needs it. For non-compressed files, node text is not remembered when it is no longer in use. But de-compressing a file can be a time-consuming operation, and so Info tries hard not to do it twice. This variable tells Info it is okay to garbage collect the text of the nodes of a file which was compressed on disk. </p> </dd> <dt id='index-hide_002dnote_002dreferences'><span><code>hide-note-references</code><a href='#index-hide_002dnote_002dreferences' class='copiable-anchor'> ¶</a></span></dt> <dd><p>By default, Info displays the contents of Info files mostly verbatim, including text that is used by Info readers for navigation (for example, marking the location of menus or cross-references). If you set this variable to <code>On</code>, some of this text is hidden, in a similar way to the <code>Info-hide-note-references</code> variable in Emacs (see <a data-manual="info" href="../info/Emacs-Info-Variables.html#Emacs-Info-Variables">Emacs Info Variables</a> in <cite>Info</cite>). </p> </dd> <dt id='index-highlight_002dsearches-1'><span><code>highlight-searches</code><a href='#index-highlight_002dsearches-1' class='copiable-anchor'> ¶</a></span></dt> <dd><p>When set to <code>On</code>, highlight matches from searching commands (see <a href="Searching-Commands.html">Searching an Info File</a>). </p> </dd> <dt id='index-infopath_002dno_002ddefaults'><span><code>infopath-no-defaults</code><a href='#index-infopath_002dno_002ddefaults' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="infopath_002dno_002ddefaults"></span><p>Used in conjunction with the <code>INFOPATH</code> environment variable (see <a href="Invoking-Info.html#INFOPATH">INFOPATH</a>). When set to <code>On</code>, the default documentation directory defined when Info was built (e.g., <samp>/usr/share/info</samp>) is not added to the search path for Info files. </p> </dd> <dt id='index-ISO_002dLatin'><span><code>ISO-Latin</code><a href='#index-ISO_002dLatin' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-ISO-Latin-characters"></span> <span id="index-Meta-key-sets-eighth-bit"></span> <p>The default is <code>On</code>, which means that Info accepts and displays characters represented by bytes with values 128 and above, such as characters in the UTF-8 encoding or in various 8-bit ISO Latin characters, as well as allowing you to input such characters. </p> <p>The only reason to set this variable to <code>Off</code> would be if your terminal set the eighth bit of a byte to represent the Meta key being pressed. </p> </dd> <dt id='index-key_002dtime'><span><code>key-time</code><a href='#index-key_002dtime' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-slow-network-connections"></span> <p>Length of time in milliseconds to wait for the next byte of a byte sequence generated by a key (or key chord) on the keyboard. For example, if the <kbd>down</kbd> key generates the byte sequence <kbd><span class="key">ESC</span> O B</kbd>, and the two bytes <kbd><span class="key">ESC</span> O</kbd> have been received, then a <kbd>B</kbd> byte would have to be received within this length of time for a key press of <kbd>down</kbd> to be registered. You may wish to set this variable to a larger value for slow terminals or network connections. </p> <p>If you set this variable to 0, it’s unspecified whether a recognized byte sequence representing a key takes precedence over another recognized sequence representing a key that is an initial subsequence of the first sequence. In some cases, you may be able to make pressing a special key on the keyboard that Info doesn’t know about (for example, a function key) cause a command to be executed by setting this variable to 0, and giving the byte sequence the key sends in <samp>.infokey</samp>. (See <a href="Custom-Key-Bindings.html">Customizing Key Bindings and Variables</a>.) </p> <span id="min_002dsearch_002dlength"></span></dd> <dt id='index-min_002dsearch_002dlength'><span><code>min-search-length</code><a href='#index-min_002dsearch_002dlength' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Minimum length of a search string (default 1). Attempts to initiate a search for a string (or regular expression) shorter than this value, result in an error. </p> </dd> <dt id='index-mouse'><span><code>mouse</code><a href='#index-mouse' class='copiable-anchor'> ¶</a></span></dt> <dd><p>What method to use to get input from a mouse device. The default value is ‘<samp>Off</samp>’. Set this variable to <code>normal-tracking</code> to make Info use “normal tracking mode” if it detects that the terminal supports it. This enables you to scroll the contents of the active window with a mouse scrollwheel. </p> <span id="index-Selecting-text-with-the-mouse"></span> <span id="index-xterm-mouse-selections"></span> <p>On terminal emulators running under the X Window System, such as <code>xterm</code>, you can usually select text with the mouse. However, mouse tracking mode may interfere with this. When this happens, you may be able to select text by holding down the <kbd>Shift</kbd> key while clicking and dragging. </p> </dd> <dt id='index-nodeline'><span><code>nodeline</code><a href='#index-nodeline' class='copiable-anchor'> ¶</a></span></dt> <dd><span id="index-node-header-line"></span> <p>How to print the node header line that appears at the top of each node. By default only the pointers to neighbouring nodes are displayed (the “Next”, “Prev”, and “Up” pointers): this corresponds to the <code>pointers</code> value for this variable. To print the entire line, set <code>nodeline</code> to the value <code>print</code>, which will include the filename and name of the node. To not display the header line at all, use the value <code>no</code>. </p> <span id="scroll_002dbehavior"></span></dd> <dt id='index-scroll_002dbehavior'><span><code>scroll-behavior</code><a href='#index-scroll_002dbehavior' class='copiable-anchor'> ¶</a></span></dt> <dt id='index-scroll_002dbehaviour'><span><code>scroll-behaviour</code><a href='#index-scroll_002dbehaviour' class='copiable-anchor'> ¶</a></span></dt> <dd><p>The two variable names are synonymous. Control what happens when scrolling commands are used at the end or beginning of a node (see <a href="Scrolling-Commands.html">Moving Text Within a Window</a>). The default value for this variable is <code>Continuous</code>. Possible values: </p> <dl compact="compact"> <dt><span><code>Continuous</code></span></dt> <dd><p>Try to get the first item in this node’s menu, or failing that, the ‘<samp>Next</samp>’ node, or failing that, the ‘<samp>Next</samp>’ of the ‘<samp>Up</samp>’ node. This behavior is identical to using the ‘<samp>]</samp>’ (<code>global-next-node</code>) and ‘<samp>[</samp>’ (<code>global-prev-node</code>) commands. </p> </dd> <dt><span><code>Next Only</code></span></dt> <dd><p>Only try to get the ‘<samp>Next</samp>’ node. </p> </dd> <dt><span><code>Page Only</code></span></dt> <dd><p>Just stop, changing nothing. With this value, no scrolling command can change the node that is being viewed. </p></dd> </dl> <p>This variable also affects cursor movement commands (see <a href="Cursor-Commands.html">Moving the Cursor</a>) unless the <code>cursor-movement-scrolls</code> variable is set to <code>Off</code>. See <a href="#cursor_002dmovement_002dscrolls">cursor-movement-scrolls</a>. </p> </dd> <dt id='index-scroll_002dlast_002dnode'><span><code>scroll-last-node</code><a href='#index-scroll_002dlast_002dnode' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Control what happens when a scrolling command is issued at the end of the last node. Possible values are: </p> <dl compact="compact"> <dt><span><code>Stop</code></span></dt> <dd><p>Do not scroll. Display the ‘<samp>No more nodes within this document</samp>’ message. This is the default. </p> </dd> <dt><span><code>Top</code></span></dt> <dd><p>Go to the top node of the document. </p></dd> </dl> <p>This variable is in effect only if <code>scroll-behavior</code> is set to <code>Continuous</code>. </p> </dd> <dt id='index-scroll_002dstep'><span><code>scroll-step</code><a href='#index-scroll_002dstep' class='copiable-anchor'> ¶</a></span></dt> <dd><p>The number of lines to scroll to bring the cursor back into the window. The default value of this variable is 1, which causes a kind of “smooth scrolling” which some people prefer. Scrolling happens automatically if the cursor has moved out of the visible portion of the node text. </p> <p>If the variable <code>scroll-step</code> is 0, the cursor (and the text it is attached to) is placed in the centre of the window. </p> </dd> <dt id='index-search_002dskip_002dscreen'><span><code>search-skip-screen</code><a href='#index-search_002dskip_002dscreen' class='copiable-anchor'> ¶</a></span></dt> <dd><p>Set the starting point of repeated searches (see <a href="Searching-Commands.html#repeated_002dsearch">repeated-search</a>). When set to <code>Off</code> (the default), repeated searches start at the position immediately following (when searching in forward direction), or immediately preceding (when searching backwards) the cursor. When set to <code>On</code>, repeated searches omit lines visibly displayed on the screen. In other words, forward searches (<kbd>}</kbd>) start at the beginning of the next page, and backward searches (<kbd>{</kbd>) start at the end of the previous page. </p> </dd> <dt id='index-show_002dindex_002dmatch'><span><code>show-index-match</code><a href='#index-show_002dindex_002dmatch' class='copiable-anchor'> ¶</a></span></dt> <dd><p>When set to <code>On</code> (the default), the portion of the matched search string that you typed is indicated (by displaying it in the “opposite” case) in the result message (see <a href="Searching-Commands.html"><code>next-index-match</code></a>). </p> </dd> <dt id='index-visible_002dbell'><span><code>visible-bell</code><a href='#index-visible_002dbell' class='copiable-anchor'> ¶</a></span></dt> <dd><p>When set to <code>On</code>, Info attempts to flash the screen instead of ringing the bell. This variable is <code>Off</code> by default. If the terminal does not allow flashing, this variable has no effect. (But you can still make Info perform quietly by setting the <code>errors-ring-bell</code> variable to <code>Off</code>; or using an external command to mute the bell, e.g., <code>xset b 0 0 0</code>.) </p> </dd> </dl> </div> <hr> <div class="header"> <p> Next: <a href="Colors-and-Styles.html">Colors and Styles</a>, Previous: <a href="Miscellaneous-Commands.html">Miscellaneous Commands</a>, Up: <a href="index.html">Stand-alone GNU Info</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html" title="Index" rel="index">Index</a>]</p> </div> </body> </html>