[lmi-commits] [lmi] master 9ae6e81 19/22: Reformat and lightly revise some documentation

[Greg Chicares]

branch: master
commit 9ae6e81a2ec9c389fa5a463c8d018f4ab2b4f7a9
Author: Gregory W. Chicares <address@hidden>
Commit: Gregory W. Chicares <address@hidden>

    Reformat and lightly revise some documentation
---
 authenticity_test.cpp | 18 +++++++++---------
 workhorse.make        |  4 ++--
 2 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/authenticity_test.cpp b/authenticity_test.cpp
index 7ff79a9..07f589c 100644
--- a/authenticity_test.cpp
+++ b/authenticity_test.cpp
@@ -109,10 +109,10 @@ PasskeyTest::~PasskeyTest()
     RemoveTestFiles(__FILE__, __LINE__);
 }
 
-/// Regrettably, invoking 'lmi_md5sum' through a shell just to confirm its
-/// availability writes its output to stdout; however, without this
-/// test, it would be difficult to tell whether downstream errors stem
-/// from that program's absence.
+/// Regrettably, invoking 'lmi_md5sum' through a shell just to confirm
+/// its availability writes its output to stdout; however, without this
+/// function, it would be difficult to tell whether downstream errors
+/// stem from that program's absence.
 
 void PasskeyTest::EnsureMd5sumBinaryIsFound() const
 {
@@ -175,12 +175,12 @@ void PasskeyTest::InitializeDataFile() const
 ///
 /// This file consists of the md5 sum of the data file followed by two
 /// spaces and the name of the data file. Creating that file portably
-/// here by running 'lmi_md5sum' would require redirection, which isn't
-/// part of the standard C++ library, so the effect of 'lmi_md5sum' is
-/// instead emulated; testing that file here with 'lmi_md5sum' validates
-/// that emulation and guards against a bogus 'lmi_md5sum' program.
+/// here by running 'lmi_md5sum' would require redirection (and thus a
+/// shell), so the effect of 'lmi_md5sum' is instead emulated; testing
+/// that file here with 'lmi_md5sum' validates that emulation and
+/// guards against a bogus 'lmi_md5sum' program.
 ///
-/// Postcondition: the file passes a test with the 'lmi_md5sum' program.
+/// Postcondition: the file validates with the 'lmi_md5sum' program.
 
 void PasskeyTest::InitializeMd5sumFile() const
 {
diff --git a/workhorse.make b/workhorse.make
index 0b1877b..9abfb2c 100644
--- a/workhorse.make
+++ b/workhorse.make
@@ -1181,8 +1181,8 @@ fardel_files := \
 # because they aren't easily forged but are sizable enough to make
 # authentication too slow. An incorrect version of any such file might
 # be distributed by accident, but that problem would not be caught by
-# generating an md5sum for the incorrect file. 'lmi_md5sum$(EXEEXT)' is
-# however authenticated because replacing it with a program that
+# generating an md5sum for the incorrect file. 'lmi_md5sum$(EXEEXT)'
+# is however authenticated because replacing it with a program that
 # always reports success would circumvent authentication.
 #
 # 'passkey' is derived from the md5sums of other files; computing its