'\"macro stdmacro
.if n .pH g1f.pathconv @(#)pathconv	40.11 of 12/15/89
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} pathconv 1F "Form and Menu Language Interpreter Utilities" "\&"
.if \nX=1 .ds x} pathconv 1F "Form and Menu Language Interpreter Utilities"
.if \nX=2 .ds x} pathconv 1F "" "\&"
.if \nX=3 .ds x} pathconv "" "" "\&"
.TH \*(x}
.SH NAME
\f4pathconv\f1 \- search FMLI criteria for filename
.SH SYNOPSIS
\f4pathconv\f1
[\f4\-f\f1\^] [\f4\-v\f1 \f2alias\f1] 
.br
\f4pathconv\f1
[\f4\-t\f1\^] [\f4-l\f1\^] [\f4-n\f2num\f1\^] [\f4\-v\f1 \f2string\f1] 
.SH DESCRIPTION
The \f4pathconv\f1 function converts an alias to its pathname.
By default, it takes the alias as a string from \f2stdin\f1.
.TP .5i
\f4-f\f1
If \f4-f\f1 is specified, the full path will be returned
(this is the default).
.TP
\f4\-t\f1
If \f4-t\f1 is specified, \f4pathconv\f1 will truncate a pathname specified in
\f2string\f1 in a format suitable for display as a frame title.
This format is a shortened version of the full pathname,
created by deleting components of the path from the middle
of the string until it is under \f4DISPLAYW - 6\f1 characters in length,
and then inserting elipses (\f4.\|.\|.\f1) between the remaining pieces.
Elipses are also used to show truncation at the ends of the strings if
necessary, unless the \f4-l\f1 option is given.
.RS .5i
.TP .5i
\f4-l\f1
If \f4-l\f1 is specified, \f4<\f1 and \f4>\f1 will be used instead of
elipses (\f4...\f1) to indicate truncation at the ends of the string
generated by the \f4-t\f1 option.
Using \f4-l\f1 allows display of the longest possible string while still
notifying users it has been truncated.
.TP
\f4-n\f2num\f1
If \f4-n\f1 is specified, \f2num\f1 is the maximum length of the string
(in characters)
generated by the \f4-t\f1 option.
The argument \f2num\f1 can be any integer from 1 to 255.
.RE
.TP
\f4\-v\f1 \f2arg\f1
If the \f4-v option is used,
then \f2alias\f1 or \f2string\f1 can be specified
when \f4pathconv\f1 is called.
The argument \f2alias\f1 must be an alias defined in the \f2alias_file\f1
named when \f4fmli\f1 was invoked.
The argument \f2string\f1 can only be used with the \f4-t\f1 option
and must be a pathname. 
.SH EXAMPLES
Here is a menu descriptor that uses \f4pathconv\f1 to construct
the menu title.
It searches for \f4MYPATH\f1 in the \f2alias_file\f1 named
when \f4fmli\f1 was invoked:
.PP
.RS
.nf
\f4menu=\(gapathconv \-v MYPATH/ls\(ga
   \&.
   \&.
   \&.\f1
.fi
.RE
.PP
where there is a line in \f2alias_file\f1 that defines \f4MYPATH\f1.
For example, \f4MYPATH=$HOME/bin:/usr/bin\f1.
.PP
Here is a menu descriptor that takes \f2alias\f1 from \f2stdin\f1.
.PP
.RS
.nf
\f4menu=\(gaecho MYPATH/ls | pathconv\(ga
   \&.
   \&.
   \&.\f1
.fi
.RE
.SH "SEE ALSO"
\f4fmli\f1.
.ig
BUILT-IN FMLI
..
.Ee
