filesystem.rb in nanoc3-3.0.4

- old
+ new
@@ -29,19 +29,26 @@
   # Content files can also have the 'index' basename. Similarly, meta files
   # can have the 'meta' basename. For example, a parent directory named 'foo'
   # can have an 'index.txt' content file and a 'meta.yaml' meta file. This is
   # to preserve backward compatibility.
   #
+  # The identifier is calculated by stripping the extension; if there is more
+  # than one extension, only the last extension is stripped and the previous
+  # extensions will be part of the identifier.
+  #
   # = Layouts
   #
   # Layouts are stored as directories in the 'layouts' directory. Each layout
   # contains a content file and a meta file. The content file contain the
   # actual layout, and the meta file describes how the item should be handled
   # (contains the filter that should be used).
   #
   # For backward compatibility, a layout can also be a single file in the
   # 'layouts' directory. Such a layout cannot have any metadata; the filter
   # used for this layout is determined from the file extension.
+  #
+  # The identifier for layouts is generated the same way as identifiers for
+  # items (see above for details).
   #
   # = Code Snippets
   #
   # Code snippets are stored in '.rb' files in the 'lib' directory. Code
   # snippets can reside in sub-directories.