doc(bkgpslog):Add note to simplify main loop

diff --git a/exec/bkgpslog-plan.org b/exec/bkgpslog-plan.org
index da2370480f66ea57868de63f228bd2a69bd49ae2..b7cc736ed499fa742796d0dcfc18599f49cd0cb0 100644 (file)
--- a/exec/bkgpslog-plan.org
+++ b/exec/bkgpslog-plan.org
@@ -27,11 +27,27 @@ when a new session is started.
 is checked and its status as a valid tar file is validated. This was
 done using a new function ~checkMakeTar~.
 ** DONE Add VERSION if output tar deleted between writes
 is checked and its status as a valid tar file is validated. This was
 done using a new function ~checkMakeTar~.
 ** DONE Add VERSION if output tar deleted between writes

+

    CLOSED: [2020-07-02 Thu 20:22]
 2020-07-02T20:21Z; bktei> Added bkgpslog-specified function
 magicWriteVersion() to be called whenever a new time-stamped ~VERSION~
 file needs to be generated and appended to the output tar file
 ~PATHOUT_TAR~.
    CLOSED: [2020-07-02 Thu 20:22]
 2020-07-02T20:21Z; bktei> Added bkgpslog-specified function
 magicWriteVersion() to be called whenever a new time-stamped ~VERSION~
 file needs to be generated and appended to the output tar file
 ~PATHOUT_TAR~.

+** TODO Rewrite buffer loop to reduce lag between gpspipe runs
+2020-07-03T17:10Z; bktei> As is, there is still a 5-6 second lag
+between when ~gpspipe~ times out at the end of a buffer round and when
+~gpspipe~ is called by the subsequent buffer round. I believe this can
+be reduced by moving variable manipulations inside the
+asynchronously-executed magicWriteBuffer() function. Ideally, the
+while loop should look like:
+
+#+BEGIN_EXAMPLE
+while( $SECONDS < $SCRIPT_TTL); do
+    gpspipe-r > "$DIR_TMP"/buffer.nmea
+    writeBuffer &
+done
+#+END_EXAMPLE
+

 * bkgpslog narrative
 ** Initialize environment
 *** Init variables
 * bkgpslog narrative
 ** Initialize environment
 *** Init variables