diff options
-rw-r--r-- | base/gsdparam.c | 4 | ||||
-rw-r--r-- | doc/Language.htm | 5 |
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> |