Merge "Add better doc of timestamp logging function." into main
diff --git a/liblog/include/android/log.h b/liblog/include/android/log.h
index 938786c..8ef2468 100644
--- a/liblog/include/android/log.h
+++ b/liblog/include/android/log.h
@@ -276,7 +276,11 @@
void __android_log_logd_logger(const struct __android_log_message* log_message) __INTRODUCED_IN(30);
/**
- * Writes the log message to logd using the passed in timestamp.
+ * Writes the log message to logd using the passed in timestamp. The messages are stored
+ * in logd in the order received not in order by timestamp. When displaying the log, there is no
+ * guarantee that messages are in timestamp order and might cause messages with different times to
+ * be interleaved. Filtering the log using a timestamp will work properly even if out of time
+ * order messages are present.
*
* @param log_message the log message to write, see {@link __android_log_message}.
* @param timestamp the time to use for this log message. The value is interpreted as a