summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--base/gsdparam.c4
-rw-r--r--doc/Language.htm5
2 files changed, 7 insertions, 2 deletions
diff --git a/base/gsdparam.c b/base/gsdparam.c
index 9f85e6137..a65ee19cb 100644
--- a/base/gsdparam.c
+++ b/base/gsdparam.c
@@ -1910,8 +1910,10 @@ label:\
}
switch (code = param_read_int(plist, (param_name = "BandHeight"), &sp.band.BandHeight)) {
- CHECK_PARAM_CASES(band.BandHeight, sp.band.BandHeight < 0, bhe);
+ CHECK_PARAM_CASES(band.BandHeight, sp.band.BandHeight < -1, bhe);
}
+ if (sp.band.BandHeight == -1)
+ sp.band.BandHeight = dev->height; /* 1 band for the page requested */
switch (code = param_read_size_t(plist, (param_name = "BandBufferSpace"), &sp.band.BandBufferSpace)) {
CHECK_PARAM_CASES(band.BandBufferSpace, 0, bbse);
diff --git a/doc/Language.htm b/doc/Language.htm
index 51965ae66..1922893e5 100644
--- a/doc/Language.htm
+++ b/doc/Language.htm
@@ -1744,7 +1744,10 @@ the <code>BufferSpace</code> parameter, not <code>BandBufferSpace</code>.</p>
<dd>The height of bands when banding. 0 means use the largest band height
that will fit within the <code>BandBufferSpace</code> (or <code>BufferSpace</code>,
if <code>BandBufferSpace</code> is not specified). If <code>BandHeight</code>
-is larger than the number of lines that will fit in the buffer, opening the device will fail.</dd>
+is larger than the number of lines that will fit in the buffer, opening the device will fail.
+If the value is -1, the BandHeight will automatically be set to the page height
+(1 band for the entire page). This is primarily for developers debugging clist issues.
+</dd>
</dl>
<dl>