Improve docs of rtsan enable/disable

Author: cjappl

compiler-rt/include/sanitizer/rtsan_interface.h

@@ -25,10 +25,11 @@ extern "C" {
 #endif // __cplusplus
 
 // Disable all RTSan error reporting.
+// Must be paired with a call to `__rtsan_enable`
 void SANITIZER_CDECL __rtsan_disable(void);
 
 // Re-enable all RTSan error reporting.
-// The counterpart to `__rtsan_disable`.
+// Must follow a call to `__rtsan_disable`.
 void SANITIZER_CDECL __rtsan_enable(void);
 
 #ifdef __cplusplus
@@ -54,7 +55,7 @@ class ScopedDisabler {
 #endif // __cplusplus >= 201103L
 };
 
-#else // doesn't have realtime_sanitizer
+#else
 
 class ScopedDisabler {
 public:

compiler-rt/lib/rtsan/rtsan.h

@@ -42,8 +42,6 @@ SANITIZER_INTERFACE_ATTRIBUTE void __rtsan_disable();
 // See documentation in rtsan_interface.h.
 SANITIZER_INTERFACE_ATTRIBUTE void __rtsan_enable();
 
-// Expect that the next call to a function with the given name will not be
-// called from a realtime context.
 SANITIZER_INTERFACE_ATTRIBUTE void
 __rtsan_expect_not_realtime(const char *intercepted_function_name);