PageRenderTime 79ms CodeModel.GetById 23ms 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
Possible License(s): BSD-3-Clause, AGPL-1.0, Apache-2.0, LGPL-2.0, LGPL-3.0, GPL-2.0, CC-BY-SA-3.0, LGPL-2.1, GPL-3.0, MPL-2.0-no-copyleft-exception, IPL-1.0 
    

  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. 

  2.    <span><b class="guimenu">Utilities</b></span>&gt;<span><b class="guimenuitem">File System
    3. 

  3.    Browser</b></span> displays the file system browser.
    4. 

  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. 

  5.   </p><p>
    6. 

  6.    The file system browser can be customized in the
    7. 

  7.    <span><b class="guimenu">Utilities</b></span>&gt;<span><b class="guimenuitem">Global Options</b></span>
    8. 

  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. 

  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. 

  10.     The directory to browse is specified in the <span><b class="guibutton">Path</b></span> text
    11. 

  11.     field. Clicking the mouse in the text field automatically selects its
    12. 

  12.     contents allowing a new path to be quickly typed in. If a relative path is
    13. 

  13.     entered, it will be resolved relative to the current path. This text field
    14. 

  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. 

  15.     The same list of previously browsed directories is also listed in the
    16. 

  16.     <span><b class="guimenu">Utilities</b></span>&gt;<span><b class="guisubmenu">Recent Directories</b></span>
    17. 

  17.     menu; selecting one opens it in the file system browser.
    18. 

  18.    </p><p>
    19. 

  19.     To browse a listed directory, double-click it (or if you have a three-button
    20. 

  20.     mouse, you can click the middle mouse button as well). Alternatively, click
    21. 

  21.     the disclosure
    22. 

  22.     widget next to a directory to list its contents in place.
    23. 

  23.     To browse higher up in the directory hierarchy, double-click one of the parent
    24. 

  24.     directories in the parent directory list.
    25. 

  25.    </p><p>
    26. 

  26.     Files and directories in the file list are shown in different colors
    27. 

  27.     depending on what glob patterns their names match. The patterns and colors
    28. 

  28.     can be customized in the
    29. 

  29.     <span><b class="guibutton">File System Browser</b></span>&gt;<span><b class="guibutton">Colors</b></span>
    30. 

  30.     pane of the
    31. 

  31.     <span><b class="guimenu">Utilities</b></span>&gt;<span><b class="guimenuitem">Global Options</b></span>
    32. 

  32.     dialog box.
    33. 

  33.    </p><p>
    34. 

  34.     To see a specific set of files only (for example,
    35. 

  35.     those whose names end with <tt class="filename">.java</tt>), enter a glob pattern
    36. 

  36.     in the <span><b class="guibutton">Filter</b></span> text field.
    37. 

  37.     This text fields remembers previously entered strings.
    38. 

  38.     See <a href="globs.html" title="Appendix D. Glob Patterns">Appendix D, <i>Glob Patterns</i></a> for information about glob patterns.
    39. 

  39.    </p><p>
    40. 

  40.     Unopened files can be opened by double-clicking (or by
    41. 

  41.     clicking the middle mouse button). Open files have their names underlined,
    42. 

  42.     and can be selected by single-clicking.
    43. 

  43.     Holding down <tt class="keycap">Shift</tt>
    44. 

  44.     while opening a file will open it in a new view.
    45. 

  45.    </p><p>
    46. 

  46.     Clicking a file or directory with the right mouse button displays a popup
    47. 

  47.     menu containing various commands. 
    48. 

  48.    </p><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>
    49. 

  49.      The file list sorting algorithm used in jEdit handles numbers in file names
    50. 

  50.      in an intelligent manner. For example, a file named
    51. 

  51.      <tt class="filename">section10.xml</tt> will be placed after a file named
    52. 

  52.      <tt class="filename">section5.xml</tt>. A conventional letter-by-letter
    53. 

  53.      sort would have placed these two files in the wrong order.
    54. 

  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. 

  55.     The file system browser has a tool bar containing a number of buttons.
    56. 

  56.     Each item in the <span><b class="guibutton">Commands</b></span>
    57. 

  57.     menu (described below) except
    58. 

  58.     <span><b class="guimenuitem">Show Hidden Files</b></span> and
    59. 

  59.     <span><b class="guisubmenu">Encoding</b></span> has a corresponding tool bar button.
    60. 

  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. 

  61.     Clicking the <span><b class="guibutton">Commands</b></span> button displays a menu
    62. 

  62.     containing the following items:
    63. 

  63.    </p><div class="itemizedlist"><ul type="disc"><li><p><span><b class="guimenuitem">Parent Directory</b></span> - moves up in
    64. 

  64.     the directory hierarchy.</p></li><li><p><span><b class="guimenuitem">Reload Directory</b></span> - reloads the
    65. 

  65.     file list from disk.</p></li><li><p><span><b class="guimenuitem">Root Directory</b></span> - on Unix,
    66. 

  66.     goes to the root directory (<tt class="filename">/</tt>). On Windows and MacOS X,
    67. 

  67.     lists all mounted drives and network shares.</p></li><li><p><span><b class="guimenuitem">Home Directory</b></span> - displays your
    68. 

  68.     home directory.</p></li><li><p><span><b class="guimenuitem">Directory of Current Buffer</b></span> - displays the
    69. 

  69.     directory containing the currently active buffer.</p></li><li><p><span><b class="guimenuitem">New File</b></span> - opens new, empty,
    70. 

  70.     buffer in the current directory. The file will
    71. 

  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. 

  72.     directory after prompting for the desired name.</p></li><li><p><span><b class="guimenuitem">Search in Directory</b></span> -
    73. 

  73.     displays the search and
    74. 

  74.     replace dialog box set to search all files in the current directory. If a
    75. 

  75.     file is selected when this command is invoked, its extension becomes the
    76. 

  76.     file name filter for the search;
    77. 

  77.     otherwise, the file name filter entered in the browser is used.
    78. 

  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. 

  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. 

  80.     the character encoding to use when opening files. See
    81. 

  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. 

  82.     Clicking the <span><b class="guibutton">Plugins</b></span> button displays a menu
    83. 

  83.     containing plugin commands. For information
    84. 

  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. 

  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. 

  86.     Clicking the <span><b class="guibutton">Favorites</b></span> button displays a menu
    87. 

  87.     showing all files and directories in the favorites list. The
    88. 

  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. 

  89.     a file from the favorites, invoke
    90. 

  90.     <span><b class="guimenuitem">Edit Favorites</b></span>, which will show the favorites
    91. 

  91.     list in the file system view, then select <span><b class="guimenuitem">Delete</b></span>
    92. 

  92.     from the right-click menu of the entry you want to remove.
    93. 

  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. 

  94.     Completion behaves differently in file dialogs than in the stand-alone file system browser window.
    95. 

  95.    </p><p>
    96. 

  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. 

  97.    </p><p>
    98. 

  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. 

  99.    </p><p>
    100. 

  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. 

  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>
    102. 

  102.