Introduction
This plugin allows you to search within a filesystem for any files that match
a given filter.
Features
- Search within any VFS supported by jEdit.
- Recursive searches through filesystems.
- Integrated with jEdit's own file browser - via plugin menu
- Supports multiple search result sets
- Able to copy search results to jEdit clipboard
Change Log
Sept 9 2008: 1.1
- Removed gnu.regexp dependency
- Clear button on results window closes after clearing
- Code cleanup
Mar 23 2004: 1.0
- Added optional dependency for Archive 0.4 (requires jedit >= 4.2pre11)
- Version number updated to reflect stable release.
Jan 20 2004: 0.4
- Fixed bug where launching a hypersearch from a result set didn't maintain
the "recurse sub-directories" option.
Nov 18 2003: 0.3
- Added option to automatically open search results
- Uses the proper SearchDialog if using 4.2pre7 or later
- Results' path can be hidden, just showing the filename
- Results can be sorted by path or by filename
Nov 06 2003: 0.2
- Renamed plugin to FindFile
- Added more configuration options
- Added 'Search in file' option to file context menu
Nov 03 2003: 0.1
Usage
Performing a search
There are two ways to launch a search:
- From the plugins menu of the file system browser, select 'Search for files...'
- From the toolbar of the FindFile Results dockable pane.
Launching a search will open the FindFile dialog.
- Search options:
- Path - the root of the search.
- Filter - the filter to search on.
- Search Subdirectories - select whether to do a recursive search
The results appear in the FindFile Results pane, where further actions can be applied.
Working with results
The pane displays the results in a similar manner to the Hypersearch Results.
Each search is listed as a parent node, with the results as children.
Right-clicking on a search (ie parent node) provides the following options:
- Open all files - attemps to open the files in jEdit. It will only open
files that have a recognisable file extension, based on the installed edit modes.
This can be disabled from the options pane.
- Close all files
- Copy results - copies the results to the clipboard, so they can be pasted into a buffer.
- Remove search - removes this search from the tree
Clicking on a result will switch to that file, if it is already open in a buffer.
Double-Clicking on a result will attempt to open the file if it is not already open, or alternatively
close it if it is. As with the 'Open all' option, it will only allowed recognisable file extensions
to be opened unless that feature has been disabled.
Right-clicking on a result provides the following options:
- Open
- Close
- Copy Path - copies the files complete path to the clipboard
- Browse file's path - opens the file's path in the file system browser
- Browse file as archive - this option is only available if a VFS other than
org.gjt.sp.jedit.io.UrlVFS
(the default) is installed for the 'archive'
protocol. The Archive plugin provides a suitable set of protocols to enable this option.
- Search in file - allows a simple text search within the file. The results are displayed in
the HyperSearch results pane. This does not make use of the proper Search dialog - to be addressed.
Known bugs and issues
- Doesn't return all files meeting search criteria (specifically archives)?
Future development
There are a few tweaks I would like to make to this plugin, to make it look
and act more like hypersearch, and to make it a little more robust. Expect
most of these changes in the v1.2 release.
- Allow basic file operations, such as delete and rename.
- Add a user-definable list of extensions that may be opened (maybe just integrate use of HelperLauncher?)
- Make use of the proper Search dialog for searching in a file
- Code cleanup (from comments to analysing code and improving implementation)
- Change the search-time status (look like HyperSearch)
- Change search node wording style to HyperSearch style
- Modify dialog
- Change button names to Find, Close (change to default and exit buttons too)
- title bar icon?
- Add a "Choose..." button for a link to the File Browser
- Path label to "Directory"
- Settings fieldset
- Context menu
Feedback
Please send all feedback to the maintainer or original author mentioned in
the header.
Version
$Id: about.html,v 1.4 Mon Sep 22 16:35:41 CDT 2008 keeleyt83 Exp $