ADA.FMGR(1)

User Commands

26 (Section 1) - 3 - HP-UX Release 7.0: September 1989

ADA.FORMAT(l) Series 300 Only (Requires Optional Ada Software) ADA.FORMAT(1)

NAME

ada.format - Ada source program formatter SYNOPSIS

ada. format [ -c I -i I -s ] [ -k ] [ -m ] [ -p ] [ -t n ] file Remarks:

This command requires installation of optional Ada software (not included with the standard HP-UX operating system) before it can be used.

DESCRIPTION

Ada.format takes an Ada source file and produces a listing of the formatted source on the stan-dard output. Ada.format requires the source file suffix to be . ad?, where ? is any single alphanumeric character. If the source contains any syntax errors, ada.format terminates with a diagnostic error message and the line number indicating where the first error occurred. No list-ing of the formatted source is generated.

By default, ada.format formats the Ada source file according to the syntactic structure used in the Reference Manual for the Ada Programming Language. The extent and nature of the transforma-tions performed can be optionally controlled by specifying ada.format options and by using pragma INDENT within the source file to protect regions of source from being formatted.

The following options are recognized:

-c Capitalize the first letter of each word component (separated by underscore) of an identifier. By default, identifiers are converted to uppercase. Only one of the options -c, -i or -s may be selected.

-i All identifiers are converted to lowercase. By default, identifiers are converted to uppercase. Only one of the options -c, -i or -s may be selected.

- k All Ada keywords are converted to uppercase. By default, keywords are converted to lowercase.

-m Parameters of unspecified mode (by implication, mode in) are converted to explicit in parameters. Note that if either the specification or body of a unit is formatted with this option while the other is not, the compiler indicates that the two parameter specifications do not conform, according to the Reference Manual for the Ada Program-ming Language [6.3.1 (8)].

-p The source structure is preserved so that each source line is treated as an indivisible entity. The source structure is indented according to its lexical elements, but indivi-dual source lines are not restructured.

-s All of the identifiers are preserved as in the source file. By default, identifiers are converted to uppercase. Only one of the options -c, -i or -s may be selected.

-t n Use n spaces for indentation; legal range 2 .. 6, default 3.

Use of the pragma INDENT in the source file has the following effects:

pragma INDENT (OFF); Disable ada.format so that subsequent source lines are not formatted.

pragma INDENT (ON);

Environment Variables

Enable ada.format so that subsequent source lines are formatted.

The environment variable ADA_PATH is associated with all components of the Ada compila-tion system. It must be set properly and exported before any component of the Ada compila-tion system (including ada.format) can be used (see ada(l), Environment Variables).

ADA.FORMAT(1) Series 300 Only (Requires Optional Ada Software) ADA.FORMAT(1)

AUTHOR

Ada.format was developed by HP and Alsys.

FILES

$ADA_PATH/ada.format Ada source program formatter command.

$ADA_PATHjada.format.bin

Ada source program formatter subprocess.

SEE ALSO

ada(l), ada.fmgr(l), ada.format(l), ada.lmgr(l), ada.lsfam(l), ada.lslib(l), ada.mkfam(l), ada.mklib(l), ada.mvfam(l), ada.mvlib(l), ada.probe(l), ada.rmfam(l), ada.rmlib(l), ada.umgr(l), ada.unlock(l), ada.xref(l),

Ada User's Guide (Series 300).

EXTERNAL INFLUENCES

International Code Set Support

Single-byte character code sets are supported.

ada.make(l), ada.protect(l),

ADA.LMGR(1) Series 300 Only (Requires Optional Ada Software) ADA.LMGR(1)

NAME

ada.lmgr - create, examine, and modify an Ada library SYNOPSIS

ada.lmgr [ -I I -P I familyname ] Remarks:

This command requires installation of optional Ada software (not included with the standard HP-UX operating system) before it can be used.

DESCRIPTION

Libraries that are members of different families are normally invisible to each other and cannot access each other's units. There is one exception to this rule: libraries belonging to the

Manipulate libraries in the installation family.

Manipulate libraries in the public family.

Ada.lmgr is an interactive tool that, when executed, prompts with "Library _Manager." Com-mands are then entered to examine or modify the contents of a library.

For the syntax and semantics of the commands, refer to the "Ada User's Guide," or use the available online help facility in the library manager.

The following commands can be typed in response to the "Library_Manager" prompt:

Default Set default values for commands.

Erase

Set global characteristics for commands.

Obtain help on the various ada.lmgr commands.

Read ada.lmgr commands from a file.

List the Ada libraries in an Ada family.

Create a new Ada library.

Change the current family.

Mark the current library as either read-only or update-allowed.

Leave ada.lmgr.

ADA.LMGR(l) Series 300 Only (Requires Optional Ada Software) ADA.LMGR(1)

The help command provides online help for all commands.

If the file .ada.lmgrrc exists in the user's home directory, its commands are executed before the first prompt is issued.

If the file .ada.lmgrdf exists in the user's home directory, its commands are executed after those in .ada.lmgrrc (if present) and before the first prompt is issued. The commands in this file are DEFAULT commands saved automatically by the use of the DEFAULTS => KEEP parameter of the QUIT command.

Environment Variables

The environment variable ADA_PATH is associated with all components of the Ada tion system. It must be set properly and exported before any component of the Ada compila-tion system (including ada.lmgr) can be used (see ada(l), Environment Variables).

Locks

To ensure the integrity of their internal data structures, Ada libraries and families are locked for the duration of operations that are performed on them. Normally Ada families are locked only briefly when libraries within them are manipulated. However, sometimes multiple Ada libraries must be locked for longer periods during a single operation. If more than one library must be locked for a single operation, at most one library is locked for updating and all other locked libraries are locked for read-only.

An Ada family or library locked for updating cannot be accessed in any way by any part of the Ada compilation system except by the locking agent. However, an Ada family or library locked for reading can be accessed by any part of the Ada compilation system for read-only purposes.

If ada.lmgr cannot obtain a lock after a suitable number of retries, it displays an informational message and terminates.

Under some circumstances, an Ada family or Ada library may be locked, but the locking program(s) may have terminated (for example, due to system crash or network failure). If you determine that the Ada family or Ada library is locked but should not be locked, you can remove the lock.

Use ada.unlock(l) to unlock an Ada library and ada.funlock(l) to unlock an Ada family. How-ever, unlocking should be done with care. If an Ada family or Ada library is actually locked by a tool, unlocking it permits access by other tools that might find the contents invalid or might damage the Ada family or Ada library.

AUTHOR

FILES

Ada.lmgr was developed by HP and Alsys.

$HOMEj.ada.lmgrrc User start up commands.

$HOME/.ada.lmgrdf User start up defaults.

$ADA_PATH/ada.lmgr Ada interactive library manager command.

$ADA_PATH/adacli Ada command language interpreter.

$ADA_PATH/ada.mngrs.bin

Ada components manager subprocess.

$ADA_PATH/ada.lmgr.hlp

Ada library manager help command data.

$ADA_PATH/ada.lmgr.btl

Ada library manager command tables.

Dans le document HP-UX Reference (Page 48-53)