.\" Man page generated from reStructuredText.
.
.TH PATHSPEC-RB 1 "2019" "" ""
.SH NAME
pathspec-rb \- Test pathspecs against a specific path
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.nf
pathspec\-rb [options] [subcommand] [path] <name> <path>
.fi
.sp
.SH DESCRIPTION
.sp
\fBpathspc\-rb\fP is a tool that accompanies the pathspec\-ruby library to help
you test what match results the library would find using path specs. You can
either find all specs matching a path, find all files matching specs, or
verify that a path would match any spec.
.SH SUB-COMMANDS
.nf
\fBspecs_match\fP Find all specs matching path
\fBtree\fP        Find all files under path matching the spec
\fBmatch\fP       Check if the path matches any spec
.fi
.sp
.SH OPTIONS
.nf
\fB\-f\fP | \fB\-\-file\fP <FILENAME>
    Load path specs from the file passed in as argument. If this option is
.in +2
not specified, \fBpathspec\-rb\fP defaults to loading \fB\&.gitignore\fP\&.
.in -2
.fi
.sp
.nf
\fB\-t\fP | \fB\-\-type\fP [\fBgit\fP|\fBregex\fP]
    Type of spec expected in the loaded specs file (see \fB\-f\fP option).
.in +2
Defaults to \fBgit\fP\&.
.in -2
.fi
.sp
.nf
\fB\-v\fP | \fB\-\-verbose\fP
    Only output if there are matches.
.fi
.sp
.SH EXAMPLES
.sp
Find all files ignored by git under your source directory:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ pathspec\-rb tree src/
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
List all spec rules that would match for the specified path:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ pathspec\-rb specs_match build/
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Check that a path matches at least one of the specs in a new version of a
gitignore file:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ pathspec\-rb match \-f .gitignore.new spec/fixtures/
.ft P
.fi
.UNINDENT
.UNINDENT
.SH AUTHOR
Gabriel Filion
.\" Generated by docutils manpage writer.
.