[openocd-svn] Main OpenOCD repository branch, master, updated. v0.4.0-rc2-11-g4aa0a4d

[David B. <dbr...@us...>]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Main OpenOCD repository".

The branch, master has been updated
       via  4aa0a4d8111772c526ba84e3502b2f73ca06d603 (commit)
      from  bb4cb7935e8c4eb41e1d68ac2c43f6a1caec1ae5 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 4aa0a4d8111772c526ba84e3502b2f73ca06d603
Author: David Brownell <dbr...@us...>
Date:   Sun Feb 21 09:29:24 2010 -0800

    User's Guide mentions OS-specific installation
    
    Specifically the Linux issue of needing "udev" rules, and MS-Windows
    needing driver configuration.
    
    Also, update the existing udev note to use the correct name of that
    rules file in the source tree.
    
    Signed-off-by: David Brownell <dbr...@us...>

diff --git a/README b/README
index 35118da..b69a69a 100644
--- a/README
+++ b/README
@@ -64,8 +64,8 @@ you can build the in-tree documentation.
 Installing OpenOCD
 ==================
 
-On Linux, you may have permissions problems to address.  The best
-way to do this is to use the contrib/udev.rules file.  It probably
+On Linux, you may have permissions problems to address.  The best way
+to do this is to use the contrib/openocd.udev rules file.  It probably
 belongs somewhere in /etc/udev/rules.d, but consult your operating
 system documentation to be sure.  In particular, make sure that it
 matches the syntax used by your operating system's version of udev.
diff --git a/doc/openocd.texi b/doc/openocd.texi
index 63b6ab0..61e39b2 100644
--- a/doc/openocd.texi
+++ b/doc/openocd.texi
@@ -506,6 +506,14 @@ as Tcl scripts, from a @file{startup.tcl} file internal to the server.
 @cindex logfile
 @cindex directory search
 
+Properly installing OpenOCD sets up your operating system to grant it access
+to the JTAG adapters.  On Linux, this usually involves installing a file
+in @file{/etc/udev/rules.d,} so OpenOCD has permissions.  MS-Windows needs
+complex and confusing driver configuration for every peripheral.  Such issues
+are unique to each operating system, and are not detailed in this User's Guide.
+
+Then later you will invoke the OpenOCD server, with various options to
+tell it how each debug session should work.
 The @option{--help} option shows:
 @verbatim
 bash$ openocd --help
@@ -1984,6 +1992,10 @@ MMU: disabled, D-Cache: disabled, I-Cache: enabled
 @cindex config file, interface
 @cindex interface config file
 
+Correctly installing OpenOCD includes making your operating system give
+OpenOCD access to JTAG adapters.  Once that has been done, Tcl commands
+are used to select which one is used, and to configure how it is used.
+
 JTAG Adapters/Interfaces/Dongles are normally configured
 through commands in an interface configuration
 file which is sourced by your @file{openocd.cfg} file, or

-----------------------------------------------------------------------

Summary of changes:
 README           |    4 ++--
 doc/openocd.texi |   12 ++++++++++++
 2 files changed, 14 insertions(+), 2 deletions(-)


hooks/post-receive
-- 
Main OpenOCD repository