Minor tweaks to description of JTAG adapter/dongle issues.

git-svn-id: svn://svn.berlios.de/openocd/trunk@2729 b42882b7-edfa-0310-969c-e2dbd0fdcd60

1 files changed, 12 insertions, 4 deletions

diff --git a/doc/openocd.texi b/doc/openocd.texi
index 4db8698b..b944912c 100644
--- a/doc/openocd.texi
+++ b/doc/openocd.texi
@@ -250,12 +250,16 @@ and has a built in relay to power cycle targets remotely.
 
 @section Choosing a Dongle
 
-There are three things you should keep in mind when choosing a dongle. 
+There are several things you should keep in mind when choosing a dongle.
 
 @enumerate 
-@item @b{Voltage} What voltage is your target? 1.8, 2.8, 3.3, or 5V? Does your dongle support it?
-@item @b{Connection} Printer Ports - Does your computer have one?
-@item @b{Connection} Is that long printer bit-bang cable practical? 
+@item @b{Voltage} What voltage is your target - 1.8, 2.8, 3.3, or 5V?
+Does your dongle support it?  You might need a level converter.
+@item @b{Pinout} What pinout does your target board use?
+Does your dongle support it?  You may be able to use jumper
+wires, or an "octopus" connector, to convert pinouts.
+@item @b{Connection} Does your computer have the USB, printer, or
+Ethernet port needed?
 @item @b{RTCK} Do you require RTCK? Also known as ``adaptive clocking'' 
 @end enumerate
 
@@ -356,6 +360,10 @@ The two well known ``JTAG Parallel Ports'' cables are the Xilnx DLC5
 and the MacGraigor Wiggler. There are many clones and variations of
 these on the market.
 
+Note that parallel ports are becoming much less common, so if you
+have the choice you should probably avoid these adapters in favor
+of USB-based ones.
+
 @itemize @bullet
 
 @item @b{Wiggler} - There are many clones of this.