LICENSE | GUIDE | INTRO | USAGE | CONFIG | HISTORY | CONTRIBUTING | ACKS

# The Directory Panes

## Introduction

In gentoo's main window, there are always exactly two directories being shown. The directories are displayed in sub-windows inside the main window; each such sub-window is called a directory pane. Between the panes is a small handle which allows you to adjust the relative size of the two panes, this is sometimes useful when one pane is more interesting than the other.

The pane also provides scrollbars for navigating inside it; these are only shown when actually needed. As soon as all information fits on-screen, the scrollbars disappear.

Below the file listing, a text box showing the path to the displayed directory is shown. To move to another directory directly (without clicking through the hierarchy), you can click in this box and type the path. When you press <Return>, gentoo will attempt to go to the named directory. If you begin the path with a dollar sign ($) and then the name of an environment variable, gentoo will look up the value of the variable and use that instead. For example, on many systems you can enter $HOME to go to your own home directory.

## Current Pane

One of the two panes is always the current one. The active pane has the background color of its column buttons set to some distinct color. In the screenshot, it should be easy to see that the pane on the left is current.

To make a pane current, you can:

1. Click in it. This will also select the item hit, if any.
2. Click on one of its scrollbars, if any is displayed.
3. Click in its path entry text box.
4. Envoke the ActivateOther built-in command, currently always bound to the <Space Bar> key.

## Pane Columns

For each row in a pane, gentoo displays a selection of information. Which information is displayed, in in what order, is fully user configurable, see the chapter on configuring gentoo for details. The information is divided into columns; a column displays the same piece of information for all of the rows in a pane. Examples of columns include name, size, owner, various dates, and type. There are almost 20 different types of column content available for you to choose from! For a rundown on these, see the column content reference table.

A directory listing in gentoo is always kept sorted in order to make it easier for you to locate the files of interest. Sorting is always done on a specific column of the pane. The default is to sort on file names. It is often helpful to sort on size, to quickly locate the largest files in a directory for example. You can change all about the sorting in the configuration window, but there's a quicker way: just click on a column heading (the gray boxes showing column content titles) and gentoo will switch the sorting of the pane to the column you clicked. Click again and the sorting becomes inverted, i.e. it sorts from Z-A rather than A-Z.

Each pane can have its own sorting configuration.

## Selecting Files

Before you can operate upon any files, you need to tell gentoo which files are of interest. This is done by selecting the files (or directories, links, devices...) in question. Each pane maintains its own set of selected files independently from the other.

The simplest, and most commonly used, way to select a file is to place the mouse cursor anywhere in the file's row in a pane, and click the left mouse button (once). The display of the file then changes, generally inverting the colors, thus indicating that the file has been selected. The status line updates to reflect the change, of course. Clicking on an already selected file causes it to be unselected. If you wish to select multiple neigboring rows rapidly, click the mouse on the first, hold the button down, and drag towards the last file to select. Then release the button. As you drag, gentoo selects all touched files. If you drag fast, gentoo uses a simple interpolation technique to select the intermediate files. At the moment, you can not drag outside the pane to cause scrolling, as is customary on e.g. Windows, since the GTK+ widget used to implement the dir panes does not support this, and I haven't found a nice (read: simple) way of doing it myself...

### Power Clicking

By holding down a keyboard modifier key before clicking, you can alter the way in which gentoo handles the click:

Shift
  Shift can be used to select a really large interval of files. When you click with a Shift key held down, gentoo will select all files from the last one you clicked to the shift-clicked one. For example, if you click (without Shift) on the first file in a pane, then use the scroll bar to reach the bottom of the pane and Shift-click on the last file, all files will be selected.
Control
  Control acts just like Shift, but only does unselection. It is moderately useful, but included for completeness.
Meta (Alt)
  If you hold down the Meta modifier (which on my fairly standard PC keyboard is actually the key labeled "Alt") and click a file, gentoo does something interesting: it toggles the selected/unselected state of all files of the same type as the one clicked! This is mighty useful when working with directories containing files of many different types: if you have gentoo correctly configured, you can select all files of a certain type just by locating one file of the type in question, nailing down that Alt (or whatever) key, and clicking! For more information about file types, read the relevant chapter.
Meta + Shift
  When used in combination with Shift, the Meta-click will always select all files of the same type as the clicked one. This is useful if perhaps some of the files are already selected, and you wish to extend the selection to really include them all. Shift+Meta-clicking on any of the files will extend the selection, and not miss anything.
Meta + Control
  When used in combination with Control, the Meta-click will always unselect all files having the same type as the one clicked. This can be useful if you're trying to reduce a selection down to just a few interesting files, since it allows the removal of all files sharing type from the set of selected files, with just once click.
Meta + Shift + Control
  If you click a row with all three of these modifiers held down, it indicates that your digital dexterity is above average. It also instructs gentoo to something really cool: toggle the selected state of all rows whose suffix (including the separating period) are equal to that of the clicked row! This can be useful if you are working in a directory containing suffix-typed files, but haven't yet set up gentoo's own type-system to handle it. If the clicked row doesn't contain a period, nothing happens.

You can also select files based on their name, using Unix System V8 regular expressions. For more information on this, see the SelectRE built-in command.

Once you have one or more files selected, you can perform some operation on them. The standard way to do this is to click one of the command button the button bank shown below the directory panes.