1 files changed, 21 insertions, 8 deletions

diff --git a/docs/AJF b/docs/AJF
index 6558dfcf45..9a3c86eb02 100644
--- a/docs/AJF
+++ b/docs/AJF
@@ -1,4 +1,4 @@
-Description of the binary AJF font file format
+Description of the binary AJF font file format (version 2)
 
 Index    Descripton
 
@@ -9,14 +9,27 @@ Index    Descripton
 23 - 24  "bound width"  (high 8 bits, low 8 bits)
 25 - 26  "bound height" (high 8 bits, low 8 bits)
 26 - 28  first character in the font
-29 - 2a  0x00ff (supposed number of characters in the font?)
-2b -     map offset table starts here. Each offset entry is supposed to be 
-         three bytes: width, offset highbyte, offset lowbyte
-         The offset is a relative offset, counted in bytes, to where in the
-         font data this particular char's bitmap image starts.
+29 - 2a  number of characters in the font (alwasys 0x00ff now)
+2b -     map offset table starts here. Each offset entry is two bytes:
+         offset highbyte, offset lowbyte
 
-         font data, in Rockbox-internal image-format. That means column-wise
+         The offset is number of bytes from the start of this file, to where
+         in the font data this particular char's font data starts.
+
+         There is one offset entry for each character in this font, starting
+         with 'first character' (set above) and ending when all the 'number
+         of characters' have been stored.
+
+?? -     Font data. First four bytes width, height, dispx and dispy and then
+         the glyph in Rockbox-internal image-format. That means column-wise
          left-to-right for the full width, the first 8 pixels of height. Then
          follows the next 8 pixels of height left-to-right.
 
-         We don't currently support fonts larger than 16 pixels.
+         We don't currently support fonts larger than 16 pixels. (This font
+         file format would have no problem with bigger sizes, but the internal
+         bitmap function has.)
+
+References
+
+        The BDF file format
+        http://partners.adobe.com/asn/developer/pdfs/tn/5005.BDF_Spec.pdf
\ No newline at end of file