diff --git a/src/guide/xml/ch02.xml b/src/guide/xml/ch02.xml
index c9bfb7b39..a39594c9c 100755
--- a/src/guide/xml/ch02.xml
+++ b/src/guide/xml/ch02.xml
@@ -709,6 +709,21 @@ chunks.
navigation aids are constructed.
+use-id-as-filename
+
+If this parameter is true, the xml:id
+on a chunk will be used to construct the filename for that chunk. You can also control
+the chunk filename on a per-chunk basis with the
+db processing instruction
+
+db processing instruction
+ using the filename
+db processing instruction
+filename pseudo-attribute
+ pseudo-attribute.
+
+
+
diff --git a/src/guide/xml/changelog.xml b/src/guide/xml/changelog.xml
index 31396a683..8865ca5fc 100644
--- a/src/guide/xml/changelog.xml
+++ b/src/guide/xml/changelog.xml
@@ -54,6 +54,11 @@ the combination of options. See .
+
+Added use-id-as-filename parameter. If true,
+the xml:id value of a chunk will be used as the
+chunk filename.
+
diff --git a/src/guide/xml/ref-params.xml b/src/guide/xml/ref-params.xml
index d80cddf4c..ca8e3561f 100644
--- a/src/guide/xml/ref-params.xml
+++ b/src/guide/xml/ref-params.xml
@@ -5877,4 +5877,25 @@ The default language only applies to programlisting elements.
+
+
+
+ xs:string
+ use-id-as-filename
+ 'false'
+
+ 2.5.0
+
+
+ Use id as filename when chunking
+
+
+Description
+
+If this parameter is true, when a document is being
+chunked, the xml:id of a chunk will be used as the filename
+unless a processing instruction overrides it.
+
+
+
diff --git a/src/main/xslt/modules/chunk.xsl b/src/main/xslt/modules/chunk.xsl
index dc7035d38..fe3113b50 100644
--- a/src/main/xslt/modules/chunk.xsl
+++ b/src/main/xslt/modules/chunk.xsl
@@ -140,6 +140,9 @@
+
+
+