Sweden-Number/documentation
Alexandre Julliard a46f5ad0c0 Changed julliard@lrc.epfl.ch to julliard@winehq.com 2000-07-16 21:09:03 +00:00
..
samples Default system.ini (from documentation/status/multimedia). 2000-04-08 20:19:51 +00:00
status - Make ref counting a little more efficient 2000-07-10 13:19:28 +00:00
.cvsignore Ignore all output files. 2000-04-11 20:07:48 +00:00
ChangeLog.OLD Moved old ChangeLog to documentation/ChangeLog.OLD. 1998-10-18 16:34:50 +00:00
HOWTO-winelib WineLib does not support Win16. Removed references to Win16 and Win 2000-06-15 00:09:48 +00:00
Makefile.in Improved support for Makefiles that need to recurse in subdirectories. 2000-04-09 18:19:59 +00:00
README.documentation Miscellaneous small fixes. 1998-11-22 16:56:44 +00:00
accelerators Fixed accelerator handling. ACCEL16 used internal, ACCEL32 for Win32 1999-01-22 17:09:46 +00:00
aspi SendASPI32Command32 has to be __cdecl. 1999-01-03 12:30:02 +00:00
bugreports Regression testing using CVS. 2000-05-23 01:17:10 +00:00
cdrom-labels - support for reading labels and serial nums from device 2000-01-29 21:11:47 +00:00
common_controls Added builtin toolbar bitmaps. 1999-07-31 13:10:46 +00:00
config Lots of spelling fixes that accumulated in my tree again, made several 2000-06-01 23:28:25 +00:00
console Add information about the new wine.conf options. 1999-02-20 16:41:29 +00:00
debug-msgs Fixed typos. 1999-01-23 14:02:08 +00:00
debugging MessageBox32A -> MessageBoxA 1999-03-22 12:36:34 +00:00
distributors Lots of spelling fixes that accumulated in my tree again, made several 2000-06-01 23:28:25 +00:00
dll-overrides Text of WWN article "DLL overrides". 2000-06-07 04:00:01 +00:00
dlls Added explanation of the current DLL support. 1999-07-28 16:37:19 +00:00
filehandles Release 980913 1998-09-13 16:32:00 +00:00
fonts Lots of spelling fixes that accumulated in my tree again, made several 2000-06-01 23:28:25 +00:00
gui Window style updates. 1999-07-03 12:06:26 +00:00
how-to-port Group commit for recovery after disk crash. 1999-01-17 16:55:11 +00:00
installation-und-konfiguration.german Added German installation and configuration manual. 2000-07-16 15:41:17 +00:00
internal-dll Fixed typos. 1999-01-24 09:47:29 +00:00
internals Release 980215 1998-02-15 19:40:49 +00:00
ioport-trace-hints Fixed typos. 1999-01-23 14:02:08 +00:00
keyboard Clarified a few points. 1999-04-15 16:44:34 +00:00
languages Basic Croatian language support. 2000-05-30 20:50:45 +00:00
linux-fat-permissions Added a document that describes configuring FAT filesystem permissions 1999-12-25 22:50:21 +00:00
no-windows Lots of spelling fixes that accumulated in my tree again, made several 2000-06-01 23:28:25 +00:00
opengl Updated OpenGL documentation. 2000-06-14 21:15:38 +00:00
printing Move PostScript driver docs to documentation/ . Add instructions on 1999-11-13 20:55:31 +00:00
programs Touch to test auto mailing of commits. 1998-10-11 23:14:04 +00:00
psdriver Added documentation on how to setup wine's Buildin Postscript Driver 2000-07-08 12:46:27 +00:00
psdrv.reg Move PostScript driver docs to documentation/ . Add instructions on 1999-11-13 20:55:31 +00:00
registry Text of WWN article "The Registry". 2000-07-15 19:42:27 +00:00
resources Added .rc file support for Win16 NE modules. 1999-12-06 01:20:00 +00:00
shell32 - New (some stubs): SHGetFolderLocation, PathAddExtension, 2000-06-01 23:25:44 +00:00
ttfserver Release 980601 1998-06-01 10:44:35 +00:00
win95look Add some information to the man page and README file. 1999-01-01 18:45:52 +00:00
wine.conf.man.in Save the registry on server exit without client intervention. 2000-04-16 17:21:13 +00:00
wine.man.in Doc and trace updates. 2000-07-16 15:43:07 +00:00
wine.texinfo Changed julliard@lrc.epfl.ch to julliard@winehq.com 2000-07-16 21:09:03 +00:00
wine_os2 Fixed typos. 1999-01-23 14:02:08 +00:00
winedbg Added BreakOnDllLoad internal var, cleaned up register validation on 2000-06-25 12:49:13 +00:00
winsock Release 970525 1997-05-25 13:58:18 +00:00
x11drv Text of WWN article "The X11 driver". 2000-06-15 00:10:41 +00:00

README.documentation

			Wine Documentation README


Wine Man Page

  The man page for Wine is in this directory. It is installed by 'make
install'.

Wine Reference Manual

  Texinfo source for preliminary comprehensive documentation is in
this directory.  Use 'make info' in this directory to generate the GNU
info version, 'make dvi' to generate the DVI version (hit 'r' to
ignore errors), or 'make all' for both. It is not installed by
default.

Wine API documentation

  Do a 'make manpages' in the Wine toplevel directory to generate the
API manpages from the Wine source, or 'make man' in any source
subdirectory to generate manpages from only that directory. Only
functions mentioned in Wine spec files will be documented; the
specific .spec files checked are set by the MANSPECS variable in
Make.rules. The manpages will be generated into
[documentation/man3w]. For HTML formatted manpages, do 'make
htmlpages' from the toplevel, or 'make html' from any
subdirectory. HTML formatted pages are generated into
[documentation/html]. You will need c2man as modified for Wine,
available as source or binary from ftp://ftp.winehq.com/pub/wine/.
The man pages are not installed by 'make install'.

Other READMEs

  Other informational files are in this directory as well as scattered
through the source tree.

Other resources:

  Usenet: news:comp.emulators.ms-windows.wine
  WWW:    http://www.winehq.com/


Writing Wine API Documentation

To improve the documentation of the Wine API, just add comments to the
existing source. For example,

/******************************************************************
 *         CopyMetaFile32A   (GDI32.23)
 *
 *  Copies the metafile corresponding to hSrcMetaFile to either
 *  a disk file, if a filename is given, or to a new memory based
 *  metafile, if lpFileName is NULL.
 *
 * RETURNS
 *
 *  Handle to metafile copy on success, NULL on failure.
 *
 * BUGS
 *
 *  Copying to disk returns NULL even if successful.
 */
HMETAFILE32 WINAPI CopyMetaFile32A(
		   HMETAFILE32 hSrcMetaFile, /* handle of metafile to copy */
		   LPCSTR lpFilename /* filename if copying to a file */
) { ... }

becomes, after processing with c2man and nroff -man,

CopyMetaFileA(3w)                               CopyMetaFileA(3w)


NAME
       CopyMetaFileA - CopyMetaFile32A   (GDI32.23)

SYNOPSIS
       HMETAFILE32 CopyMetaFileA
       (
            HMETAFILE32 hSrcMetaFile,
            LPCSTR lpFilename
       );

PARAMETERS
       HMETAFILE32 hSrcMetaFile
              Handle of metafile to copy.

       LPCSTR lpFilename
              Filename if copying to a file.

DESCRIPTION
       Copies  the  metafile  corresponding  to  hSrcMetaFile  to
       either a disk file, if a filename is given, or  to  a  new
       memory based metafile, if lpFileName is NULL.

RETURNS
       Handle to metafile copy on success, NULL on failure.

BUGS
       Copying to disk returns NULL even if successful.

SEE ALSO
       GetMetaFileA(3w),   GetMetaFileW(3w),   CopyMetaFileW(3w),
       PlayMetaFile(3w),  SetMetaFileBitsEx(3w),  GetMetaFileBit-
       sEx(3w)