.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "SVN::Hooks::DenyFilenames 3pm"
.TH SVN::Hooks::DenyFilenames 3pm "2017-06-24" "perl v5.24.1" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
SVN::Hooks::DenyFilenames \- Deny some file names.
.SH "VERSION"
.IX Header "VERSION"
version 1.34
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
This SVN::Hooks plugin is used to disallow the addition of some file
names.
.PP
It's active in the \f(CW\*(C`pre\-commit\*(C'\fR hook.
.PP
It's configured by the following directives.
.SS "\s-1DENY_FILENAMES\s0(\s-1REGEXP,\s0 [\s-1REGEXP\s0 => \s-1MESSAGE\s0], ...)"
.IX Subsection "DENY_FILENAMES(REGEXP, [REGEXP => MESSAGE], ...)"
This directive denies the addition of new files matching the Regexps
passed as arguments. If any file or directory added in the commit
matches one of the specified Regexps the commit is aborted with an
error message telling about every denied file.
.PP
The arguments may be compiled Regexps or two-element arrays consisting
of a compiled Regexp and a specific error message. If a file matches
one of the lone Regexps an error message like this is produced:
.PP
.Vb 1
\&        DENY_FILENAMES: filename not allowed: filename
.Ve
.PP
If a file matches a Regexp associated with an error message, the
specified error message is substituted for the 'filename not allowed'
default.
.PP
Note that this directive specifies a default restriction. If there are
any \fB\s-1DENY_FILENAMES_PER_PATH\s0\fR directives (see below) being used, this
one is only used for files that don't match any specific rules there.
.PP
Example:
.PP
.Vb 4
\&        DENY_FILENAMES(
\&            qr/\e.(doc|xls|ppt)$/i, # ODF only, please
\&            [qr/\e.(exe|zip|jar)/i => \*(AqNo binaries, please!\*(Aq],
\&        );
.Ve
.SS "\s-1DENY_FILENAMES_PER_PATH\s0(\s-1REGEXP\s0 => \s-1REGEXP, REGEXP\s0 => [\s-1REGEXP\s0 => \s-1MESSAGE\s0], ...)"
.IX Subsection "DENY_FILENAMES_PER_PATH(REGEXP => REGEXP, REGEXP => [REGEXP => MESSAGE], ...)"
This directive is more specific than the \fB\s-1DENY_FILENAMES\s0\fR, because it
allows one to specify different restrictions in different regions of
the repository tree.
.PP
Its arguments are a sequence of rules, each one consisting of a
pair. The first element of each pair is a regular expression
specifying where in the repository this rule applies. It applies if
any file being added matches the regexp. The second element specifies
the restrictions that should be imposed, just like the arguments to
\&\fB\s-1DENY_FILENAMES\s0\fR.
.PP
The first rule matching an added file is used to check it. The
following rules aren't tried.
.PP
Only if no rules match a particular file will the restrictions defined
by \fB\s-1DENY_FILENAMES\s0\fR be imposed.
.PP
Example:
.PP
.Vb 5
\&        DENY_FILENAMES_PER_PATH(
\&            qr:/src/:   => [qr/[^\ew.\-]/ => \*(Aqsource files must be strict\*(Aq],
\&            qr:/doc/:   => qr/[^\ew\es.\-]/i, # document files allow spaces too.
\&            qr:/notes/: => qr/^$/,         # notes directory allows anything.
\&        );
.Ve
.SH "AUTHOR"
.IX Header "AUTHOR"
Gustavo L. de M. Chaves <gnustavo@cpan.org>
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
This software is copyright (c) 2016 by CPqD <www.cpqd.com.br>.
.PP
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.