DATAMATRIX: add DM_ISO_144 (--dmiso144) option for ISO placement

of ECC codewords instead of default "de facto"

docs/manual.html

@@ -13,6 +13,7 @@
       background-color: #ffffff;
     }
     body {
+      line-height: 1.2;
       margin: 0 auto;
       max-width: 50em;
       padding-left: 50px;
@@ -4940,7 +4941,7 @@ aria-hidden="true"><code>zint -b CHANNEL -d "453678" --compliantheight</code></f
 in the symbol can be between 3 and 8 and this can be specified by
 setting the value of the <code>--vers</code> option (API
 <code>option_2</code>). It can also be determined by the length of the
-input data e.g. a three character input string generates a 4 channel
+input data: e.g. a three character input string generates a 4 channel
 code by default.</p>
 <p>The maximum values permitted depend on the number of channels used as
 shown in the table below:</p>
@@ -5920,6 +5921,10 @@ option <code>--dmre</code> (API <code>option_3 = DM_DMRE</code>).</p>
 <p>GS1 data may be encoded using FNC1 (default) or GS (Group Separator,
 ASCII 29) as separator. Use the option <code>--gssep</code> to change to
 GS (API <code>output_options |= GS1_GS_SEPARATOR</code>).</p>
+<p>By default Zint uses a “de facto” codeword placement for symbols of
+size 144 x 144 (version 24). To override this and use the now clarified
+ISO/IEC standard placement, use option <code>--dmiso144</code> (API
+<code>option_3 |= DM_ISO_144</code>).</p>
 <p>For a faster but less optimal encoding, the <code>--fast</code>
 option (API <code>input_mode |= FAST_MODE</code>) may be used.</p>
 <p>Data Matrix supports Structured Append of up to 16 symbols and a
@@ -8661,10 +8666,18 @@ anything.</p>
 pipe or a file. Use <code>--filetype</code> to specify output
 format.</p>
 </dd>
+<dt><code>--dmiso144</code></dt>
+<dd>
+<p>For Data Matrix symbols, use the standard ISO/IEC codeword placement
+for 144 x 144 (<code>--vers=24</code>) sized symbols, instead of the
+default “de facto” placement (which rotates the placement of ECC
+codewords).</p>
+</dd>
 <dt><code>--dmre</code></dt>
 <dd>
 <p>For Data Matrix symbols, allow Data Matrix Rectangular Extended
-(DMRE) sizes when considering automatic sizes.</p>
+(DMRE) sizes when considering automatic sizes. See also
+<code>--square</code>.</p>
 </dd>
 <dt><code>--dotsize=NUMBER</code></dt>
 <dd>
@@ -8954,7 +8967,7 @@ default is zero.</p>
 <dt><code>--square</code></dt>
 <dd>
 <p>For Data Matrix symbols, exclude rectangular sizes when considering
-automatic sizes.</p>
+automatic sizes. See also <code>--dmre</code>.</p>
 </dd>
 <dt><code>--structapp=I,C[,ID]</code></dt>
 <dd>

docs/manual.pmd

@@ -3261,8 +3261,8 @@ check digit.
 A highly compressed symbol for numeric data. The number of channels in the
 symbol can be between 3 and 8 and this can be specified by setting the value of
 the `--vers` option (API `option_2`). It can also be determined by the length of
-the input data e.g. a three character input string generates a 4 channel code by
-default.
+the input data: e.g. a three character input string generates a 4 channel code
+by default.
 
 The maximum values permitted depend on the number of channels used as shown in
 the table below:
@@ -3872,6 +3872,10 @@ GS1 data may be encoded using FNC1 (default) or GS (Group Separator, ASCII 29)
 as separator. Use the option `--gssep` to change to GS (API `output_options |=
 GS1_GS_SEPARATOR`).
 
+By default Zint uses a "de facto" codeword placement for symbols of size 144 x
+144 (version 24). To override this and use the now clarified ISO/IEC standard
+placement, use option `--dmiso144` (API `option_3 |= DM_ISO_144`).
+
 For a faster but less optimal encoding, the `--fast` option (API `input_mode |=
 FAST_MODE`) may be used.
 

docs/manual.txt

@@ -3150,7 +3150,7 @@ check digit.
 A highly compressed symbol for numeric data. The number of channels in the
 symbol can be between 3 and 8 and this can be specified by setting the value of
 the --vers option (API option_2). It can also be determined by the length of the
-input data e.g. a three character input string generates a 4 channel code by
+input data: e.g. a three character input string generates a 4 channel code by
 default.
 
 The maximum values permitted depend on the number of channels used as shown in
@@ -3721,6 +3721,10 @@ GS1 data may be encoded using FNC1 (default) or GS (Group Separator, ASCII 29)
 as separator. Use the option --gssep to change to GS (API
 output_options |= GS1_GS_SEPARATOR).
 
+By default Zint uses a “de facto” codeword placement for symbols of size 144 x
+144 (version 24). To override this and use the now clarified ISO/IEC standard
+placement, use option --dmiso144 (API option_3 |= DM_ISO_144).
+
 For a faster but less optimal encoding, the --fast option (API
 input_mode |= FAST_MODE) may be used.
 
@@ -4842,10 +4846,16 @@ OPTIONS
     Send output to stdout, which in most cases should be re-directed to a pipe
     or a file. Use --filetype to specify output format.
 
+--dmiso144
+
+    For Data Matrix symbols, use the standard ISO/IEC codeword placement for 144
+    x 144 (--vers=24) sized symbols, instead of the default “de facto” placement
+    (which rotates the placement of ECC codewords).
+
 --dmre
 
     For Data Matrix symbols, allow Data Matrix Rectangular Extended (DMRE) sizes
-    when considering automatic sizes.
+    when considering automatic sizes. See also --square.
 
 --dotsize=NUMBER
 
@@ -5122,7 +5132,7 @@ OPTIONS
 --square
 
     For Data Matrix symbols, exclude rectangular sizes when considering
-    automatic sizes.
+    automatic sizes. See also --dmre.
 
 --structapp=I,C[,ID]
 

docs/templates/styles.html

@@ -13,6 +13,7 @@ $endif$
   background-color: $if(backgroundcolor)$$backgroundcolor$$else$#ffffff$endif$;
 }
 body {
+  line-height: 1.2;
   margin: 0 auto;
   max-width: $if(maxwidth)$$maxwidth$$else$50em$endif$;
   padding-left: $if(margin-left)$$margin-left$$else$50px$endif$;

docs/zint.1

@@ -135,9 +135,16 @@ Send output to stdout, which in most cases should be re-directed to a
 pipe or a file.
 Use \f[V]--filetype\f[R] to specify output format.
 .TP
+\f[V]--dmiso144\f[R]
+For Data Matrix symbols, use the standard ISO/IEC codeword placement for
+144 x 144 (\f[V]--vers=24\f[R]) sized symbols, instead of the default
+\[lq]de facto\[rq] placement (which rotates the placement of ECC
+codewords).
+.TP
 \f[V]--dmre\f[R]
 For Data Matrix symbols, allow Data Matrix Rectangular Extended (DMRE)
 sizes when considering automatic sizes.
+See also \f[V]--square\f[R].
 .TP
 \f[V]--dotsize=NUMBER\f[R]
 Set the radius of the dots in dotty mode (\f[V]--dotty\f[R]).
@@ -438,6 +445,7 @@ Use small text for Human Readable Text (HRT).
 \f[V]--square\f[R]
 For Data Matrix symbols, exclude rectangular sizes when considering
 automatic sizes.
+See also \f[V]--dmre\f[R].
 .TP
 \f[V]--structapp=I,C[,ID]\f[R]
 Set Structured Append info, where \f[I]I\f[R] is the 1-based index,

docs/zint.1.pmd

@@ -106,9 +106,15 @@ Paintbrush (`PCX`), Portable Network Format (`PNG`), Scalable Vector Graphic (`S
 :   Send output to stdout, which in most cases should be re-directed to a pipe or a file. Use `--filetype` to specify
     output format.
 
+`--dmiso144`
+
+:   For Data Matrix symbols, use the standard ISO/IEC codeword placement for 144 x 144 (`--vers=24`) sized symbols,
+    instead of the default "de facto" placement (which rotates the placement of ECC codewords).
+
 `--dmre`
 
-:   For Data Matrix symbols, allow Data Matrix Rectangular Extended (DMRE) sizes when considering automatic sizes.
+:   For Data Matrix symbols, allow Data Matrix Rectangular Extended (DMRE) sizes when considering automatic sizes. See
+    also `--square`.
 
 `--dotsize=NUMBER`
 
@@ -361,7 +367,7 @@ Paintbrush (`PCX`), Portable Network Format (`PNG`), Scalable Vector Graphic (`S
 
 `--square`
 
-:   For Data Matrix symbols, exclude rectangular sizes when considering automatic sizes.
+:   For Data Matrix symbols, exclude rectangular sizes when considering automatic sizes. See also `--dmre`.
 
 `--structapp=I,C[,ID]`