File: aenf.1

package info (click to toggle)
aegis3 3.29-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 14,672 kB
  • ctags: 6,449
  • sloc: ansic: 107,353; sh: 34,849; makefile: 13,639; yacc: 3,960; awk: 344
file content (146 lines) | stat: -rw-r--r-- 3,586 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
'\" t
.\"	aegis - project change supervisor
.\"	Copyright (C) 1991, 1992, 1993, 1996, 1998, 1999, 2000 Peter Miller;
.\"	All rights reserved.
.\"
.\"	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 2 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, write to the Free Software
.\"	Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
.\"
.\" MANIFEST: manual entry for 'aegis -New_File' command
.\"
.so z_name.so
.TH "\*(n) -New_File" 1 \*(N) "Reference Manual"
.SH NAME
\*(n) -New_File \- add new files to be created by a change
.XX "aenf(1)" "add new files to be created by a change"
.SH SYNOPSIS
.B \*(n)
.B -New_File
.IR file-name ...
[
.IR option ...
]
.br
.B \*(n)
.B -New_File
.B -List
[
.IR option ...
]
.br
.B \*(n)
.B -New_File
.B -Help
.SH DESCRIPTION
The
.I \*(n)
.I -New_File
command is used to
add new files to a change.
The named files will be
added to the list of files in the change.
.PP
For each file named,
a new file is created in the development directory,
if it does not exist already.
If the file already exists,
it will not be altered.
.PP
If you name a directory on the command line, the entire directory tree
will be search for new files.  (Note: absolutely everything will be added,
including dot files and binary files, so you will need to clean out any
junk first.)
.so z_template.so
.so z_filesize.so
.so z_intuit.so
.so z_test_corr.so
.SH OPTIONS
The following options are understood
.TP 8n
.B -Build
.br
This option may be used to specify that the file is constructed
during a build (often only an integrate build),
so that history of it may be kept.
This is useful for generating patch files,
where a history of generated files is important.
Files created in this way may not be copied into a change,
though they may be deleted.
Avoid using files of this type,
if at all possible.
.so o_baserel.so
.so o_change.so
.so o_help.so
.so o_list.so
.so o_nolog.so
.so o_project.so
.so o_template.so
.so o_terse.so
.so o_verbose.so
.so o_wait.so
.so o__rules.so
.SH RECOMMENDED ALIAS
The recommended alias for this command is
.nf
.ta 8n 16n
csh%	alias aenf '\*(n) -nf \e!* -v'
sh$	aenf(){\*(n) -nf "$@" -v}
.fi
.SH ERRORS
It is an error if
the change is not in the
.I "being developed"
state.
.br
It is an error if
the change is not assigned to the current user.
.br
It is an error if
the file is already part of the change.
.br
It is an error if
the file is already part of the baseline.
.br
It is an error if the files named on the command line are not normal
files and not directories.  (If you need symbolic links or special files,
create them at build time.)
.so z_exit.so
.br
.ne 1i
.SH SEE ALSO
.TP 8n
.IR aecp (1)
copy files into a change
.TP 8n
.IR aedb (1)
begin development of a change
.TP 8n
.IR aemv (1)
rename a file as part of a change
.TP 8n
.IR aenfu (1)
remove new files from a change
.TP 8n
.IR aent (1)
add new tests to a change
.TP 8n
.IR aerm (1)
add files to be deleted by a change
.TP 8n
.IR aepconf (5)
project configuration file format
.TP 8n
.IR aeuconf (5)
user configuration file format
.so z_cr.so