[RFC] document Cygwin native specific commands

Pierre Muller
2002-02-19T09:32:34Z

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