diff --git a/doc/resource.pdf b/doc/resource.pdf
index 99dfc6ecc..0efae7b50 100644
Binary files a/doc/resource.pdf and b/doc/resource.pdf differ
diff --git a/doc/resource.txt b/doc/resource.txt
index 04427c8f6..34d0e4be7 100644
--- a/doc/resource.txt
+++ b/doc/resource.txt
@@ -58,7 +58,7 @@ skills is typical of programmers who want to localize
 software to new languages.
 
 The current resource languages are
-% - ``Ara``bic
+- ``Ara``bic
 - ``Dan``ish
 - ``Eng``lish
 - ``Fin``nish
@@ -72,7 +72,8 @@ The current resource languages are
 
 
 The first three letters (``Eng`` etc) are used in grammar module names.
-%The Arabic implementation is still incomplete.
+The Arabic implementation is still incomplete, but enough to be used in
+examples like ``GF/examples/bronzeage``.
 
 To give an example application, consider
 music playing devices. In the application,
@@ -918,9 +919,9 @@ has only been exploited in a very small scale so far.
 
 ==Inflectional paradigms==
 
-% ===Arabic===
+===Arabic===
 
-% %!include: ../lib/resource-1.0/arabic/ParadigmsAra.txt
+%!include: ../lib/resource-1.0/arabic/ParadigmsAra.txt
 
 ===Danish===
 
diff --git a/lib/resource-1.0/arabic/ParadigmsAra.gf b/lib/resource-1.0/arabic/ParadigmsAra.gf
index 884ae8090..94c6f6c09 100644
--- a/lib/resource-1.0/arabic/ParadigmsAra.gf
+++ b/lib/resource-1.0/arabic/ParadigmsAra.gf
@@ -80,7 +80,7 @@ resource ParadigmsAra = open
 --2 Adverbs
 
 -- Adverbs are not inflected. Most lexical ones have position
--- after the verb. Some can be preverbal (e.g. "َلوَيس").
+-- after the verb. Some can be preverbal.
 
   mkAdv : Str -> Adv ;
   mkAdV : Str -> AdV ;
@@ -178,12 +178,12 @@ resource ParadigmsAra = open
   V0, V2S, V2V, V2A, V2Q : Type ;
   AS, A2S, AV, A2V : Type ;
 
-
+--.
 --2 Definitions of paradigms
 
 -- The definitions should not bother the user of the API. So they are
 -- hidden from the document.
---.
+
 
   regV = \word ->
     case word of {