From 21731d47ec0af6491b8822f4eb8182e9db6713c1 Mon Sep 17 00:00:00 2001
From: Hannu Valtonen <Hannu.Valtonen@hut.fi>
Date: Tue, 9 Mar 2004 03:49:39 +0000
Subject: [PATCH] Added a man page for widl.

---
 tools/widl/Makefile.in |  5 +--
 tools/widl/widl.man    | 71 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 74 insertions(+), 2 deletions(-)
 create mode 100644 tools/widl/widl.man

diff --git a/tools/widl/Makefile.in b/tools/widl/Makefile.in
index f7058132526..73c1bcd5a1c 100644
--- a/tools/widl/Makefile.in
+++ b/tools/widl/Makefile.in
@@ -39,10 +39,11 @@ y.tab.o: y.tab.h
 @LEX_OUTPUT_ROOT@.o: y.tab.h
 
 install:: $(PROGRAMS)
-	$(MKINSTALLDIRS) $(bindir)
+	$(MKINSTALLDIRS) $(bindir) $(mandir)/man$(prog_manext)
 	$(INSTALL_PROGRAM) widl$(EXEEXT) $(bindir)/widl$(EXEEXT)
+	$(INSTALL_DATA) $(SRCDIR)/widl.man $(mandir)/man$(prog_manext)/widl.$(prog_manext)
 
 uninstall::
-	$(RM) $(bindir)/widl$(EXEEXT)
+	$(RM) $(bindir)/widl$(EXEEXT) $(mandir)/man$(prog_manext)/widl.$(prog_manext)
 
 ### Dependencies:
diff --git a/tools/widl/widl.man b/tools/widl/widl.man
new file mode 100644
index 00000000000..c65bd7e80ca
--- /dev/null
+++ b/tools/widl/widl.man
@@ -0,0 +1,71 @@
+.TH WIDL 1 "March 2004" "Wine Manpage" "Wine Developers Manual"
+.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:
+.IP \fB-t\fR
+Only 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.
+.IP \fB-V\fR
+Print version number and exits from the program.
+.PP
+.B Header options:
+.IP \fB-b\fR
+Make headers compatible with ICOM macros.
+.IP \fB-h\fR
+Only generate header files.
+.IP "\fB-H \fIfile\fR"
+Name of header file to include. The default header
+filename is infile.h.
+.IP "\fB-I \fIpath\fR"
+Add a header search dir to path. Multiple search 
+dirs are allowed.
+.PP
+.B Preprocessor options:
+.IP "\fB-D \fIid[=val]\fR"
+Define preprocessor identifier id value.
+.IP \fB-E\fR
+Preprocess only.
+.IP \fB-N\fR
+Do not preprocess input.
+.PP
+.B Debug options:
+.IP \fB-W\fR
+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