diff --git a/man/sd_journal_get_cursor.xml b/man/sd_journal_get_cursor.xml
index 305c08b910..351c898483 100644
--- a/man/sd_journal_get_cursor.xml
+++ b/man/sd_journal_get_cursor.xml
@@ -61,12 +61,6 @@
and should be freed after use with
free3.
- Note that sd_journal_get_cursor() will
- not work before
- sd_journal_next3
- (or related call) has been called at least once, in order to
- position the read pointer at a valid entry.
-
sd_journal_test_cursor()
may be used to check whether the current position in
the journal matches the specified cursor. This is
@@ -75,10 +69,17 @@
multiple different cursor strings, and hence string
comparing cursors is not possible. Use this call to
verify after an invocation of
- sd_journal_seek_cursor3
+ sd_journal_seek_cursor3,
whether the entry being sought to was actually found
in the journal or the next closest entry was used
instead.
+
+ Note that sd_journal_get_cursor()
+ and sd_journal_test_cursor()
+ will not work before
+ sd_journal_next3
+ (or one of the other functions which move to an entry)
+ has been called at least once to position the read pointer at a valid entry.
diff --git a/man/sd_journal_seek_head.xml b/man/sd_journal_seek_head.xml
index 2172cae37e..4e6fb9458b 100644
--- a/man/sd_journal_seek_head.xml
+++ b/man/sd_journal_seek_head.xml
@@ -82,8 +82,7 @@
string. For details on cursors, see
sd_journal_get_cursor3.
If no entry matching the specified cursor is found the call will seek to the next closest entry (in terms
- of time) instead. To verify whether the newly selected entry actually matches the cursor, use
- sd_journal_test_cursor3.
+ of time) instead.
Note that these calls do not actually make any entry the new current entry, this needs to be done
in a separate step with a subsequent
@@ -97,6 +96,13 @@
used, the closest following entry will be sought to, if
sd_journal_previous3
is used the closest preceding entry is sought to.
+
+ After the seek is done, and
+ sd_journal_next3
+ or a similar call has been made,
+ sd_journal_test_cursor3
+ may be used to verify whether the newly selected entry actually matches the cursor.
+