[RFC] document Cygwin native specific commands

[Pierre Muller <muller at cerbere dot u-strasbg dot fr>]

   Here is a second version of my patch to document 
Cygwin native specific commands.

I have no experience with texinfo ...
I still don't know what the difference between @kindex and @cindex is :(

2002-02-19  Pierre Muller  <muller@ics.u-strasbg.fr>

          * gdb.texinfo: Document Cygwin native specifc commands.



Index: gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.90
diff -u -r1.90 gdb.texinfo
--- gdb.texinfo	2002/02/15 19:06:33	1.90
+++ gdb.texinfo	2002/02/19 09:27:41
@@ -10487,6 +10487,7 @@
  * HP-UX::                       HP-UX
  * SVR4 Process Information::    SVR4 process information
  * DJGPP Native::                Features specific to the DJGPP port
+* Cygwin Native::		Features specific to the Cygwin port
  @end menu
  
  @node HP-UX
@@ -10683,6 +10684,79 @@
  mapped 1:1, i.e.@: the physical and linear addresses are identical.
  
  This command is supported only with some DPMI servers.
+@end table
+
+@node Cygwin Native
+@subsection Features for Debugging @sc{win32} PE executables
+@cindex @sc{win32} debugging
+@cindex native Cygwin debugging
+@cindex Win32-specific commands
+
+@value{GDBN} supports native debugging of @sc{win32} programs, and
+defines a few commands specific to the Cygwin port.  This
+subsection describes those commands.
+
+@table @code
+@kindex info w32
+@item info w32
+This is a prefix of @sc{win32}-specific commands which print
+information about the target system and important OS structures.
+
+@kindex selector
+@cindex @sc{win32} selector info
+@item info w32 selector
+This command displays information returned by
+the Win32 API @code{GetThreadSelectorEntry} function.
+It takes an optional argument that is evaluated to
+a long value to give the information about this given selector.
+Without argument, this command displays information
+about the the six segment registers.
+
+@kindex dll
+@item info dll
+This is an alias of info shared.
+
+@kindex dll-symbols
+@item dll-symbols
+This command loads symbols from a dll similarly to
+add-sym command but without the need to specify a base address.
+
+@kindex new-console
+@item set new-console
+This boolean value controls whether the debuggee should
+be started in a new console or in the same console as the debugger.
+
+@kindex new-group
+@item set new-group
+This boolean value controls whether the debuggee should
+start a new group or stay in the same group as the debugger.
+This affects the way the Windows OS handles
+Ctrl-C.
+
+@kindex debugevents
+@item set debugevents
+This boolean value adds debug output concerning events seen by the debugger.
+
+@kindex debugexec
+@item set debugexec
+This boolean value adds debug output concerning execute events 
+seen by the debugger.
+
+@kindex debugexceptions
+@item set debugexceptions
+This boolean value adds debug ouptut concerning exception events 
+seen by the debugger.
+
+@kindex debugmemory
+@item set debugmemory
+This boolean value adds debug ouptut concerning memory events 
+seen by the debugger.
+
+@kindex shell
+@item set shell
+This boolean values specifies whether the debugge is called
+via a shell or directly.
+
  @end table
  
  @node Embedded OS



Pierre Muller
Institut Charles Sadron
6,rue Boussingault
F 67083 STRASBOURG CEDEX (France)
mailto:muller@ics.u-strasbg.fr
Phone : (33)-3-88-41-40-07  Fax : (33)-3-88-41-40-99