Copyright Digital Equipment Corp. All rights reserved.

PRIVATE_and_PUBLIC

 Specify the accessibility of entities in a module.  (These
 attributes are also called accessibility attributes.)

 The PRIVATE and PUBLIC attributes can be specified in a type
 declaration statement or in a PRIVATE or PUBLIC statement, and take
 one of the following forms:

 Type Declaration Statement:

  type, [att-ls,] PRIVATE [,att-ls] :: ent [,ent]...
  type, [att-ls,] PUBLIC  [,att-ls] :: ent [,ent]...

 Statement:

  PRIVATE [[::] ent [,ent]...]
  PUBLIC  [[::] ent [,ent]...]

   type      Is a data type specifier.

   att-ls    Is an optional list of attribute specifiers.

   ent       Is one of the following:

             A variable name
             A procedure name
             A derived type name
             A named constant
             A namelist group name

             In statement form, an entity can also be
             a generic identifier (a generic name, 
             defined operator, or defined assignment).

 The PRIVATE and PUBLIC attributes can only appear in the scoping
 unit of a module.

 Only one PRIVATE or PUBLIC statement without an entity list is
 permitted in the scoping unit of a module; it sets the default
 accessibility of all entities in the module.

 If no PUBLIC or PRIVATE statements are specified in a module, the
 default is PUBLIC accessibility.  Entities with PUBLIC
 accessibility can be accessed from outside the module by means of a
 USE statement.

 If a derived type is declared PRIVATE in a module, its components
 are also PRIVATE.  The derived type and its components are
 accessible to any subprograms within the defining module through
 host association, but they are not accessible from outside the
 module.

 If the derived type is declared PUBLIC in a module, but its
 components are declared PRIVATE, any scoping unit accessing the
 module though use association (or host association) can access the
 derived-type definition, but not its components.

 If a module procedure has a dummy argument or a function result of
 a type that has PRIVATE accessibility, the module procedure must
 have PRIVATE accessibility.  If the module has a generic
 identifier, it must also be declared PRIVATE.

 If a procedure has a generic identifier, the accessibility of the
 procedure's specific name is independent of the accessibility of
 its generic identifier.  One can be declared PRIVATE and the other
 PUBLIC.

 The PRIVATE attribute is compatible with the ALLOCATABLE,
 DIMENSION, EXTERNAL, INTRINSIC, PARAMETER, POINTER, SAVE, STATIC,
 TARGET, and VOLATILE attributes.

 The PUBLIC attribute is compatible with the ALLOCATABLE, DIMENSION,
 EXTERNAL, INTRINSIC, PARAMETER, POINTER, SAVE, STATIC, TARGET, and
 VOLATILE attributes.

 EXAMPLES:

 The following examples show type declaration statements specifying
 the PUBLIC and PRIVATE attributes:

    REAL,  PRIVATE  :: A, B, C
    INTEGER, PUBLIC :: LOCAL_SUMS

 The following is an example of the PUBLIC and PRIVATE statements:

    MODULE SOME_DATA
      REAL ALL_B
      PUBLIC ALL_B
      TYPE RESTRICTED_DATA
        REAL LOCAL_C
        DIMENSION LOCAL_C(50)
      END TYPE RESTRICTED_DATA
      PRIVATE RESTRICTED_DATA
    END MODULE

 The following derived-type declaration statement indicates that the
 type is restricted to the module:

    TYPE, PRIVATE  :: DATA
      ...
    END TYPE DATA

 The following example shows a PUBLIC type with PRIVATE components:

    MODULE MATTER
      TYPE ELEMENTS
        PRIVATE
        INTEGER C, D
      END TYPE
    ...
    END MODULE MATTER

 In this case, components C and D are private to type ELEMENTS, but
 type ELEMENTS is not private to MODULE MATTER.  Any program unit
 that uses the module MATTER, can declare variables of type
 ELEMENTS, and pass as arguments values of type ELEMENTS.