NAME

mkproject − make a project root directory

SYNOPSIS

mkproject [{+−}d] [{+−}N alias] [{+−}T type[,type ...]] projectname ... 

DESCRIPTION

Mkproject creates a directory called projectname.  The directory is known as a project root directory and is the focus for a project.  Standard entries, ‘.’, for the directory itself, ‘..’, for its parent, and ‘...’ for the project link directory, are made automatically.  After the directory has been created, mkproject prompts the user for a line describing the purpose of the project. 

If the name of the directory conflicts with an existing project, an alternative alias for the project may be specified via the −N option. However, even if this option is used, the name of the directory will be recognized as a project unless it is disguised as a regular pathname. For example, to create another project called ‘spms’ with alias ‘newspms’, type:

mkproject  −N newspms  ./spms

Mkproject may also be used to convert an existing regular directory to a project root directory. 

Mkproject requires write permission in the parent directory. 

OPTIONS

+dChange the description of an existing project. 

−dTurn off prompting for the description of a new project. 

+N alias
Change the alias of the project.

−N alias
Specify an alternative alias for a new project.

+T type
Add a type label to an existing project root directory. If the type label already exists but has a different priority, then it must be removed using the rmproject command. 

−T type
Specify a type label for a new project root directory.

FILES

...Project link directory. 
..._tempTemporary project link directory. 

LIMITATIONS

Project descriptions can be no longer than 128 characters. 

SEE ALSO

mkdir(1), rmproject(1P)

DIAGNOSTICS

The error message, “mkproject: project/... temporarily unavailable”, indicates that a ‘..._temp’ temporary project link directory exists. This could be because another user is altering the project link directory, or because a system crash terminated mkproject prematurely. If the latter case, then removing the temporary file will fix the problem. 

Exit status 0 is normal. Exit status 1 indicates an error. 

AUTHOR

Peter J. Nicklin

BUGS

The root project, ‘^’, cannot have an alternative alias. 

Directory aliases must not include the characters ‘:’ or ‘|’. 

Type labels must not include the characters ‘:’ or ‘/’.