<page xmlns="http://projectmallard.org/1.0/"
      type="guide"
      id="pref-scrolling">

  <info>
    <revision pkgversion="3.8" date="2013-02-25" status="draft"/>
    <revision pkgversion="3.12" date="2014-09-08" status="review"/>
    <link type="guide" xref="index#preferences"/>
    <link type="guide" xref="pref#profile"/>

    <credit type="author copyright">
      <name>Sindhu S</name>
      <email>sindhus@live.in</email>
      <years>2013</years>
    </credit>
    <credit type="copyright editor">
      <name>Ekaterina Gerasimova</name>
      <email>kittykat3756@gmail.com</email>
      <years>2013–2014</years>
    </credit>

    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>

    <desc>Change the scroll output and scrollbar behavior.</desc>
  </info>

  <title>Scrollbar preferences</title>

  <p>When a lot of output is printed to your terminal screen, it can be helpful
  to have your terminal behave in a specific manner so that it is easier to
  work with.</p>

  <section id="visibility">
    <title>Scrollbar visibility</title>

    <p>You can disable the scrollbar:</p>

    <steps>
      <item>
        <p>Open <guiseq><gui style="menu">Edit</gui>
        <gui style="menuitem">Preferences</gui></guiseq>.</p>
      </item>
      <item>
        <p>Your current profile is selected in the sidebar. If you wish to edit
        a different profile, click on its name.</p>
      </item>
      <item>
        <p>Select <gui style="tab">Scrolling</gui>.</p>
      </item>
      <item>
        <p>Uncheck <gui>Show scrollbar</gui>.</p>
      </item>
    </steps>

    <p>Your preference is saved immediately.</p>

  </section>

  <section id="on-output">
    <title>Scroll on output</title>

    <p>You can lock scrolling so that it always shows the newest output while a
    command executes and produces output.</p>

    <steps>
      <item>
        <p>Open <guiseq><gui style="menu">Edit</gui>
        <gui style="menuitem">Preferences</gui></guiseq>.</p>
      </item>
      <item>
        <p>Your current profile is selected in the sidebar. If you wish to edit
        a different profile, click on its name.</p>
      </item>
      <item>
        <p>Select <gui style="tab">Scrolling</gui>.</p>
      </item>
      <item>
        <p>Check <gui style="checkbox">Scroll on output</gui>.</p>
      </item>
    </steps>

  </section>

  <section id="on-keystroke">
    <title>Scroll on input</title>

    <p>You can set the terminal to automatically scroll to the bottom of the
    window when you input text into the prompt.</p>

    <steps>
      <item>
        <p>Open <guiseq><gui style="menu">Edit</gui>
        <gui style="menuitem">Preferences</gui></guiseq>.</p>
      </item>
      <item>
        <p>Your current profile is selected in the sidebar. If you wish to edit
        a different profile, click on its name.</p>
      </item>
      <item>
        <p>Select <gui style="tab">Scrolling</gui>.</p>
      </item>
      <item>
        <p>Check <gui style="checkbox">Scroll on keystroke</gui>.</p>
      </item>
    </steps>
  </section>

  <section id="lines">
    <title>Scrollback lines</title>

    <p>You can limit the number of lines of terminal output which are
    remembered.</p>

    <steps>
      <item>
        <p>Open <guiseq><gui style="menu">Edit</gui>
        <gui style="menuitem">Preferences</gui></guiseq>.</p>
      </item>
      <item>
        <p>Your current profile is selected in the sidebar. If you wish to edit
        a different profile, click on its name.</p>
      </item>
      <item>
        <p>Select <gui style="tab">Scrolling</gui>.</p>
      </item>
      <item>
        <p>Check <gui>Limit scrollback to</gui> and enter a number of lines
        to limit scrollback.</p>
      </item>
      <item>
        <p>Optionally, you can click on <gui style="button">+</gui> to
        increase and <gui style="button">-</gui> to decrease lines.</p>
      </item>
    </steps>

    <p>You can choose to have unlimited scrollback.</p>

    <steps>
      <item>
        <p>Open <guiseq><gui style="menu">Edit</gui>
        <gui style="menuitem">Preferences</gui></guiseq>.</p>
      </item>
      <item>
        <p>Your current profile is selected in the sidebar. If you wish to edit
        a different profile, click on its name.</p>
      </item>
      <item>
        <p>Select <gui style="tab">Scrolling</gui>.</p>
      </item>
      <item>
        <p>Uncheck <gui>Limit scrollback to</gui>.</p>
      </item>
    </steps>

    <note style="tip">
      <p>Scrollback data is stored in compressed and encrypted files on disk,
      under the system’s default location for temporary files (usually
      <file>/tmp</file>). These files are unlinked immediately after their
      creation, and as such, do not show up in the directory listing. The
      occupied disk space is freed up as soon as the corresponding terminal
      closes.</p>
    </note>

    <note style="warning">
      <p>Make sure you have sufficient disk space available for these temporary
      files. If in doubt, monitor disk usage for example with the command
      <cmd>du /tmp</cmd>.</p>
    </note>

    <note style="important">
      <p>A giant scrollback buffer makes resizing the terminal window slower.
      As a rule of thumb, resizing gets noticeably slow at around 1 million
      lines.</p>
    </note>

  </section>

</page>
