PageRenderTime 143ms CodeModel.GetById 126ms app.highlight 11ms RepoModel.GetById 1ms app.codeStats 0ms

/www/tags/NOV_07_2009/htdocs/42docs/users-guide/vfs-browser.html

#
HTML | 101 lines | 101 code | 0 blank | 0 comment | 0 complexity | 55e35a76fb23f20764773a7a73827d07 MD5 | raw file
  1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>The File System Browser</title><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="jEdit 4.2 User's Guide"><link rel="up" href="files.html" title="Chapter 4. Working With Files"><link rel="previous" href="encodings.html" title="Character Encodings"><link rel="next" href="reloading.html" title="Reloading From Disk"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">The File System Browser</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="encodings.html">Prev</a> </td><th width="60%" align="center">Chapter 4. Working With Files</th><td width="20%" align="right"> <a accesskey="n" href="reloading.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="vfs-browser"></a>The File System Browser</h2></div></div><div></div></div><p>
  2   <span><b class="guimenu">Utilities</b></span>&gt;<span><b class="guimenuitem">File System
  3   Browser</b></span> displays the file system browser.
  4   By default, the file system browser is shown in a floating window. This window can be docked using the commands in its top-left corner popup menu; see <a href="docking.html" title="Window Docking">the section called &#8220;Window Docking&#8221;</a>.
  5  </p><p>
  6   The file system browser can be customized in the
  7   <span><b class="guimenu">Utilities</b></span>&gt;<span><b class="guimenuitem">Global Options</b></span>
  8   dialog box; see <a href="global-opts.html#vfs-browser-pane" title="The File System Browser Panes">the section called &#8220;The File System Browser Panes&#8221;</a>.
  9  </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2593936"></a>Navigating the File System</h3></div></div><div></div></div><p>
 10    The directory to browse is specified in the <span><b class="guibutton">Path</b></span> text
 11    field. Clicking the mouse in the text field automatically selects its
 12    contents allowing a new path to be quickly typed in. If a relative path is
 13    entered, it will be resolved relative to the current path. This text field
 14    remembers previously entered strings; see <a href="history.html" title="Appendix C. History Text Fields">Appendix C, <i>History Text Fields</i></a>.
 15    The same list of previously browsed directories is also listed in the
 16    <span><b class="guimenu">Utilities</b></span>&gt;<span><b class="guisubmenu">Recent Directories</b></span>
 17    menu; selecting one opens it in the file system browser.
 18   </p><p>
 19    To browse a listed directory, double-click it (or if you have a three-button
 20    mouse, you can click the middle mouse button as well). Alternatively, click
 21    the disclosure
 22    widget next to a directory to list its contents in place.
 23    To browse higher up in the directory hierarchy, double-click one of the parent
 24    directories in the parent directory list.
 25   </p><p>
 26    Files and directories in the file list are shown in different colors
 27    depending on what glob patterns their names match. The patterns and colors
 28    can be customized in the
 29    <span><b class="guibutton">File System Browser</b></span>&gt;<span><b class="guibutton">Colors</b></span>
 30    pane of the
 31    <span><b class="guimenu">Utilities</b></span>&gt;<span><b class="guimenuitem">Global Options</b></span>
 32    dialog box.
 33   </p><p>
 34    To see a specific set of files only (for example,
 35    those whose names end with <tt class="filename">.java</tt>), enter a glob pattern
 36    in the <span><b class="guibutton">Filter</b></span> text field.
 37    This text fields remembers previously entered strings.
 38    See <a href="globs.html" title="Appendix D. Glob Patterns">Appendix D, <i>Glob Patterns</i></a> for information about glob patterns.
 39   </p><p>
 40    Unopened files can be opened by double-clicking (or by
 41    clicking the middle mouse button). Open files have their names underlined,
 42    and can be selected by single-clicking.
 43    Holding down <tt class="keycap">Shift</tt>
 44    while opening a file will open it in a new view.
 45   </p><p>
 46    Clicking a file or directory with the right mouse button displays a popup
 47    menu containing various commands. 
 48   </p><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>
 49     The file list sorting algorithm used in jEdit handles numbers in file names
 50     in an intelligent manner. For example, a file named
 51     <tt class="filename">section10.xml</tt> will be placed after a file named
 52     <tt class="filename">section5.xml</tt>. A conventional letter-by-letter
 53     sort would have placed these two files in the wrong order.
 54    </p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2594115"></a>The Tool Bar</h3></div></div><div></div></div><p>
 55    The file system browser has a tool bar containing a number of buttons.
 56    Each item in the <span><b class="guibutton">Commands</b></span>
 57    menu (described below) except
 58    <span><b class="guimenuitem">Show Hidden Files</b></span> and
 59    <span><b class="guisubmenu">Encoding</b></span> has a corresponding tool bar button.
 60   </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2594210"></a>The Commands Menu</h3></div></div><div></div></div><p>
 61    Clicking the <span><b class="guibutton">Commands</b></span> button displays a menu
 62    containing the following items:
 63   </p><div class="itemizedlist"><ul type="disc"><li><p><span><b class="guimenuitem">Parent Directory</b></span> - moves up in
 64    the directory hierarchy.</p></li><li><p><span><b class="guimenuitem">Reload Directory</b></span> - reloads the
 65    file list from disk.</p></li><li><p><span><b class="guimenuitem">Root Directory</b></span> - on Unix,
 66    goes to the root directory (<tt class="filename">/</tt>). On Windows and MacOS X,
 67    lists all mounted drives and network shares.</p></li><li><p><span><b class="guimenuitem">Home Directory</b></span> - displays your
 68    home directory.</p></li><li><p><span><b class="guimenuitem">Directory of Current Buffer</b></span> - displays the
 69    directory containing the currently active buffer.</p></li><li><p><span><b class="guimenuitem">New File</b></span> - opens new, empty,
 70    buffer in the current directory. The file will
 71    not actually be created on disk until the buffer is saved.</p></li><li><p><span><b class="guimenuitem">New Directory</b></span> - creates a new
 72    directory after prompting for the desired name.</p></li><li><p><span><b class="guimenuitem">Search in Directory</b></span> -
 73    displays the search and
 74    replace dialog box set to search all files in the current directory. If a
 75    file is selected when this command is invoked, its extension becomes the
 76    file name filter for the search;
 77    otherwise, the file name filter entered in the browser is used.
 78    See <a href="search-replace.html" title="Search and Replace">the section called &#8220;Search and Replace&#8221;</a> for details.</p></li><li><p><span><b class="guimenuitem">Show Hidden Files</b></span> - toggles if
 79    hidden files are to be shown in the file list.</p></li><li><p><span><b class="guisubmenu">Encoding</b></span> - a menu for selecting
 80    the character encoding to use when opening files. See
 81    <a href="encodings.html" title="Character Encodings">the section called &#8220;Character Encodings&#8221;</a>.</p></li></ul></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2594331"></a>The Plugins Menu</h3></div></div><div></div></div><p>
 82    Clicking the <span><b class="guibutton">Plugins</b></span> button displays a menu
 83    containing plugin commands. For information
 84    about plugins, see <a href="using-plugins.html" title="Chapter 9. Installing and Using Plugins">Chapter 9, <i>Installing and Using Plugins</i></a>.
 85   </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2594349"></a>The Favorites Menu</h3></div></div><div></div></div><p>
 86    Clicking the <span><b class="guibutton">Favorites</b></span> button displays a menu
 87    showing all files and directories in the favorites list. The
 88    <span><b class="guimenuitem">Add to Favorites</b></span> item adds the currently selected file to the favorites list. If nothing is selected, the current directory is added. To remove
 89    a file from the favorites, invoke
 90    <span><b class="guimenuitem">Edit Favorites</b></span>, which will show the favorites
 91    list in the file system view, then select <span><b class="guimenuitem">Delete</b></span>
 92    from the right-click menu of the entry you want to remove.
 93   </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2594379"></a>Keyboard Shortcuts</h3></div></div><div></div></div><p>
 94    Completion behaves differently in file dialogs than in the stand-alone file system browser window.
 95   </p><p>
 96    In the file dialog, keyboard input goes in the file name field by default. Pressing <tt class="keycap">Enter</tt> opens the file or directory path that is either fully or partially entered in the file name field. Typing the first few characters of a file's name selects that file. If the file name field is empty and nothing is selected, <tt class="keycap">/</tt> lists the root directory on Unix and the list of drives on Windows. There are two handy abbreviations that may be used in file paths: <tt class="keycap">~</tt> expands to the home directory, and <tt class="keycap">-</tt> expands to the current buffer's directory.
 97   </p><p>
 98    For example, to open a file <tt class="filename">/home/slava/jEdit/doc/TODO.txt</tt>, you might enter <tt class="filename">~/j/d/to</tt>.
 99   </p><p>
100    In the stand-alone file system browser, keyboard input is handled slightly differently. There is no file name field, instead shortcuts are active when the file tree has keyboard focus. Additionally, pressing <tt class="keycap">/</tt>, <tt class="keycap">~</tt> or <tt class="keycap">-</tt> always immediately goes to the root, home and current buffer's directory, respectively.
101   </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="encodings.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="files.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="reloading.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Character Encodings </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Reloading From Disk</td></tr></table></div></body></html>