Rewrote the collapsing of . and .. in RtlGetFullPathName_U for better
[wine/multimedia.git] / tools / widl / widl.man
blobc65bd7e80ca13fb8d233654569e9f092bb095b8e
1 .TH WIDL 1 "March 2004" "Wine Manpage" "Wine Developers Manual"
2 .SH NAME
3 widl \- Wine Interface Definition Language Compiler
4 .SH SYNOPSIS
5 .BR "widl "\fI[options]\fR " \fIinfile.idl\fR"
6 .SH DESCRIPTION
7 .B widl 
8 is a Wine tool which purpose is to compile Interface Definition Language (IDL) files.
9 .PP
10 .SH OPTIONS
11 .B Help mode:
12 .nf
13 No options are used.
14 The program prints the help info and then exits.
15 .PP
16 .B General options:
17 .IP \fB-t\fR
18 Only generate a type library.
19 .IP "\fB-T \fIfile\fR"
20 Define the name of the type library to be generated. 
21 The default filename is infile.tlb.
22 .IP \fB-V\fR
23 Print version number and exits from the program.
24 .PP
25 .B Header options:
26 .IP \fB-b\fR
27 Make headers compatible with ICOM macros.
28 .IP \fB-h\fR
29 Only generate header files.
30 .IP "\fB-H \fIfile\fR"
31 Name of header file to include. The default header
32 filename is infile.h.
33 .IP "\fB-I \fIpath\fR"
34 Add a header search dir to path. Multiple search 
35 dirs are allowed.
36 .PP
37 .B Preprocessor options:
38 .IP "\fB-D \fIid[=val]\fR"
39 Define preprocessor identifier id value.
40 .IP \fB-E\fR
41 Preprocess only.
42 .IP \fB-N\fR
43 Do not preprocess input.
44 .PP
45 .B Debug options:
46 .IP \fB-W\fR
47 Enable pedantic warnings.
48 .IP "\fB-d \fIn\fR"
49 .nf
50 Set debug level to n. 
51 n may be '0x01', '0x02', '0x04', '0x08', '0x10' or '0x20'.
52 (See section \fBDebug\fR)
53 .PP
54 .SH Debug
55 Debug level 'n' is a bitmask with the following meaning:
56     * 0x01 Tell which resource is parsed (verbose mode)
57     * 0x02 Dump internal structures
58     * 0x04 Create a parser trace (yydebug=1)
59     * 0x08 Preprocessor messages
60     * 0x10 Preprocessor lex messages
61     * 0x20 Preprocessor yacc trace
62 .SH BUGS
63 Typelib generation doesn't work at the moment. It is still under development.
64 .SH AUTHORS
65 .B widl
66 was written by Ove Kaaven. This man page was written by Hannu
67 Valtonen.
68 .SH "SEE ALSO"
69 The Winelib User Guide
70 .nf
71 The Wine Developers Guide