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 .IP "\fB--oldnames\fR"
  28 Use old naming conventions.
  29 .PP
  30 .B Type library options:
  31 .IP \fB-t\fR
  32 Generate a type library.
  33 .IP "\fB-T \fIfile\fR"
  34 Define the name of the type library to be generated.
  35 The default filename is infile.tlb.
  36 .PP
  37 .B Proxy/stub generation options:
  38 .IP "\fB-c\fR"
  39 Generate client stub.
  40 .IP "\fB-C \fIfile\fR"
  41 Name of client stub file (default is infile_c.c)
  42 .IP "\fB-p\fR"
  43 Generate proxy.
  44 .IP "\fB-P \fIfile\fR"
  45 Name of proxy file (default is infile_p.c)
  46 .IP "\fB-s\fR"
  47 Generate server stub.
  48 .IP "\fB-S \fIfile\fR"
  49 Name of server stub file (default is infile_s.c)
  50 .PP
  51 .B Preprocessor options:
  52 .IP "\fB-I \fIpath\fR"
  53 Add a header search dir to path. Multiple search
  54 dirs are allowed.
  55 .IP "\fB-D \fIid[=val]\fR"
  56 Define preprocessor identifier id value.
  57 .IP "\fB-E\fR"
  58 Preprocess only.
  59 .IP "\fB-N\fR"
  60 Do not preprocess input.
  61 .PP
  62 .B Debug options:
  63 .IP "\fB-W\fR"
  64 Enable pedantic warnings.
  65 .IP "\fB-d \fIn\fR"
  66 .nf
  67 Set debug level to n.
  68 n may be '0x01', '0x02', '0x04', '0x08', '0x10' or '0x20'.
  69 (See section \fBDebug\fR)
  70 .PP
  71 .SH Debug
  72 Debug level 'n' is a bitmask with the following meaning:
  73     * 0x01 Tell which resource is parsed (verbose mode)
  74     * 0x02 Dump internal structures
  75     * 0x04 Create a parser trace (yydebug=1)
  76     * 0x08 Preprocessor messages
  77     * 0x10 Preprocessor lex messages
  78     * 0x20 Preprocessor yacc trace
  79 .SH BUGS
  80 Typelib generation doesn't work at the moment. It is still under development.
  81 .SH AUTHORS
  82 .B widl
  83 was written by Ove Kaaven. This man page was written by Hannu
  84 Valtonen.
  85 .SH "SEE ALSO"
  86 The Winelib User Guide
  87 .nf
  88 The Wine Developers Guide