From d1ebeeab58c1e26e59fb9cc4347c7020c038c9e2 Mon Sep 17 00:00:00 2001
From: Corinna Vinschen <corinna@vinschen.de>
Date: Thu, 14 Aug 2014 20:47:14 +0000
Subject: [PATCH] 	* cygwin-api.xml: Include misc-funcs.xml. 	*
 misc-funcs.xml: New file.

---
 winsup/doc/ChangeLog      |  5 +++
 winsup/doc/cygwin-api.xml |  1 +
 winsup/doc/misc-funcs.xml | 64 +++++++++++++++++++++++++++++++++++++++
 3 files changed, 70 insertions(+)
 create mode 100644 winsup/doc/misc-funcs.xml

diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index 40b6a56f8..e4223599f 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,3 +1,8 @@
+2014-08-14  Corinna Vinschen  <corinna@vinschen.de>
+
+	* cygwin-api.xml: Include misc-funcs.xml.
+	* misc-funcs.xml: New file.
+
 2014-08-14  Corinna Vinschen  <corinna@vinschen.de>
 
 	* cygwin-api.xml: Move chapter tags from path.xml back here.
diff --git a/winsup/doc/cygwin-api.xml b/winsup/doc/cygwin-api.xml
index 498594792..ac98c0033 100644
--- a/winsup/doc/cygwin-api.xml
+++ b/winsup/doc/cygwin-api.xml
@@ -19,6 +19,7 @@
 
     <xi:include href="path.xml"/>
     <xi:include href="logon-funcs.xml"/>
+    <xi:include href="misc-funcs.xml"/>
 
   </chapter>
 
diff --git a/winsup/doc/misc-funcs.xml b/winsup/doc/misc-funcs.xml
new file mode 100644
index 000000000..06776d9e7
--- /dev/null
+++ b/winsup/doc/misc-funcs.xml
@@ -0,0 +1,64 @@
+<?xml version="1.0" encoding='UTF-8'?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook V4.5//EN"
+    "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
+
+<sect1 id="func-cygwin-misc">
+<title>Miscellaneous functions</title>
+
+<sect2 id="func-cygwin-attach-handle-to-fd">
+<title>cygwin_attach_handle_to_fd</title>
+
+<funcsynopsis><funcprototype>
+<funcdef>extern "C" int
+<function>cygwin_attach_handle_to_fd</function></funcdef>
+<paramdef>char *<parameter>name</parameter></paramdef>
+<paramdef>int <parameter>fd</parameter></paramdef>
+<paramdef>HANDLE <parameter>handle</parameter></paramdef>
+<paramdef>int <parameter>bin</parameter></paramdef>
+<paramdef>int <parameter>access</parameter></paramdef>
+</funcprototype></funcsynopsis>
+
+<para>This function can be used to turn a Win32 "handle" into a
+posix-style file handle. <parameter>fd</parameter> may be -1 to
+make cygwin allocate a handle; the actual handle is returned
+in all cases.</para>
+
+<para>Even after using function, Cygwin doesn't know anything about the
+underlying file or device.  It just tries to supply the typical file
+functions on a "best-effort" basis.  Use with care.  Don't expect too
+much.</para>
+
+</sect2>
+
+<sect2 id="func-cygwin-internal">
+<title>cygwin_internal</title>
+
+<funcsynopsis><funcprototype>
+<funcdef>extern "C" DWORD
+<function>cygwin_internal</function></funcdef>
+<paramdef>cygwin_getinfo_types <parameter>t</parameter></paramdef>
+<paramdef><parameter>...</parameter></paramdef>
+</funcprototype></funcsynopsis>
+
+<para>This function gives you access to various internal data and functions.
+It takes two arguments.  The first argument is a type from the 'cygwin_getinfo_types'
+enum.  The second is an optional pointer.</para>
+<para>Stay away unless you know what you're doing.</para>
+
+</sect2>
+
+<sect2 id="func-cygwin-stackdump">
+<title>cygwin_stackdump</title>
+
+<funcsynopsis><funcprototype>
+<funcdef>extern "C" void
+<function>cygwin_stackdump</function></funcdef>
+<void />
+</funcprototype></funcsynopsis>
+
+<para> Outputs a stackdump to stderr from the called location.
+</para>
+
+</sect2>
+
+</sect1>