r847: New option to control whether a middle button drag moves the files or

[rox-filer.git] / ROX-Filer / Options.xml

<?xml version='1.0' encoding='UTF-8'?>
<options>
  <section name='i18n' title='Translation'>
    <menu name='translation' label='Translation'>
      <item label='None' value='None'/>
      <item label='From LANG' value='From LANG'/>
      <item label='Dutch' value='nl'/>
      <item label='French' value='fr'/>
      <item label='German' value='de'/>
      <item label='Hungarian' value='hu'/>
      <item label='Italian' value='it'/>
      <item label='Polish' value='pl'/>
      <item label='Russian' value='ru'/>
    </menu>
  </section>
  <section name='display' title='Display'>
    <toggle name='sort_nocase' label='Ignore case when sorting'>If off: Ben, animal, zoo.
If on: animal, Ben, zoo.</toggle>
    <toggle name='ignore_exec' label='Ignore eXecutable bit for known extensions'>If a file has a known extension (eg '.gif') then ignore the executable bit. This is useful if you have files on a Windows-type filesystem which are being shown as executable programs.</toggle>
    <toggle name='dirs_first' label='Directories always come first'>If this is on then directories will always appear before anything else, regardless of the sort type.</toggle>
    <slider name='large_width' label='Large wrap width' min='0' max='250' fixed='1'>Text wider than this is broken onto two lines in Large Icons mode. In Huge Icons mode, text is wrapped when 50% wider than this.</slider>
    <slider name='small_width' label='Max Small Icons width' min='0' max='250' fixed='1'>Maximum width for the text beside a Small Icon.</slider>
    <spacer/>
    <toggle name='inherit_options' label='Inherit options from source window'>If this is on then display options for a new window are inherited from the source window if possible, otherwise they are set to the defaults below.</toggle>
    <spacer/>
    <label>Default settings for new windows:</label>
    <menu name='size' label='Icon size'>
      <item label='Huge Icons' value='2'/>
      <item label='Large Icons' value='0'/>
      <item label='Small Icons' value='1'/>
    </menu>
    <menu name='details' label='Details'>
      <item label='No details' value='0'/>
      <item label='Summary' value='1'/>
      <item label='Sizes' value='2'/>
      <item label='Permissions' value='3'/>
      <item label='Type' value='4'/>
      <item label='Times' value='5'/>
    </menu>
    <menu name='sort_by' label='Sort by'>
      <item label='Name' value='0'/>
      <item label='Type' value='1'/>
      <item label='Date' value='2'/>
      <item label='Size' value='3'/>
    </menu>
    <toggle name='show_hidden' label='Show hidden files'>If this is on then files whose names start with a dot are shown too, otherwise they are hidden.</toggle>
    <spacer/>
    <toggle name='colour_types' label='Colour files based on their types'>Filenames (and details) are coloured according to the file's type.</toggle>
    <hbox>
      <vbox>
        <colour name='dir_colour'  lpos='1' label='Directory'/>
        <colour name='file_colour' lpos='1' label='Regular file'/>
        <colour name='pipe_colour' lpos='1' label='Pipe'/>
        <colour name='sock_colour' lpos='1' label='Socket'/>
        <colour name='cdev_colour' lpos='1' label='Character device'/>
      </vbox>
      <vbox>
        <colour name='bdev_colour' lpos='1' label='Block device'/>
        <colour name='exec_colour' lpos='1' label='Executable file'/>
        <colour name='adir_colour' lpos='1' label='Application directory'/>
        <colour name='unkn_colour' lpos='1' label='Unknown type'/>
        <colour name='err_colour'  lpos='1' label='Error (eg. orphan symlink)'/>
      </vbox>
    </hbox>
  </section>
  <section name='pinboard' title='Pinboard'>
    <label>The pinboard is the desktop background.
When the pinboard is turned on, you can drag files
and applications onto it to create short-cuts to them.
See the manual for information about using the pinboard.</label>
    <spacer/>
    <label>Text style:</label>
    <radio-group name='text_bg'>
      <radio label='No background' value='0'>The text is drawn directly on the desktop background.</radio>
      <radio label='Outlined text' value='1'>The text has a thin outline around each letter.</radio>
      <radio label='Rectangular background slab' value='2'>The text is drawn on a solid rectangle.</radio>
    </radio-group>
    <spacer/>
    <hbox label='Text colours:'>
      <colour name='fg_colour' label='Foreground'/>
      <colour name='bg_colour' label='Background'/>
    </hbox>
    <spacer/>
    <toggle name='clamp_icons' label='Keep icons within screen limits'>If this is set, pinboard icons are always kept completely within screen limits, including the label.</toggle>
    <hbox label='Icon grid step:'>
      <radio-group name='grid_step'>
        <radio label='Fine' value='2'>Use a 2-pixel grid for positioning icons on the desktop.</radio>
        <radio label='Medium' value='16'>Use a 16-pixel grid for positioning icons on the desktop.</radio>
        <radio label='Coarse' value='32'>Use a 32-pixel grid for positioning icons on the desktop.</radio>
      </radio-group>
    </hbox>
  </section>

  <section name='panel' title='Panels'>
    <label>Panels are bars of icons that run along the side of the screen.
See the manual for information about using panels.</label>
    <spacer/>
    <radio-group name='style'>
      <radio label='Image and text' value='0'>Every panel icon is shown with an image and some text.</radio>
      <radio label='Image only for applications' value='1'>Applications have just an image, everything else has both an image and text.</radio>
      <radio label='Image only' value='2'>Only the image is shown.</radio>
    </radio-group>
  </section>
  
  <section name='action' title='Action windows'>
    <label>Action windows appear when you start a background
operation, such as copying or deleting some files.</label>
    <spacer/>
    <label>Auto-start (Quiet) these actions:</label>
    <toggle name='copy' label='Copy'>Copy files without confirming first.</toggle>
    <toggle name='move' label='Move'>Move files without confirming first.</toggle>
    <toggle name='link' label='Link'>Create links to files without confirming first.</toggle>
    <toggle name='delete' label='Delete'>Delete files without confirming first.</toggle>
    <toggle name='mount' label='Mount'>Mount and unmount filesystems without confirming first.</toggle>
    <spacer/>
    <label>Default settings:</label>
    <toggle name='force' label='Force'>Don't confirm deletion of non-writeable items.</toggle>
    <toggle name='brief' label='Brief'>Don't display so much information in the message area.</toggle>
    <toggle name='recurse' label='Recurse'>Also change contents of subdirectories.</toggle>
  </section>
  <section name='toolbar' title='Toolbar'>
    <label>Unshade the tools you want:</label>
    <tool-options name='disable'/>
    <spacer/>
    <menu name='type' label='Toolbar type'>
      <item label='None' value='0'/>
      <item label='Small' value='1'/>
      <item label='Large' value='2'/>
    </menu>
    <toggle name='show_info' label='Show totals of items'>Show the number of items displayed in a filer window, as well as the number of hidden items (if any). When there's a selection, show the number of selected items and their combined size.</toggle>
  </section>
  <section name='filer' title='Filer windows'>
    <label>Automatically resize filer windows...</label>
    <radio-group name='auto_resize'>
      <radio label='...never' value='2'>You'll have to resize windows manually, using the window manager, the `Resize Window' menu entry or by double-clicking on the window background.</radio>
      <radio label='...when changing the display style' value='0'>Changing the size of the icons or which details are displayed will resize the window for you.</radio>
      <radio label='...always' value='1'>The filer will resize windows whenever it seems useful (that is, when changing directory or display style).</radio>
    </radio-group>
    <slider name='size_limit' label='Window size limit' min='1' max='100' showvalue='1'>The largest size, as a percentage of the screen size, that the auto-resizer will resize a window to.</slider>
    <spacer/>
    <toggle name='unique_windows' label='Unique windows'>If you open a directory and that directory is already displayed in another window, then this option causes the other window to be closed.</toggle>
    <toggle name='beep_fail' label='Beep if Tab-completion fails'>When using the `Enter Path...' minibuffer and Tab is pressed, beep if nothing happens (eg, because there are several possibilities and the next letter varies).</toggle>
    <toggle name='beep_multi' label='Beep if there are several matches'>When using the `Enter Path...' minibuffer and Tab is pressed, beep if there is more than one matching file, even though some more letters were added.</toggle>
  </section>
  <section name='dnd' title='Drag and Drop'>
    <toggle name='no_hostnames' label="Don't use hostnames">Some older applications don't support XDND fully and may need to have this option turned on. Use this if dragging files to an application shows a + sign on the pointer but the drop doesn't work.</toggle>
    <toggle name='drag_to_icons' label='Allow dragging to icons in filer windows'>When this is on you can drag a file over a sub-directory or program in a filer window. The item will highlight when you do this and dropping the file will put it into that directory, or load it into the program.</toggle>
    <spacer/>
    <label>Dragging files with the middle mouse button...</label>
    <radio-group name='middle_menu'>
      <radio value='1' label='... shows a menu of possible actions'/>
      <radio value='0' label='... moves the file'/>
    </radio-group>
    <spacer/>
    <toggle name='spring_open' label='Directories spring open'>This option, which requires the above option to be turned on too, causes the highlighted directory to 'spring open' after the file is held over it for a short while.</toggle>
    <slider name='spring_delay' label='Spring delay' min='100' max='2000' showvalue='1'>This option sets how long, in ms, you must hold a file over a directory before it will spring open. The above option must be turned on for this to have any effect.</slider>
  </section>
  <section name='menu' title='Menus'>
    <entry name='xterm' label="`Xterm Here' program:">The program to launch when you choose `Xterm Here' from the menu.</entry>
    <spacer/>
    <notice label='Set keyboard shortcuts'>To set a keyboard short-cut for a menu item:

- Open the menu over a filer window,
- Move the pointer over the item you want to use,
- Press the key you want attached to it.

The key will appear next to the menu item and you can just press that key without opening the menu in future.</notice>
    <spacer/>
    <menu name='iconsize' label='Size of icons in menus'>
      <item label='No Icons' value='0'/>
      <item label='Small Icons' value='1'/>
      <item label='Large Icons' value='2'/>
      <!-- <item label='Huge Icons' value='3'/> -->
      <item label='Same as current window' value='4'/>
      <item label='Same as default' value='5'/>
    </menu>
  </section>
  <section name='bind' title='Mouse bindings'>
    <toggle name='new_button_1' label='New window on button 1 (RISC OS style)'>Clicking with mouse button 1 (usually the left button) opens a directory in a new window with this turned on. Clicking with the button-2 (middle) will reuse the current window.</toggle>
    <toggle name='menu_button_2' label='Menu on button 2 (RISC OS style)'>Use button 2, the middle button (click both buttons at once on two button mice), to pop up the menu. If off, use button 3 (right) instead.</toggle>
    <toggle name='single_click' label='Single-click navigation'>Clicking on an item opens it with this on. Hold down Control to select the item instead. If off, clicking once selects an item; double click to open things.</toggle>
  </section>
</options>