2005-10-06 18:10:01 +02:00
|
|
|
.\" -*- nroff -*-
|
|
|
|
|
.TH WIDL 1 "October 2005" "@PACKAGE_STRING@" "Wine Developers Manual"
|
2004-03-09 04:49:39 +01:00
|
|
|
.SH NAME
|
|
|
|
|
widl \- Wine Interface Definition Language Compiler
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.BR "widl "\fI[options]\fR " \fIinfile.idl\fR"
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.B widl
|
|
|
|
|
is a Wine tool which purpose is to compile Interface Definition Language (IDL) files.
|
|
|
|
|
.PP
|
|
|
|
|
.SH OPTIONS
|
|
|
|
|
.B Help mode:
|
|
|
|
|
.nf
|
|
|
|
|
No options are used.
|
|
|
|
|
The program prints the help info and then exits.
|
|
|
|
|
.PP
|
|
|
|
|
.B General options:
|
2005-10-06 13:40:43 +02:00
|
|
|
.IP "\fB-V\fR"
|
2004-03-09 04:49:39 +01:00
|
|
|
Print version number and exits from the program.
|
|
|
|
|
.PP
|
|
|
|
|
.B Header options:
|
2005-10-06 13:40:43 +02:00
|
|
|
.IP "\fB-h\fR"
|
2005-01-26 20:40:47 +01:00
|
|
|
Generate header files.
|
2004-03-09 04:49:39 +01:00
|
|
|
.IP "\fB-H \fIfile\fR"
|
2004-10-05 06:44:20 +02:00
|
|
|
Name of header file to generate. The default header
|
2004-03-09 04:49:39 +01:00
|
|
|
filename is infile.h.
|
2006-04-22 21:52:51 +02:00
|
|
|
.IP "\fB--oldnames\fR"
|
|
|
|
|
Use old naming conventions.
|
2004-10-05 06:44:20 +02:00
|
|
|
.PP
|
2005-01-26 20:40:47 +01:00
|
|
|
.B Type library options:
|
|
|
|
|
.IP \fB-t\fR
|
|
|
|
|
Generate a type library.
|
|
|
|
|
.IP "\fB-T \fIfile\fR"
|
|
|
|
|
Define the name of the type library to be generated.
|
|
|
|
|
The default filename is infile.tlb.
|
|
|
|
|
.PP
|
2006-09-13 23:43:36 +02:00
|
|
|
.B UUID file options:
|
|
|
|
|
.IP "\fB-u\fR"
|
|
|
|
|
Generate a UUID file.
|
|
|
|
|
.IP "\fB-U \fIfile\fR"
|
|
|
|
|
Define the name of the UUID file to be generated.
|
|
|
|
|
The default filename is infile_i.c.
|
|
|
|
|
.PP
|
2005-04-15 16:09:27 +02:00
|
|
|
.B Proxy/stub generation options:
|
2005-10-06 13:40:43 +02:00
|
|
|
.IP "\fB-c\fR"
|
2005-04-15 16:09:27 +02:00
|
|
|
Generate client stub.
|
2005-10-06 13:40:43 +02:00
|
|
|
.IP "\fB-C \fIfile\fR"
|
2005-04-15 16:09:27 +02:00
|
|
|
Name of client stub file (default is infile_c.c)
|
2006-06-01 16:40:31 +02:00
|
|
|
.IP "\fB-p\fR"
|
2005-04-15 16:09:27 +02:00
|
|
|
Generate proxy.
|
2005-10-06 13:40:43 +02:00
|
|
|
.IP "\fB-P \fIfile\fR"
|
2005-04-15 16:09:27 +02:00
|
|
|
Name of proxy file (default is infile_p.c)
|
2005-10-06 13:40:43 +02:00
|
|
|
.IP "\fB-s\fR"
|
2005-04-15 16:09:27 +02:00
|
|
|
Generate server stub.
|
2005-10-06 13:40:43 +02:00
|
|
|
.IP "\fB-S \fIfile\fR"
|
2005-04-15 16:09:27 +02:00
|
|
|
Name of server stub file (default is infile_s.c)
|
|
|
|
|
.PP
|
2004-10-05 06:44:20 +02:00
|
|
|
.B Preprocessor options:
|
2004-03-09 04:49:39 +01:00
|
|
|
.IP "\fB-I \fIpath\fR"
|
|
|
|
|
Add a header search dir to path. Multiple search
|
|
|
|
|
dirs are allowed.
|
|
|
|
|
.IP "\fB-D \fIid[=val]\fR"
|
|
|
|
|
Define preprocessor identifier id value.
|
2005-10-06 13:40:43 +02:00
|
|
|
.IP "\fB-E\fR"
|
2004-03-09 04:49:39 +01:00
|
|
|
Preprocess only.
|
2005-10-06 13:40:43 +02:00
|
|
|
.IP "\fB-N\fR"
|
2004-03-09 04:49:39 +01:00
|
|
|
Do not preprocess input.
|
|
|
|
|
.PP
|
|
|
|
|
.B Debug options:
|
2005-10-06 13:40:43 +02:00
|
|
|
.IP "\fB-W\fR"
|
2004-03-09 04:49:39 +01:00
|
|
|
Enable pedantic warnings.
|
|
|
|
|
.IP "\fB-d \fIn\fR"
|
|
|
|
|
.nf
|
|
|
|
|
Set debug level to n.
|
|
|
|
|
n may be '0x01', '0x02', '0x04', '0x08', '0x10' or '0x20'.
|
|
|
|
|
(See section \fBDebug\fR)
|
|
|
|
|
.PP
|
|
|
|
|
.SH Debug
|
|
|
|
|
Debug level 'n' is a bitmask with the following meaning:
|
|
|
|
|
* 0x01 Tell which resource is parsed (verbose mode)
|
|
|
|
|
* 0x02 Dump internal structures
|
|
|
|
|
* 0x04 Create a parser trace (yydebug=1)
|
|
|
|
|
* 0x08 Preprocessor messages
|
|
|
|
|
* 0x10 Preprocessor lex messages
|
|
|
|
|
* 0x20 Preprocessor yacc trace
|
|
|
|
|
.SH BUGS
|
|
|
|
|
Typelib generation doesn't work at the moment. It is still under development.
|
|
|
|
|
.SH AUTHORS
|
|
|
|
|
.B widl
|
|
|
|
|
was written by Ove Kaaven. This man page was written by Hannu
|
|
|
|
|
Valtonen.
|
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
The Winelib User Guide
|
|
|
|
|
.nf
|
|
|
|
|
The Wine Developers Guide
|
