git.oblomov.eu Git - wine/blob - tools/widl/widl.man.in

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