X-Git-Url: https://git.stderr.nl/gitweb?a=blobdiff_plain;f=docs%2Freference%2Fblorb.sgml;h=28659f8d418c49b70f6edc598caec43c667cb7f0;hb=f19a194bd066ea4320c1c6b6b8c5a375f7787af5;hp=eeafe8ee7a01943cdb6e1330d8a72decee29080f;hpb=2da183ac47f1157560dcd2c417f7f6a24ae72352;p=projects%2Fchimara%2Fchimara.git

diff --git a/docs/reference/blorb.sgml b/docs/reference/blorb.sgml
index eeafe8e..28659f8 100644
--- a/docs/reference/blorb.sgml
+++ b/docs/reference/blorb.sgml
@@ -21,6 +21,13 @@ The material described in this section is not part of the Glk API per se. It is
 The Glk spec does not require that resources be stored in a Blorb file. It says only that the library knows how to load them and use them, when you so request. However, Blorb is the recommended way to supply portable resources. Most Glk libraries will support Blorb, using the interface defined in this section.
 </para>
 <para>
+The quick summary: resources are identified by type (image, sound, etc) and by an index number.
+<note><para>
+But not by name.
+This is for historical reasons; Infocom's Z-machine architecture used this scheme.
+</para></note>
+</para>
+<para>
 For the complete Blorb specification and tools for Blorb file manipulation, see:
 <ulink role="online-location" url="http://www.eblong.com/zarf/blorb/">http://www.eblong.com/zarf/blorb/</ulink>
 </para>