From 268fd444e65e57149d2399e4d978d0102feb6dfe Mon Sep 17 00:00:00 2001
From: Aaron Burghardt <aburgh@mac.com>
Date: Sat, 28 Feb 2015 22:14:57 -0500
Subject: [PATCH] Added comments to new method yyfill.

---
 src/json.hpp.re2c | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/json.hpp.re2c b/src/json.hpp.re2c
index 5ed8608c..7aad9680 100644
--- a/src/json.hpp.re2c
+++ b/src/json.hpp.re2c
@@ -3253,6 +3253,7 @@ class basic_json
 
         }
 
+		/// append data from the stream to the internal buffer
 		void yyfill(int n) noexcept
 		{
 			if (not m_stream or not *m_stream) return;
@@ -3261,6 +3262,9 @@ class basic_json
 			ssize_t offset_marker = m_marker - m_start;
 			ssize_t offset_cursor = m_cursor - m_start;
 
+			// The parser generator expects a minimum of n bytes to be appended,
+			// but by appending a line of data we will never split a token, so
+			// it should be safe to ignore the parameter.
 			m_buffer.erase(0, offset_start);
 			std::string line;
 			std::getline(*m_stream, line);