<commit_before>.TH FINDIN 1 
.SH NAME
findin -- find files in PATH or other lists of directories
.SH SYNOPSIS
Find ls in PATH, find a glob(3) expression under MANPATH directories, or search directories passed via standard input:

.B $ findin ls

.B $ findin -q 'man*' MANPATH

.B $ (echo /bin; echo /sbin) | findin 'l*' -
.SH "DESCRIPTION"
Returns zero if files found; otherwise some non-zero value on error or if no files are matched. Files found will be printed to standard output. Errors or usage information will be printed to standard error.

The -? or -h options will show usage information. The -q option will mask what usually are just false alarms from glob(3).
.SH ERRORS
Diagnostics or usage notes are printed to standard error. sysexits(3) exit codes are used where possible, though a 1 will be returned if nothing is found.
.SH ENVIRONMENT
PATH is used by default; any arbitrary colon-delimited environment variable can be used if specified as the second argument to the program. Note that certain environment variables are not exported to child processes. For example, the Z-Shell does not export FPATH, as that is internal to the ZSH completion system.

.B $ export FPATH; findin _mplayer FPATH

Directories passed via standard input must be specified one per line. Returning to the Z-Shell $fpath example, another solution would be:

.B $ echo $fpath | tr ' ' '\\\\n' | findin _mplayer -

.SH "SEE ALSO"
find(1), findup(1), glob(3), sysexits(3)
.SH BUGS
No known issues.
.SH AUTHOR
<NAME><commit_msg>Example alternative to findin using zsh expressions.<commit_after>.TH FINDIN 1 
.SH NAME
findin -- find files in PATH or other lists of directories
.SH SYNOPSIS
Find ls in PATH, find a glob(3) expression under MANPATH directories, or search directories passed via standard input:

.B $ findin ls

.B $ findin -q 'man*' MANPATH

.B $ (echo /bin; echo /sbin) | findin 'l*' -
.SH "DESCRIPTION"
Returns zero if files found; otherwise some non-zero value on error or if no files are matched. Files found will be printed to standard output. Errors or usage information will be printed to standard error.

The -? or -h options will show usage information. The -q option will mask what usually are just false alarms from glob(3).
.SH ERRORS
Diagnostics or usage notes are printed to standard error. sysexits(3) exit codes are used where possible, though a 1 will be returned if nothing is found.
.SH ENVIRONMENT
PATH is used by default; any arbitrary colon-delimited environment variable can be used if specified as the second argument to the program. Note that certain environment variables are not exported to child processes. For example, the Z-Shell does not export FPATH, as that is internal to the ZSH completion system.

.B $ export FPATH; findin _mplayer FPATH

Directories passed via standard input must be specified one per line. Returning to the Z-Shell $fpath example, another solution would be:

.B $ echo $fpath | tr ' ' '\\\\n' | findin _mplayer -

.SH "SEE ALSO"
find(1), findup(1), glob(3), sysexits(3)

Using the Z-Shell (zsh), this utility can be replaced with expressions such as:

.B % print -l ${^fpath}/_mplayer

.B % print -l ${^path}/*cpu*(N)

.SH BUGS
No known issues.
.SH AUTHOR
<NAME>
{'fraction_non_alphanumeric': 0.07329192546583851, 'fraction_numerical': 0.0055900621118012426, 'mean_word_length': 3.970679012345679, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2833533', 'n_tokens_mistral': 943, 'n_tokens_neox': 908, 'n_words': 500}