PowerAda alibinit

From OC Systems Wiki!
Jump to: navigation, search


NAME

alibinit - initialize a sublibrary

SYNOPSIS

alibinit [-hF] [-L LibraryList | Sublibrary ]

DESCRIPTION

The alibinit command initializes a sublibrary. If the sublibrary already exists, alibinit initializes it, erasing any previous contents. If the sublibrary does not exist, it is created. If a sublibrary imports file, (or, if outside a project, a library list file), does not exist it is created.

If the sublibrary to be initialized has the same name as an existing file or sublibrary, alibinit prompts you for confirmation that you really want to initialize it. . Reply with "y", "ye", or "yes" if you want the initialization to proceed. You can prevent this prompting by using the -F option. alibinit will not overwrite an existing directory that is not a sublibrary.

OPTIONS

-h
Requests help for the command. If specified, all other options and parameters (except possibly erroneous ones) are ignored.
-F
Causes the alibinit command to initialize an existing sublibrary without prompting for confirmation. This option unlocks the sublibrary if necessary before initializing it. Otherwise you would need to run the compiler with the -u option.
-L LibraryList
Uses the first sublibrary name in the file LibraryList as the name of the sublibrary to create. If LibraryList does not exist, a file called alib.list is created, naming a single sublibrary adalib in the same directory.

PARAMETERS

Sublibrary
Creates the sublibrary Name. If the file Name.imports does not exist in the same directory, it is created. The Name.imports file is created by copying it from a parent project if it exists at the same project-relative path

FILES

$POWERADA/bin/alibinit - the alibinit program

RETURN CODES

Below is a list of the possible values returned by alibinit. Refer to Return Codes for Commands for details about the meaning of these returns.

0, 1, 2, 3, 99

ENVIRONMENT VARIABLES

POWERADA
This must be defined and indicate the powerada/ada95 directory in the PowerAda installation.

BUGS/LIMITATIONS

See Problems and Questions at the beginning of this Appendix.