.\"
.\"	aegis - project change supervisor
.\"	Copyright (C) 1997, 1998, 2004, 2006-2008 Peter Miller
.\"
.\"	This program is free software; you can redistribute it and/or modify
.\"	it under the terms of the GNU General Public License as published by
.\"	the Free Software Foundation; either version 3 of the License, or
.\"	(at your option) any later version.
.\"
.\"	This program is distributed in the hope that it will be useful,
.\"	but WITHOUT ANY WARRANTY; without even the implied warranty of
.\"	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\"	GNU General Public License for more details.
.\"
.\"	You should have received a copy of the GNU General Public License
.\"	along with this program. If not, see
.\"	<http://www.gnu.org/licenses/>.
.\"
.SS File Name Limitations
There are a number of controls available to limit the form of project
file names.  All of these controls may be found in the project
configuration
file, see
.IR aepconf (5)
for more information.
The most significant are briefly described here:
.TP 8n
maximum_filename_length = integer;
This field is used to limit the length of filenames.
All new files may not have path components longer than this.
Defaults to 255 if not set.
For maximum portability you should set this to 14.
.TP 8n
posix_filename_charset = boolean;
This field may be used to limit the characters allowed
in filenames to only those explicitly allowed by POSIX.
Defaults to
.I false
if not set, meaning whatever your operating system will tolerate,
except white space and high-bit-on characters.
For maximum portability you should set this to \fItrue\fP.
.TP 8n
dos_filename_required = boolean;
This field may be used to limit filenames so that they conform to
the DOS 8+3 filename limits and to the DOS filename character set.
Defaults to
.I false
if not set.
.TP 8n
windows_filename_required = boolean;
This field may be used to limit filenames so that they conform to the
Windows98 and WindowsNT filename limits and character set.  Defaults to
\fIfalse\fP if not set.
.TP 8n
shell_safe_filenames = boolean;
This field may be used to limit filenames so that they do not contain
shell special characters.  Defaults to
.I true
if not set.  If this field is set to
.IR false ,
you will need to use the
.I ${quote}
substitution around filenames in commands, to ensure that filenames
containing shell special characters do not have unintended side effects.
Weird characters in filenames may also confuse your dependency maintenance tool.
.TP
allow_white_space_in_filenames = boolean;
.RS
This field may be used to allow white space characters in file names.
This will allow the following characters to appear in file names:
backspace (BS, \eb, 0x08), horizontal tab (HT, \et, 0x09), new line
(NL, \en, 0x0A), vertical tab (VT, \ev, 0x0B), form feed (FF, \ef,
0x0C), and carriage return (CR, \er, 0x0D).
Defaults to false if not set.
.PP
Note that this field does not override other file name filters.
It will be necessary to explicitly set
\f[I]shell_\%safe_\%filenames = false\fP
as well.
It will be necessary to set
\f[I]dos_\%filename_\%required = false\fP
(the default) as well.
It will be necessary to set
\f[I]posix_\%filename_\%charset = false\fP
(the default) as well.
.PP
The user must take great care to use the ${quote} substitution around
all file names in commands in the project configuration.  And even
then, substitutions which expect a space separated list of file names
will have undefined results.
.RE
.TP
allow_non_ascii_filenames = boolean;
.RS
This field may be used to allow file names with non-ascii-printable
characters in them.  Usually this would mean a UTF8 or international
charset of some kind.
Defaults to false if not set.
.PP
Note that this field does not override other file name filters.
It will be necessary to explicitly set
\f[I]shell_\%safe_\%filenames = false\fP
as well.  It will be necessary to set
\f[I]dos_\%filename_\%required = false\fP
(the default) as well.
It will be necessary to set
\f[I]posix_\%filename_\%charset = false\fP
(the default) as well.
.RE
.TP 8n
filename_pattern_accept = [ string ];
This field is used to specify a list of patterns of acceptable filenames.
Defaults to "*" if not set.
.TP 8n
filename_pattern_reject = [ string ];
.br
This field is used to specify a list of patterns of unacceptable filenames.
.PP
.so z_filelocn.so