diff --git a/python/commit-file-format.txt b/python/commit-file-format.txt
index 6f3b863..98a8434 100644
--- a/python/commit-file-format.txt
+++ b/python/commit-file-format.txt
@@ -2,6 +2,8 @@ Filformatet som forventes av 'commit'-kommandoen, og som skrives ut av
 kommandoen 'suggest-book-data', samt av andre kommandoer når man gir
 opsjonen --commit-format
 
+En linje som starter med '#' er en kommentar.
+
 Filen består av ett eller flere avsnitt.  En blank linje indikerer
 nytt avsnitt.  Hvert avsnitt beskriver én ting som skal gjøres.  De
 mulige tingene å gjøre er: legge inn ny bok eller forfatter, endre en
@@ -27,13 +29,16 @@ Hvert avsnitt må inneholde feltet 'action', som beskriver hva som skal
 gjøres.  De mulige verdiene for action-feltet er:
 
   new-book
-  new-person
   edit-book
-  edit-person
   delete-book
+  new-person
+  edit-person
   delete-person
+  new-category
+  edit-category
+  delete-category
 
-Eksempel:
+Eksempler:
 
 action: new-book
 isbn: 4325463287546
@@ -58,3 +63,8 @@ thumbnail:
 references:
  url http://example.org/
  wikipedia http://en.wikipedia.org/wiki/FooBar
+
+action: edit-category
+id: matematikk
+name: Matematikk
+placement: T10 T11 T12