--- a/README.md Mon Jan 21 15:44:53 2019 +0000
+++ b/README.md Wed Jan 23 11:02:06 2019 +0000
@@ -1,29 +1,31 @@
# Visual / VM Debugger
-*Visual / VM Debugger* (*VDB* for short) is a simple standalone graphical
-front-end for [GDB][2] aimed to debug, not only, virtual machines. It provides
-easy-to-use, easy-to-extend user interface while keeping full power of GDB
-command line and scripting facilities.
+*Visual / VM Debugger* (*VDB* for short) is a simple standalone graphical front-end for [GDB][2]aimed to debug, not only, virtual machines. It provides easy-to-use, easy-to-extend user interface while keeping full power of GDB command line and scripting facilities.
## Features
- * integrated support for reverse-debugging
+ * integrated support for reverse-debugging,
* source-and-assembly view with detailed instruction analysis (basic blocks,
- jump targets and so on)
- * data structure inspector
- * configurable memory view
- * integrated *GDB* command line
+ jump targets and so on),
+ * data structure inspector,
+ * configurable memory view,
+ * integrated *GDB* command line with completion (even on Windows!),
+ * integrated support for reverse debugging using *GDB's* native reverse
+ debugging or [rr][11],
+ * ability to run *GDB* remotely through SSH on a remote server or on a
+ development board
+
+## Obligatory Screenshot
+
+![Visual/VM Debugger](doc/vdb-001.png)
## Prerequisites
-It is recommended to use the latest GDB built from GDB [git master][4] as it
-contains changes required by *VDB*.
+It is recommended to use GDB built from [https://bitbucket.org/janvrany/binutils-gdb][4] as it contains changes required by *VDB*. For more information about building patched GDB see [https://bitbucket.org/janvrany/jv-libgdbs/src/tip/doc/GDB.md][9].
## Building from Source
-*Visual / VM Debugger* is a part of [Smalltalk/X jv-branch][3] since
-version 8.0.0. To build VDB, just follow instructions how to [build
-Smalltalk/X jv-branch][6] and then run either:
+*Visual / VM Debugger* is a part of [Smalltalk/X jv-branch][3] since version 8.0.0. To build VDB, just follow instructions how to [build Smalltalk/X jv-branch][6] and then run either:
```
./build/stx/projects/smalltalk/smalltalk --load jv:vdb --run VDBStartup
@@ -38,6 +40,9 @@
VDBStartup main: #('--help')
```
+For more details, see [documentation][10], sections [Building from Source](Building.md)
+and [Invoking and Configuring](Invoking.md).
+
## Pre-built binaries
Download and unpack latest [Smalltalk/X jv-branch toy archive][5]
@@ -56,6 +61,10 @@
VDBStartup main: #('--help')
```
+## Documentation
+
+Some documentation can be found in [doc][10] directory, see [doc/README.md][10]
+
## Reporting issues
Use [Smalltalk/X jv-branch issue tracker][6] to [report issues][7] (you may need
@@ -88,8 +97,11 @@
[1]: http://creativecommons.org/licenses/by-nc/4.0/
[2]: https://www.gnu.org/software/gdb/
[3]: https://swing.fit.cvut.cz/projects/stx-jv
-[4]: https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git
+[4]: https://bitbucket.org/janvrany/binutils-gdb
[5]: https://swing.fit.cvut.cz/jenkins/job/stx_jv/lastSuccessfulBuild/
[6]: https://swing.fit.cvut.cz/projects/stx-jv/wiki/Documentation/BuildingStXWithRakefiles
[7]: https://swing.fit.cvut.cz/projects/stx-jv/newticket
[8]: https://groups.google.com/forum/#!forum/stx-jv
+[9]: https://bitbucket.org/janvrany/jv-libgdbs/src/tip/doc/GDB.md
+[10]: doc/README.md
+[11]: https://rr-project.org/
\ No newline at end of file