90 lines
2.4 KiB
Plaintext
90 lines
2.4 KiB
Plaintext
<chapter id="documentation">
|
|
<title>Documenting Wine</title>
|
|
<para>How to help out with the Wine documentation effort...</para>
|
|
|
|
<sect1 id="api-docs">
|
|
<title>Writing Wine API Documentation</title>
|
|
|
|
<para>
|
|
Written by &name-douglas-ridgway; <email>&email-douglas-ridgway;</email>
|
|
</para>
|
|
<para>
|
|
(Extracted from <filename>wine/documentation/README.documentation</filename>)
|
|
</para>
|
|
|
|
<para>
|
|
To improve the documentation of the Wine API, just add
|
|
comments to the existing source. For example,
|
|
</para>
|
|
<screen>
|
|
/******************************************************************
|
|
* CopyMetaFileA (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.
|
|
*/
|
|
HMETAFILE WINAPI CopyMetaFileA(
|
|
HMETAFILE hSrcMetaFile, /* handle of metafile to copy */
|
|
LPCSTR lpFilename /* filename if copying to a file */
|
|
) { ... }
|
|
</screen>
|
|
<para>
|
|
becomes, after processing with <command>c2man</command> and
|
|
<command>nroff -man</command>,
|
|
</para>
|
|
<screen>
|
|
CopyMetaFileA(3w) CopyMetaFileA(3w)
|
|
|
|
|
|
NAME
|
|
CopyMetaFileA (GDI32.23)
|
|
|
|
SYNOPSIS
|
|
HMETAFILE CopyMetaFileA
|
|
(
|
|
HMETAFILE hSrcMetaFile,
|
|
LPCSTR lpFilename
|
|
);
|
|
|
|
PARAMETERS
|
|
HMETAFILE 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)
|
|
</screen>
|
|
</sect1>
|
|
</chapter>
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-parent-document:("wine-doc.sgml" "set" "book" "part" "chapter" "")
|
|
End:
|
|
-->
|