<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Strict//EN"> <HTML LANG="en"> <HEAD> <META NAME="Author" CONTENT="Emil Brink, emil@obsession.se, 27-Aug-1998"> <META NAME="Design and HTML" CONTENT="Ulf Pettersson, ulf@obsession.se, 29-Sep-1998"> <META NAME="Copyright" CONTENT="May be redistributed and changed according to the GNU General Public License. See gpl.html" LANG="en"> <META NAME="Keywords" CONTENT="gentoo, Obsession, Emil Brink, filemanager, GTK+, Linux, file management, graphical configurability, Ulf Pettersson, Johan Hanson, files, copying, Obsession Development, " LANG="en"> <META NAME="Description" CONTENT="gentoo Documentation and User Manual. gentoo is a highly configurable graphical filemanager for Linux and other Unix-operating systems." LANG="en"> <META NAME="Resource-Type" CONTENT="document"> <META HTTP-EQUIV="Content-Type" CONTENT="text/html, charset=iso-8859-1"> <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> <LINK REL="Toc" HREF="index.html"> <LINK REL="Next" HREF="gentoorc.html"> <LINK REL="Previous" HREF="index.html"> <LINK REL="Stylesheet" HREF="../gentoo.css" TYPE="text/css"> <TITLE>gentoo Documentation: The Configuration Window</TITLE> </HEAD> <BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#33EE33" VLINK="#EF8210" ALINK="#FFFF00"> <TABLE BORDER="0" WIDTH="100%"> <TR> <TD HEIGHT="90" VALIGN="Middle"><A HREF="../index.html"><IMG SRC="../images/gentoo_logo_g.gif" WIDTH="50" HEIGHT="50" ALT="Back to Table of Contents" VSPACE="8" HSPACE="32" BORDER="0"></A><IMG SRC="../images/gentoo_logo_text.gif" WIDTH="200" HEIGHT="55" ALT="gentoo - A Click-Ass Filemanager" BORDER="0"></TD> <TD ALIGN="CENTER"> </TD> <TD ALIGN="RIGHT" VALIGN="Middle"> <A HREF="http://www.obsession.se/"><IMG SRC="../images/od__logo_small.gif" WIDTH="64" HEIGHT="61" HSPACE="32" ALT="Go to Obsession Developments Homepage" BORDER="0"></A> </TD> </TR> </TABLE> <TABLE WIDTH="100%" CELLSPACING=0 CELLPADDING=2 BORDER=0 STYLE="background: #000000; text-align: center;"> <TR> <TD CLASS="Select"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"> <A HREF="../gpl.html" TITLE="License - How to distribute this software">LICENSE</A></SMALL></TD> <TD CLASS="Select"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"> <A HREF="../relnotes.html" TITLE="Release Notes - Notes regarding this release">NOTES</A></SMALL></TD> <TD CLASS="Select"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"> <A HREF="../quick.html" TITLE="Quick Guide - A quick guide to the basic concepts of gentoo">GUIDE</A></SMALL></TD> <TD CLASS="Select"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"> <A HREF="../intro.html" TITLE="Introduction - Why another filemanager?, The features and goals of gentoo ">INTRO</A></SMALL></TD> <TD CLASS="Select"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"> <A HREF="../usage.html" TITLE="Usage - How to use gentoo">USAGE</A></SMALL></TD> <TD CLASS="Section"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"><A HREF="../config/index.html" TITLE="Configuration - How to configure gentoo">CONFIG</A></SMALL></TD> <TD CLASS="Select"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"><A HREF="../history.html" TITLE="History - History of changes between versions">HISTORY</A></SMALL></TD> <TD CLASS="Select"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"><A HREF="../contribute.html" TITLE="Contribute - Help making gentoo a better filemanager">CONTRIBUTING</A></SMALL></TD> <TD CLASS="Select"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"><A HREF="../acks.html" TITLE="Acknowledgements - Who made gentoo?, Thanks">ACKS</A> </SMALL></TD> </TR> </TABLE> <H1>The Configuration Window</H1> <IMG SRC="../images/tone.gif" WIDTH=175 HEIGHT=18 BORDER="0"> <H2>Introduction</H2> <P> This section of the manual describes some general features about <STRONG>gentoo</STRONG>'s configuration window. </P> <H2>Accessing the Configuration Window</H2> <P> When you wish to make changes to <STRONG>gentoo</STRONG>'s configuration, you need to somehow execute the built-in command <B>Configure</B>. When this command is run, the configuration window is opened. With the default (built-in) configuration of <STRONG>gentoo</STRONG>, you can execute this command by either clicking the button labeled "Configure" in the top right corner of the button bank, or by selecting the menu item of the same name in the pop-up menu reached by right-clicking in a dir pane. </P> <H2>Config Window Layout</H2> <P> The configuration window has a very simple layout. It consists mainly of two parts: a big working area, which only contains a so called "notebook widget", and a strip of buttons along the bottom of the window. Here's a screenshot: </P> <DIV> <IMG SRC="../images/cfg_gui.gif" WIDTH=522 HEIGHT=679 ALT="Configuration Window Screenshot"> </DIV> <H3>The Notebook</H3> <P> The notebook widget is a container; it holds other widgets. It divides its contents into pages, and always displays exactly one page at any particular moment. The things at the top (labeled "File Styles", "File Types" and so on) are known as <EM>tabs</EM>. Each page has a tab: click on a page's tab to cause it to be displayed. </P> <H3>Configuration Widget Behaviour</H3> <P> Most configuration pages share some common features, to make them easier to use. A typical configuration page contains quite a lot of different widgets; it is easy to get confused about which widget to use (and when). In an attempt at reducing this confusion, most configuration pages make all widgets that are not immediately useful <EM>insensitive</EM> to user manipulation. Insensitive widgets are drawn in a distinct way, making them easy to spot. They also don't react to having the mouse pointer over them, like most other GTK+ widgets do. In the screenshot above, all widgets but two are insensitive. </P> <P> The "Add" and "Delete" buttons that appear near the bottom of the page in the picture are very common in config pages. Not all pages use these two buttons, but those that do always place them in the exact same position, thus making them easy to spot. </P> <H3>The Bottom Buttons</H3> <P> The three buttons along the bottom ("OK", "Save" and "Cancel") are not part of the current page, but are always visible. All three close down the configuration window, with various side effects: </P> <DL> <DT>OK</DT> <DD><STRONG>Accepts all</STRONG> changes and makes them current. As the config window closes, the new settings take effect and <STRONG>gentoo</STRONG> updates itself to reflect them.</DD> <DT>Save</DT> <DD>Accepts the changes, and then <STRONG>saves</STRONG> them out to disk. The configuration is always saved in <CODE>$HOME/~.gentoorc</CODE>. For more information about the configuration file format, <A HREF="gentoorc.html">read here</A>.</DD> <DT>Cancel</DT> <DD>Aborts the configuration option, <STRONG>abandoning all</STRONG> changes.</DD> </DL> </BODY> </HTML>