X-Git-Url: https://zdv2.bktei.com/gitweb/EVA-2020-02.git/blobdiff_plain/27a8996a799309f834378db297854a22584d7546..3f9df02d779f83f3a6a564d667029cffcf6ce7e6:/doc/location/README.org

diff --git a/doc/location/README.org b/doc/location/README.org
index 92e73b7..7158a73 100644
--- a/doc/location/README.org
+++ b/doc/location/README.org
@@ -1,7 +1,11 @@
 * Location Logging
 This document was created by Steven Baltakatei Sandoval on
 <2020-06-29 Mon 12:14> under a [[https://creativecommons.org/licenses/by-sa/4.0/][Creative Commons BY-SA 4.0 license]]. It
-was updated by Steven Baltakatei Sandoval on <2020-06-29 Mon 18:39>.
+was updated by Steven Baltakatei Sandoval on <2020-06-29 Mon 22:06>.
+#+TITLE: Ninfacyzga-01 Manual
+#+AUTHOR: Steven Baltakatei Sandoval
+#+DATE: 2020-06-29T22:16Z
+#+EMAIL: baltakatei@gmail.com
 ** Narrative
 Ninfacyzga-01 records (logs) its position in time and space using a
 [[https://en.wikipedia.org/wiki/Satellite_navigation_device][GPS receiver]]. The NMEA location data produced by the receiver is
@@ -72,7 +76,7 @@ An ~ssh-rsa~ or ~ssh-ed25519~ SSH public key string may be used instead of
 the bech32 public key string produced by ~age-keygen~ for convenience.
 
 Help information for ~age~ is available by running ~$ age --help~.
-***** Encryption
+***** Encryption Commands
 Files may be encrypted to several recipients using a command similar to:
 #+BEGIN_EXAMPLE
 timeout "60s" gpspipe -r | gpsbabel -i nmea -f - -o gpx -F | age \
@@ -86,7 +90,7 @@ In this example, the strings beginning with ~age1...~ are
 bech32-formatted public key strings. 
 
 
-***** Decryption
+***** Decryption Commands
 Files may be decrypted using a command similar to:
 
 #+BEGIN_EXAMPLE
@@ -134,15 +138,39 @@ Edit the user cron job list with ~$ crontab -e~ to add the following
 lines:
 
 #+BEGIN_EXAMPLE
-0 * * * * /bin/bash /path/to/bkgpslog --output $HOME/Sync/example_dir
+0 * * * * /bin/bash ~/bkgpslog --output ~/dir
 
-@reboot /bin/bash /path/to/bkgpslog --output $HOME/Sync/example_dir
+@reboot /bin/bash ~/bkgpslog --output ~/dir
 #+END_EXAMPLE
 
-The first line will run ~bkgpslog~ at the start of every hour.
+The first line will run ~bkgpslog~ at the start of every hour and save
+output files to the ~dir~ directory in your home folder.
 
 The second line will run ~bkgpslog~ when the system starts up.
 
+~/bin/bash~ tells ~cron~ to run ~bkgpslog~ with Bash.
+
+If encryption and compression are required, then the appropriate
+options must be added. The lines that must be added via ~$ crontab -e~
+may resemble:
+
+#+BEGIN_EXAMPLE
+0 * * * * /bin/bash ~/bkgpslog -c -e -r age1z2...qkv6p -o ~/dir
+
+@reboot /bin/bash ~/bkgpslog -c -e -r age1z2...qkv6p -o ~/dir
+#+END_EXAMPLE
+
+The ~age1z2...qkv6p~ is an ~age~ public key string. Please see the
+[[*Key Generation][Key Generation]] section for an explanation.
+
+The options are:
+
+: -c : tells bkgpslog to compress output
+: -e : tells bkgpslog log to encrypt output
+: -r : tells bkgpslog to interpret the next argument as a pubkey string
+: -o : tells bkgpslog to write output files to the directory represented
+:        by the next argument
+
 ***** Log Transfer Configuration
 Log files may be shared to other machines via ~syncthing~. See [[https://docs.syncthing.net/][this]]
 manual for how to set up a shared folder and add Ninfacyzga-01 as a