<page xmlns="http://projectmallard.org/1.0/"
      xmlns:e="http://projectmallard.org/experimental/"
      type="topic"
      id="preferences">

  <info>
    <link type="guide" xref="index#panel"/>
    <desc>Configure the <app>Xfce Panel</app></desc>
    <credit type="author">
      <name>Nick Schermer</name>
      <email>nick@xfce.org</email>
    </credit>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>
  </info>

  <title>Preferences</title>
  
  <p>
    The panel preferences can be openen by using the item menu <guiseq>
    <gui>Xfce Panel</gui><gui>Panel Preferences</gui></guiseq> or by 
    clicking on the <gui>Panel Preferences</gui> in the the 
    <app>Xfce Settings Manager</app>.
  </p>

  <figure>
    <title>Panel's Preferences dialog</title>
    <media type="image" src="figures/preferences.png" mime="image/png" style="right"/>
  </figure>
  
  <section>
    <title>Select a panel</title>
    
    <p>
      You can select a panel with the combo box in the top of the dialog.
      Next to this selector there are also two buttons to remove the 
      currently selected panel or add a new empty panel.
    </p>
    
    <p>
      The panel selected in the dialog should also show a slection around
      the panel, so it is clear which panel you are editing.
    </p>
  </section>
  
  <section>
    <title>Display</title>
     
    <p>
      This tab hold the settings how the panel is positioned on the
      screen.
    </p>
    
    <section>
      <title>General</title>
      
      <terms>
        <item>
          <title><gui>Orientation</gui></title>
          <p>
            Set the panel orientation to horizontal or vertical.
          </p>
        </item>
        
        <item>
          <title><gui>Output</gui></title>
          <p>
            Select the output on which this panel should appear. If the
            output is not connected, the panel will not be shown.
          </p>
        </item>
        
        <item>
          <title><gui>Span monitors</gui></title>
          <p>
            If you have multiple monitors connected to the computer, this
            option will appear in the properties dialog. It will
            set the panel to look at the screen size instead of the monitor
            size.
          </p>
        </item>
        
        <item>
          <title><gui>Lock panel</gui></title>
          <p>
            Don't show the handles on the panel whcih allow you to move
            the panel or draw it to snap positions on the bordes of the
            monitor.
          </p>
        </item>
        
        <item>
          <title><gui>Automatically show and hide the panel</gui></title>
          <p>
            Hide the panel 
          </p>
        </item>
      </terms>
    </section>
    
    <section>
      <title>Measurements</title>
      
      <terms>
        <item>
          <title><gui>Size</gui></title>
          <p>
            Change the height (or width if the orientation is vertical) 
            of the panel. The size is in pixels.
          </p>
        </item>
      
        <item>
          <title><gui>Length</gui></title>
          <p>
            Change the width (or height if the orientation is vertical) 
            of the panel. The size is a percentage of the monitor or
            screen size.
          </p>
        </item>
        
        <item>
          <title><gui>Automatically increase length</gui></title>
          <p>
            Increase the panel size to fit the contents of the panel. Is
            work with expanding plugins, like the <link xref="tasklist">
            window buttons</link> plugins.
          </p>
        </item>
      </terms>
    </section>
  </section>
  
  <section id="appearance">
    <title>Appearance</title>
    
    <p>
      This tab hold the style settings of the currently selected panel.
    </p>
    
    <section>
      <title>Background</title>
      
      <terms>
        <item>
          <title><gui>Style</gui></title>
          <p>
          
          </p>
        </item>
        
        <item>
          <title><gui>Alpha</gui></title>
          <p>
          
          </p>
        </item>
        
        <item>
          <title><gui>Color</gui></title>
          <p>
          
          </p>
        </item>
        
        <item>
          <title><gui>File</gui></title>
          <p>
          
          </p>
        </item>
      </terms>
    </section>
    
    <section>
      <title>Transparency</title>
      
      <terms>
        <item>
          <title><gui>Enter</gui></title>
          <p>
          
          </p>
        </item>
      
        <item>
          <title><gui>Leave</gui></title>
          <p>
          
          </p>
        </item>
      </terms>
    </section>
  </section>
  
  <section>
    <title>Items</title>
    
    <p>
      This shows the items that are placed on the currently selected panel.
      In case items are hard to move or edit on the panel using the
      right-click menu, this tab allows you to move, add, remove and access
      the preferences of the items on the panel.
    </p>
    
    <p>
      Most of the tab is self explaining. With the up and down buttons you
      can move the currently selected item in the panel.
    </p>
    
    <p>
      The add button opens the <link xref="add-new-items">add new items
      dialog</link>. With the remove button you can remove the currently
      selected item van de panel.
    </p>
    
    <p>
      The preferences and about buttons are only active if the plugin
      support these features. It will open the item settings.
    </p>
    
    <p>
      Only limition in this dialog, compared to mouse handling, is that
      you cannot move items between panels and access custom menu items
      a plugin can add in the item menu.
    </p>
  </section>
</page>
