9.0;dialog, revision 9.0, 85/05/29
DIALOG -- Translate a DOMAIN/Dialogue description file.
usage:
DIALOG [descriptionfile_pathname]
[-D file.dpd|-ND]
[-B file_dpd.bin|-NB]
[-P file.ins.pas|-NP]
[-C file.ins.c|-NC]
[{-FI file.ins.ftn | -FM file_f77_init.ftn} | -NF]
FORMAT
DIALOG descriptionfile_pathname ... [options]
DIALOG translates a textual description file into a binary description file, a
binary description object module, insert files for Pascal, C, and FORTRAN, and
a FORTRAN initialization module. The textual description must have the file
extension ".dps". (If it doesn't, ".dps" is appended.) DIALOG gives the binary
description a ".dpd" extension and the binary object module a "_dpd.bin"
extension.
ARGUMENTS
descriptionfile_pathname
(required) Specify the description file to be translated.
Default if omitted: No translation takes place.
OPTIONS
DIALOG derives the name of the binary description file and the binary
description object module from the name used in the "USER_INTERFACE" part of
the .dps file. The following options let you specify other names or suppress
generation of the files.
-D Specify a name for the binary description file. It should
have the ".dpd" extension. If it doesn't, ".dpd" is
appended.
-ND Translate the description file without generating a binary
description.
-B Specify a name for the binary description object module.
It should have a "_dpd.bin" extension. If it doesn't,
"_dpd.bin" is appended.
-NB Translate the description file without generating a binary
description object module.
Dialog derives names for the insert files and the FORTRAN initialization
module from the name given in the "APPLICATION_INTERFACE" part of the .dps
file. The following options let you specify other names or suppress the
generation of files.
-P file.ins.pas
Specify a name for the Pascal insert file. The name should
have an ".ins.pas" extension. If it doesn't, ".ins.pas" is
appended.
-NP Suppress generation of the Pascal insert file.
-C file.ins.c
Specify a name for the C insert file. The name should have
an ".ins.c" extension. If it doesn't, ".ins.c" is appended.
-NC Suppress generation of the C insert file.
-FI file.ins.ftn
Specify a name for the FORTRAN insert file. The name
should have an ".ins.ftn" extension. If it doesn't,
".ins.ftn" is appended.
-FM file_f77_init.ftn
Specify a name for the FORTRAN initialization module. It
should have an "_f77_init.ftn" extension. If it doesn't,
"_f77_init.ftn" is appended.
-NF Suppress generation of the FORTRAN insert file and the
initialization module.
EXAMPLES
1. $ dialog test Translate the file "test.dps". Dialog
generates a binary description file and
a binary description object module with
names derived from the "USER_INTERFACE"
part of "test.dps". Dialog also creates
insert files in Pascal, FORTRAN and C
and a FORTRAN initialization module. The
names for these files are derived from the
name given for the "APPLICATION_INTERFACE"
part of "test.dps".
2. $ dialog test -d bar Translate the file "test.dps", and
name the binary description "bar".
(Dialog appends the extension ".dpd"
so the binary is named "bar.dpd".)
3. $ dialog test -np -nf Translate the file "test.dps". Suppress
generation of the Pascal and FORTRAN
insert files and the FORTRAN initialization
module.
4. $ dialog test -np -nc -fm mytest
Translate the file "test.dps". Suppress
generation of the Pascal and C insert files.
Name the FORTRAN initialization module
"mytest_f77_init.ftn".