--- a/FaceReader.st	Wed Nov 22 15:08:36 1995 +0100
+++ b/FaceReader.st	Wed Nov 22 16:14:27 1995 +0100
@@ -34,14 +34,29 @@
 !
 
 version
-    ^ '$Header: /cvs/stx/stx/libview2/FaceReader.st,v 1.13 1995-11-11 16:04:27 cg Exp $'
+    ^ '$Header: /cvs/stx/stx/libview2/FaceReader.st,v 1.14 1995-11-22 15:14:27 cg Exp $'
 !
 
 documentation
 "
     this class knows how to read face files.
-    (this format is used for peoples faces - which can be optained from some
+    (this format is used for people's faces - which can be optained from some
      ftp-servers, to improve mail- and/or newsreaders :-)
+    Other than above, that format is not used often.
+
+    The file format is (ascii):
+	...
+	FirstName: ...
+	LastName: ...
+	E-mail: ...
+	PicData: ...
+	Image: <width> <height> <depth>
+
+	bits; encoded in uppercase hex ascii; 2 chars/pixel
+	pixel values are greyscale-value; 0..255
+
+    only 8-bit greyscale is supported - I have never encountered
+    any other face-file-format.
 
     Notice, that face files come in two formats: the one implemented here,
     and the blitImage file format, which only supports 48x48x1 images.
@@ -112,10 +127,12 @@
 	].
 	line := aStream nextLine
     ].
-    photometric := #whiteIs0.
+    photometric := #blackIs0.
     samplesPerPixel := 1.
     bitsPerSample := #(8)
 
-    "FaceReader fromFile:'../goodies/faces/next.com/steve.face'"
+    "
+     FaceReader fromFile:'../goodies/faces/next.com/steve.face'
+    "
     "this is NOT steve jobs :-)"
 ! !