Table of Contents
newp - create a new PRECS product newp
}
Copyright (C) 1995 University of Kansas. All rights reserved.
Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of Kansas University not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. Kansas University makes no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.
newp creates a new PRECS product. A PRECS product contains one or more files in one or more directories. The file-related options for newp correspond to options for how the slist that is to be created will be checked into the Version Database. The current directory is made into the top level directory for the new product. - -pVDB_path
- uses VDB_path as the directory to store the PRECS files for the top level of the new product. If the directory does not exist, it is created. If this option is not specified, a directory with the name of the new product is created in the same directory as the mapfile (as specified by the MAP_VAR environment variable.)
- -k
- searches the working file for keyword values to determine its revision number, creation date, state, and author (see getf(1)), and assigns these values to the deposited revision, rather than computing them locally. It also generates a default login message noting the login of the caller and the actual checkin date. This option is useful for software distribution. A revision that is sent to several sites should be checked in with the -k option at these sites to preserve the original number, date, author, and state. The extracted keyword values and the default log message may be overridden with the options -d, -m, -s, -w, and any option that carries a revision number.
- -q
- quiet mode; diagnostic output is not printed. A revision that is not different from the preceding one is not deposited.
- -I
- interactive mode; the user is prompted and questioned even if the standard input is not a terminal.
- -d[date]
- uses date for the checkin date and time. The date is specified in free format as explained in getf(1). This is useful for lying about the checkin date, and for -k if no date is available. If date is empty, the working file's time of last modification is used.
- -M
- Set the modification time on any new working file to be the date of the retrieved revision. For example, newp -d -M does not alter f's modification time, even if f's contents change due to keyword substitution. Use this option with care; it can confuse make(1).
- -mmsg
- uses the string msg as the log message for all revisions checked in.
- -nname
- assigns the symbolic name name to the number of the checked-in revision. newf prints an error message if name is already assigned to another number.
- -Nname
- same as -n, except that it overrides a previous assignment of name.
- -sstate
- sets the state of the checked-in revision to the identifier state. The default state is Exp.
- -tfile
- writes descriptive text from the contents of the named file into the PRECS file, deleting the existing text. The file may not begin with -.
- -t-string
- Write descriptive text from the string into the PRECS file, deleting the existing text.
The -t option, in both its forms, has effect only during an initial checkin; it is silently ignored otherwise.
During the initial checkin, if -t is not given, newp obtains the text from standard input, terminated by end-of-file or by a line containing . by itself. The user is prompted for the text if interaction is possible; see -I.
For backward compatibility with older versions of RCS, a bare -t option is ignored.
- -wlogin
- uses login for the author field of the deposited revision. Useful for lying about the author, and for -k if no author is available.
- -Vn
- Emulate RCS version n. See getf(1) for details.
- RCSINIT
- options prepended to the argument list, separated by spaces. See getf(1) for details.
The exit status is zero if and only if all operations were successful. Authors: Robert Hill and Matthew Wallace $Id: precs/docs:newp.1 1.2 $
basics(1), newf (1), newg (1), gets (1), getf (1), getg (1), getp (1), edits (1), editf (1), editg (1), editp (1), deltas (1), deltaf (1), deltag (1), deltap (1), install(1) precs (1), precslog (1), liste (1), listf (1), listg (1), overview(1), prepf (1), prepp (1), precsintro (1), rmf (1), rmg (1), rmp(1), removing (1), setgroup (1), unedit (1), xprecs (1),
Table of Contents
www.fiveanddime.net