From a5cbe5bd85aad2341f62d7fcdb7691da290b0a38 Mon Sep 17 00:00:00 2001
From: oharboe <oharboe@b42882b7-edfa-0310-969c-e2dbd0fdcd60>
Date: Wed, 27 Aug 2008 06:05:27 +0000
Subject: [PATCH] comment about slow RTCK

git-svn-id: svn://svn.berlios.de/openocd/trunk@972 b42882b7-edfa-0310-969c-e2dbd0fdcd60
---
 src/jtag/jtag.h | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/src/jtag/jtag.h b/src/jtag/jtag.h
index 347777e49..7fdcd7bda 100644
--- a/src/jtag/jtag.h
+++ b/src/jtag/jtag.h
@@ -199,7 +199,13 @@ typedef struct jtag_interface_s
 	int (*init)(void);
 	int (*quit)(void);
 	/* returns JTAG maxium speed for KHz. 0=RTCK. The function returns
-	a failure if it can't support the KHz/RTCK. */
+	a failure if it can't support the KHz/RTCK. 
+	
+	WARNING!!!! if RTCK is *slow* then think carefully about
+	whether you actually want to support this in the driver.
+	Many target scripts are written to handle the absence of RTCK
+	and use a fallback kHz TCK.
+	*/
 	int (*khz)(int khz, int *jtag_speed);
 	/* returns the KHz for the provided JTAG speed. 0=RTCK. The function returns
 	a failure if it can't support the KHz/RTCK. */
-- 
GitLab