# xfind(3)

[Home] [Commands] [Variables] [Macro-Dev] [Glossary]

## NAME

xfind - Execute find command
%xfind-com - Find command line

## SYNOPSIS

n xfind "base-path" "file-search"

%xfind-com "string"; Default is "`find`"

## DESCRIPTION

xfind executes the find(1) command with the command line set by the %xfind-com(5) variable and the user supplied base-path and file-search regular expression. The output of the command is piped into the *find* buffer.

If an argument is given then a pipe-shell-command(2) is used instead of ipipe-shell-command(2), this is useful when used in macros as it ensures that find has finished before the command returns.

The find command is specified by the macro variable %xfind-com if not defined the default `find` is used. The command line run by xfind is

%xfind-com -name "base-path" -name "file-search" -print

The resultant files found are displayed in the *find* buffer and may be selected by double-clicking with the mouse left button or selecting the line with a `<RETURN>`. The selected file under the cursor is loaded.

## EXAMPLE

The xfind command does not typically need to be set up in UNIX environments. In the Microsoft Windows environment then the UNIX tools for Windows are recommended, available from:

http://unxutils.sourceforge.net/

The xfind command may be set up in the startup files as follows:-

    set-variable %xfind-com "c:/usr/local/wbin/find.exe"

## SEE ALSO

%xgrep-com(5), find(1), find(3), grep(3), get-next-line(2), grep(1), xfind(3), xgrep(3), rgrep(3).

(c) Copyright JASSPA 2009
Last Modified: 2009/08/29
Generated On: 2009/10/12

</HMTL>