.TH M3PATHPRINT 1 "Oct 19 1992"
.UC 4
.SH NAME
m3pathprint \- display contents of m3path

.SH SYNOPSIS
.B m3pathprint
.so ../../m3tk-toolframe.2.2/src/m3help_a.1
[
.B \-Directory 
.I dir
]
[
.B \-NOTransitiveClosure
]
.br
[
.B \-NOExpandMacros
]

.SH DESCRIPTION
\fIm3pathprint\fP prints the directories reachable from the \fIm3path\fP of the
given directory, which defaults to the current working directory,
one per line.  In normal operation, environment variables 
are expanded, and
the transitive closure of reachable directories is printed.  
However, options exist to suppress these expansions.
The transitive closure is performed on the graph defined as follows.  Each directory
forms a node in the graph. If a directory contains no \fIm3path\fP
file, then it is a leaf node. Otherwise there are edges from the
directory node to the nodes representing the directories that
are listed in the \fIm3path\fP file. The transitive closure
is computed breadth-first, which thus defines an order
for the list considered as a search path. In the output
the directories are
listed in the order in which they will be searched.
.SH OPTIONS
.TP
.B \-NOTransitiveClosure
This option suppresses the computation of the transitive closure
of the \fim3path\fP graph. In the absence of the \fBNOExpandMacros\fP
the effect is thus to perform environment variable substitution
on the \fIm3path\fP file in the given directory, and
to append the directory containing the standard library interfaces.
.TP
.B \-NOExpandMacros
This option preserves any environment variables in the 
directory pathnames in the generated output.
.SH COPYRIGHT
.nf
.na
                     Copyright (C) Olivetti 1989 
                       
                         All Rights reserved                            
                                                                        
Use and copy of this software and preparation of derivative works based
upon this software are permitted to any person, provided this same
copyright notice and the following Olivetti warranty disclaimer are
included in any copy of the software or any modification thereof or
derivative work therefrom made by any person.
                                                                        
This software is made available AS IS and Olivetti disclaims all        
warranties with respect to this software, whether expressed or implied  
under any law, including all implied warranties of merchantibility and  
fitness for any purpose. In no event shall Olivetti be liable for any   
damages whatsoever resulting from loss of use, data or profits or       
otherwise arising out of or in connection with the use or performance   
of this software.    

             Copyright (C) 1990 Digital Equipment Corporation 
                        All Rights reserved      
                  See the file COPYRIGHT for details