From 642375600b0da1e4803d7b99cbd72222f232e24d Mon Sep 17 00:00:00 2001
From: Qingping Hou <dave2008713@gmail.com>
Date: Mon, 18 Feb 2013 15:53:46 +0800
Subject: [PATCH] add more comments

---
 einkfb.c | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/einkfb.c b/einkfb.c
index bd27e5911..b87c4905f 100644
--- a/einkfb.c
+++ b/einkfb.c
@@ -222,8 +222,14 @@ static int openFrameBuffer(lua_State *L) {
 	}
 	
 	if (fb->vinfo.bits_per_pixel == 8) {
-		/* for 8bpp K4, PaperWhite, we create a shadow 4bpp blitbuffer. These
-		 * models use 16 scale 8bpp framebuffer, so we still cheat it as 4bpp
+		/* for 8bpp K4, PaperWhite, we create a shadow 4bpp blitbuffer.
+		 * These models use 16 scale 8bpp framebuffer, so they are
+		 * actually fake 8bpp FB. Therefore, we still treat them as 4bpp
+		 *
+		 * For PaperWhite, the screen width is 758, but FB's line_length
+		 * is 768. So when doing the screen update, you still need to
+		 * fill 768 pixels per line, but the trailing 10 px for each
+		 * line is actually ignored by driver.
 		 * */
 		fb->buf->pitch = fb->vinfo.xres / 2;