From dd6aa8cf2d5247458ff6322a300582d1149e8a46 Mon Sep 17 00:00:00 2001
From: Detlef Riekenberg <wine.dev@web.de>
Date: Mon, 12 Dec 2005 12:10:13 +0100
Subject: [PATCH] winspool: Added documentation for OpenPrinter.

---
 dlls/winspool/info.c | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/dlls/winspool/info.c b/dlls/winspool/info.c
index f1d05c1dce6..9b1771df5ec 100644
--- a/dlls/winspool/info.c
+++ b/dlls/winspool/info.c
@@ -1039,6 +1039,8 @@ LONG WINAPI DocumentPropertiesW(HWND hWnd, HANDLE hPrinter,
 /******************************************************************
  *              OpenPrinterA        [WINSPOOL.@]
  *
+ * See OpenPrinterW.
+ *
  */
 BOOL WINAPI OpenPrinterA(LPSTR lpPrinterName,HANDLE *phPrinter,
 			 LPPRINTER_DEFAULTSA pDefault)
@@ -1069,6 +1071,32 @@ BOOL WINAPI OpenPrinterA(LPSTR lpPrinterName,HANDLE *phPrinter,
 /******************************************************************
  *              OpenPrinterW        [WINSPOOL.@]
  *
+ * Open a Printer / Printserver or a Printer-Object
+ *
+ * PARAMS
+ *  lpPrinterName [I] Name of Printserver, Printer, or Printer-Object
+ *  phPrinter     [O] The resulting Handle is stored here
+ *  pDefault      [I] PTR to Default Printer Settings or NULL
+ *
+ * RETURNS
+ *  Success: TRUE
+ *  Failure: FALSE
+ *
+ * NOTES
+ *  lpPrinterName is one of:
+ *|  Printserver (NT only): "Servername" or NULL for the local Printserver
+ *|  Printer: "PrinterName"
+ *|  Printer-Object: "PrinterName,Job xxx"
+ *|  XcvMonitor: "Servername,XcvMonitor MonitorName"
+ *|  XcvPort: "Servername,XcvPort PortName"
+ *
+ * BUGS
+ *|  Printserver not supported
+ *|  Printer-Object not supported
+ *|  XcvMonitor not supported
+ *|  XcvPort not supported
+ *|  pDefaults not supported
+ *
  */
 BOOL WINAPI OpenPrinterW(LPWSTR lpPrinterName,HANDLE *phPrinter,
 			 LPPRINTER_DEFAULTSW pDefault)
-- 
2.11.4.GIT