File: appendixd.docbook

package info (click to toggle)
gnucash-docs 5.13-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 164,260 kB
  • sloc: xml: 101,090; ruby: 229; makefile: 59; sh: 8
file content (1018 lines) | stat: -rw-r--r-- 33,187 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE appendix SYSTEM "gnc-gui-zh.dtd">
<!-- (Do not remove this comment block.)
  Version: 2.0.0
  Last modified: March 18th, 2007
  Maintainers:
    Chris Lyttle <chris@wilddev.net>
  Author:
    David Hampton <hampton@employees.org>
  Translators:
    (translators put your name and email here)
-->
<appendix id="appendixd">
  <title>Auxiliary File Formats</title>

  <para>These are the formats of some auxiliary files used by &app;.
  </para>

  <sect1 id="check_format_info">
    <title>Check Format Files (<filename>*.chk</filename>)</title>

    <sect2 id="check_format_overview">
      <title>Overview</title>

      <para>The check format file is used to tell &app; how to print a check or checks onto a page of paper.
        This file first describes the overall layout of a page (number of checks, orientation, etc)
        and then describes the layout of the specific items on a single check. The file is organized
        as a typical Key/Value file used by many &lin; applications. Keys/values pairs are grouped
        into sections that begin with the group name enclosed in square brackets.
      </para>

      <para>&app; looks for check format files in two different locations when you bring up the check printing
        dialog. The first location is typically
        <filename class="directory">/usr/share/gnucash/checks</filename>, where check files
        distributed with the application can be found. The second location is the user private
        <filename class="directory">&dir-data;checks</filename>
        <footnote id="dir-old-chk">
          <para>Up to &app; 2.6.21 it was <filename class="directory">&dir-old;checks</filename>
          </para>
        </footnote>
        directory. Users may add check formats at any time (even while &app; is running) simply by
        dropping a new <filename>*.chk</filename> file in this directory. The next time the check
        printing dialog is opened the new check format will appear in the list of available check
        formats.
      </para>

      <note>
        <para>Printing functions differently depending on the version of GTK that is installed on your system.
          When &app; is using a version of GTK prior to 2.10 all offsets are measured from the lower
          left corner of the page or check. When using GTK 2.10 or later, all offsets are measured
          from the upper left corner of the page or check.
        </para>
      </note>
    </sect2>

    <sect2>
      <title>Example file</title>

      <para>A typical &app; check file is presented below. The contents of this file will be described in the
        next sections.
      </para>
<programlisting language="ini">[Top]
Guid = 67b144d1-96a5-48d5-9337-0e1083bbf229
Title = Quicken/QuickBooks (tm) US-Letter
Rotation = 0.0
Translation = 0.0;4.0
Show_Grid = false
Show_Boxes = false

[Check Positions]
Height = 252.0
Names = Top;Middle;Bottom

[Check Items]
Type_1 = PAYEE
Coords_1 = 90.0;102.0;400.0;20.0

Type_2 = AMOUNT_WORDS
Coords_2 = 90.0;132.0

Type_3 = AMOUNT_NUMBER
Blocking_Chars_3 = true
Coords_3 = 500.0;102.0

Type_4 = DATE
Coords_4 = 500.0;67.0

Type_5 = NOTES
Coords_5 = 50.0;212.0</programlisting>
    </sect2>

    <sect2>
      <title>Field Descriptions</title>

      <sect3>
        <title>Top Group</title>

        <para>This section of the check file describes the overall layout of a page of checks (or check) that goes
          into the printer.
        </para>

        <table id="check_table_top">
          <title>Overall Page Description Fields</title>

          <tgroup cols="4">
            <thead>
              <row>
                <entry>
                  Name
                </entry>

                <entry>
                  Type
                </entry>

                <entry>
                  Required
                </entry>

                <entry>
                  Description
                </entry>
              </row>
            </thead>

            <tbody>
              <row>
                <entry>
                  Guid
                </entry>

                <entry>
                  string
                </entry>

                <entry>
                  mandatory
                </entry>

                <entry>
                  The guid is used to uniquely identify a check format to &app;. It must be unique
                  across the entire set of application supplied and user supplied check formats. If
                  you copy an application check file as the basis of your own check format, you must
                  change this value. The <emphasis>uuidgen</emphasis> program may be used to
                  generate these identifiers.
                </entry>
              </row>

              <row>
                <entry>
                  Title
                </entry>

                <entry>
                  string
                </entry>

                <entry>
                  mandatory
                </entry>

                <entry>
                  The title is used to uniquely identify a check format to the user. This value is
                  presented verbatim in the check format list of the check printing dialog. If you
                  copy an application check file as the basis of your own check format, you should
                  change this value. The title may be any utf-8 string.
                </entry>
              </row>

              <row>
                <entry>
                  Font
                </entry>

                <entry>
                  string
                </entry>

                <entry>
                  optional
                </entry>

                <entry>
                  If supplied, this is the default font used to print all text items on this check.
                  This field can contain any string that is acceptable by gtk as a font specifier.
                  If this field is omitted, the default font is the font specified in the &app;
                  preferences dialog. A typical string would be <quote>sans 12</quote>.
                </entry>
              </row>

              <row>
                <entry>
                  Blocking_Chars
                </entry>

                <entry>
                  boolean
                </entry>

                <entry>
                  optional
                </entry>

                <entry>
                  If supplied, this is the default used when printing all <emphasis>TEXT</emphasis>
                  items on this check. When set to true, will print <emphasis>***</emphasis> before
                  and after each text field on the check. Blocking characters are printed to protect
                  check fields from alteration. For example, the amount field may be printed as
                  <emphasis>***100.00***</emphasis>
                </entry>
              </row>

              <row>
                <entry>
                  DateFormat
                </entry>

                <entry>
                  boolean
                </entry>

                <entry>
                  optional
                </entry>

                <entry>
                  If supplied, this is the default used when printing all <emphasis>DATE</emphasis>
                  items on this check. When set to true, will print the format of the DATE in 8
                  point type, centered and below the actual DATE. For example DDMMYYYY.
                </entry>
              </row>

              <row>
                <entry>
                  Rotation
                </entry>

                <entry>
                  double
                </entry>

                <entry>
                  optional
                </entry>

                <entry>
                  This value specified the rotation of the entire page (in degrees) around the
                  origin point. For gtk versions prior to 2.10, the origin point is in the lower
                  left corner of the page and rotation values increase in the counter-clockwise
                  direction. For gtk version 2.10 and later, the origin point is in the upper left
                  corner of the page and rotation values increase in the clockwise direction.
                  Rotation of the page is applied before translation.
                </entry>
              </row>

              <row>
                <entry>
                  Translation
                </entry>

                <entry>
                  list of 2 doubles
                </entry>

                <entry>
                  optional
                </entry>

                <entry>
                  These values specify the x and y translation of the entire page (in points)
                  relative to the origin point. For gtk versions prior to 2.10, the origin point is
                  in the lower left corner of the page and translation values increase moving up and
                  to the right. For gtk version 2.10 and later, the origin point is in the upper
                  left corner of the page and translation values increase moving down and to the
                  right. Rotation of the page is applied before translation.
                </entry>
              </row>

              <row>
                <entry>
                  Show_Grid
                </entry>

                <entry>
                  boolean
                </entry>

                <entry>
                  optional
                </entry>

                <entry>
                  If this value is set to <emphasis>true</emphasis> then &app; will draw a grid on
                  the page, starting at the origin with the lines spaced every 50 points. This can
                  be helpful when creating a check format file.
                </entry>
              </row>

              <row>
                <entry>
                  Show_Boxes
                </entry>

                <entry>
                  boolean
                </entry>

                <entry>
                  optional
                </entry>

                <entry>
                  If this value is set to <emphasis>true</emphasis> then for each item where the
                  width and height have been specified, &app; will draw a box showing location and
                  maximum size of that item . This can be helpful when creating a check format file.
                </entry>
              </row>
            </tbody>
          </tgroup>
        </table>

        <note>
          <para>The Blocking_Chars and DateFormat options are defined for all check formats in
            Edit->Preferences->Printing. It is recommened that these global options be set to false
            (the default), and that the options be set for individual Check Items as described
            below.
          </para>
        </note>
      </sect3>

      <sect3>
        <title>Check Positions Group</title>

        <para>This group of items specifies how multiple checks are laid out on the same sheet of paper, and gives
          names to each of these check locations so that a user can specify which check location
          that &app; should print. This entire group of key/value pairs is optional, and should be
          omitted if the format file only specifies a single check per page of paper.
        </para>

        <table id="check_table_positions">
          <title>Multiple Checks Per Page Fields</title>

          <tgroup cols="4">
            <thead>
              <row>
                <entry>
                  Name
                </entry>

                <entry>
                  Type
                </entry>

                <entry>
                  Required
                </entry>

                <entry>
                  Description
                </entry>
              </row>
            </thead>

            <tbody>
              <row>
                <entry>
                  Height
                </entry>

                <entry>
                  double
                </entry>

                <entry>
                  mandatory
                </entry>

                <entry>
                  This field specifies the height of a single check on the page. If there are
                  multiple checks per page then this item is mandatory. If there is only a single
                  check per page, this entire section should be omitted.
                </entry>
              </row>

              <row>
                <entry>
                  Names
                </entry>

                <entry>
                  list of strings
                </entry>

                <entry>
                  mandatory
                </entry>

                <entry>
                  This field specifies the names of the check locations that can be printed on each
                  page. These names represent the check positions starting from the top of the page
                  and moving downward. The names are presented verbatim in the check position list
                  of the check printing dialog. A typical value for this field is
                  "Top;Middle;Bottom", but it could also be "First;Second;Third" or any other set of
                  strings that clearly identify the check locations. If there are multiple checks
                  per page then this item is mandatory. If there is only a single check per page,
                  this entire section should be omitted.
                </entry>
              </row>
            </tbody>
          </tgroup>
        </table>
      </sect3>

      <sect3>
        <title>Check Items Group</title>

        <para>This section specifies the individual items that are printed on the check. There is no limit to the
          number of items that may be present in this section, and any given type of item can be
          repeated multiple times. This allows for the printing of checks that have a side stub, or
          for the one-per-page business checks that have both the check and multiple check stubs on
          the same page. For example, to print the payee name on a business check and on both stubs,
          simply specify three payee items with differing print coordinates.
        </para>

        <para>Each key names in this section explicitly includes the item number to which it applies. E.G. The key
          named <guilabel>Type_1</guilabel> applies to the first item to be printed, and the key
          <guilabel>Coords_3</guilabel> applies to the third item to be printed. Item numbers start
          at one and increase sequentially. Any gap in the numbering sequence is interpreted by
          &app; as the end of the item list. Items are printed in the order of their item numbers,
          not in the order in which they appear in the file.
        </para>

        <para>Each item specified must include a type declaration. The rest of the parameters for that item depend
          upon the particular type of that item. See <xref linkend="check_table_types"></xref> for a
          list of valid item types and their required parameters.
        </para>

        <table id="check_table_items">
          <title>Individual Check Item Fields</title>

          <tgroup cols="4">
            <thead>
              <row>
                <entry>
                  Name
                </entry>

                <entry>
                  Type
                </entry>

                <entry>
                  Required
                </entry>

                <entry>
                  Description
                </entry>
              </row>
            </thead>

            <tbody>
              <row>
                <entry>
                  Type_<emphasis>n</emphasis>
                </entry>

                <entry>
                  string
                </entry>

                <entry>
                  mandatory
                </entry>

                <entry>
                  This field specifies the type of a single item to be printed on a check. See
                  <xref linkend="check_table_types"></xref> for a list of valid item types.
                </entry>
              </row>

              <row>
                <entry>
                  Coords_<emphasis>n</emphasis>
                </entry>

                <entry>
                  list of 2 or 4 doubles
                </entry>

                <entry>
                  mandatory
                </entry>

                <entry>
                  This field specifies the coordinates where the item should be placed on a check,
                  and optionally also specifies the width and height of the item. The numbers in
                  order are the X and Y offset of the lower left corner of the item, and optionally
                  the width and height of the item. If the width is supplied then the height must
                  also be supplied, so this field will always contain two or four numbers. For gtk
                  versions prior to 2.10, the origin point is in the lower left corner of the page
                  and translation values increase moving up and to the right. For gtk version 2.10
                  and later, the origin point is in the upper left corner of the page and
                  translation values increase moving down and to the right.
                  <note>
                    <para>Regardless of whether the origin is at the top or the bottom of the page, the coordinates always
                      specify the lower left point of the item.
                    </para>
                  </note>
                </entry>
              </row>

              <row>
                <entry>
                  Font_<emphasis>n</emphasis>
                </entry>

                <entry>
                  string
                </entry>

                <entry>
                  optional
                </entry>

                <entry>
                  If supplied, this is the font used to print this specific text item. This field
                  can contain any string that is acceptable by gtk as a font specifier. If this
                  field is omitted, the default font is the font specified in the
                  <emphasis>Top</emphasis> section of the check description file, or if that was
                  omitted the font specified in the &app; preferences dialog. This field is only
                  recognized when using gtk version 2.10 or later.
                </entry>
              </row>

              <row>
                <entry>
                  Align_<emphasis>n</emphasis>
                </entry>

                <entry>
                  string
                </entry>

                <entry>
                  optional
                </entry>

                <entry>
                  If supplied, this is the alignment used to print this specific text item. This
                  field must contain one of the strings <quote>left</quote>, <quote>center</quote>
                  or <quote>right</quote>. If this field is omitted, the text will be left aligned.
                  This field is only recognized when using gtk version 2.10 or later.
                </entry>
              </row>

              <row>
                <entry>
                  Text_<emphasis>n</emphasis>
                </entry>

                <entry>
                  string
                </entry>

                <entry>
                  optional
                </entry>

                <entry>
                  This field is only used when the item type is <emphasis>TEXT</emphasis>. It
                  specifies the utf-8 text that should be printed on the check.
                </entry>
              </row>

              <row>
                <entry>
                  Filename_<emphasis>n</emphasis>
                </entry>

                <entry>
                  string
                </entry>

                <entry>
                  optional
                </entry>

                <entry>
                  This field is only used when the item type is <emphasis>PICTURE</emphasis>. It
                  specifies the filename of the image that should be printed on the check. The
                  string may specify either an absolute path name or as a relative path name. If a
                  relative path name is specified, &app; first looks in in the application check
                  format folder (typically
                  <filename class="directory">/usr/share/gnucash/checks</filename> ) for the image
                  file, and if it is not found there then it looks in the user private
                  <filename class="directory">&dir-data;checks</filename><footnoteref linkend="dir-old-chk" />
                  directory for the image. This field is only recognized when using gtk version 2.10
                  or later.
                </entry>
              </row>

              <row>
                <entry>
                  Blocking_Chars_<emphasis>n</emphasis>
                </entry>

                <entry>
                  boolean
                </entry>

                <entry>
                  optional
                </entry>

                <entry>
                  If supplied, this will set the print <emphasis>Blocking_Chars</emphasis> option
                  for this item.
                </entry>
              </row>

              <row>
                <entry>
                  DateFormat_<emphasis>n</emphasis>
                </entry>

                <entry>
                  boolean
                </entry>

                <entry>
                  optional
                </entry>

                <entry>
                  If supplied, this will set the print <emphasis>DateFormat</emphasis> option for
                  this item.
                </entry>
              </row>
            </tbody>
          </tgroup>
        </table>

        <para>These are the individual items that can be printed on a check. All items require the coordinates on
          the page where the item should be printed. The majority of these items result in text
          being printed on the page, and these items may have individual font and alignments
          specified. For example, the numerical amount of a check could be printed right justified
          while everything else is printed left justified. Other types may have unique parameters.
        </para>

        <table id="check_table_types">
          <title>Individual Check Item Types</title>

          <tgroup cols="4">
            <thead>
              <row>
                <entry>
                  Name
                </entry>

                <entry>
                  Required Fields
                </entry>

                <entry>
                  Optional Fields
                </entry>

                <entry>
                  Description
                </entry>
              </row>
            </thead>

            <tbody>
              <row>
                <entry>
                  PAYEE
                </entry>

                <entry>
                  Coords
                </entry>

                <entry>
<literallayout>Font
Align
Blocking_Chars</literallayout>
                </entry>

                <entry>
                  This type value tells &app; to print the check payee name at the specified
                  coordinates.
                </entry>
              </row>

              <row>
                <entry>
                  DATE
                </entry>

                <entry>
                  Coords
                </entry>

                <entry>
<literallayout>Font
Align
Blocking_Chars
DateFormat</literallayout>
                </entry>

                <entry>
                  This type value tells &app; to print the check date at the specified coordinates.
                </entry>
              </row>

              <row>
                <entry>
                  NOTES
                </entry>

                <entry>
                  Coords
                </entry>

                <entry>
<literallayout>Font
Align
Blocking_Chars</literallayout>
                </entry>

                <entry>
                  This type value tells &app; to print the transaction notes field at the specified
                  coordinates.
                </entry>
              </row>

              <row>
                <entry>
                  CHECK_NUMBER
                </entry>

                <entry>
                  Coords
                </entry>

                <entry>
<literallayout>Font
Align
Blocking_Chars</literallayout>
                </entry>

                <entry>
                  This type value tells &app; to print the check number at the specified
                  coordinates. The check number reflects the book option selection under
                  <menuchoice>
                    <guimenu>File</guimenu><guimenuitem>Properties</guimenuitem>
                  </menuchoice>
                  for number source (transaction number or anchor-split action - see
                  <ulink url="&url-docs-C;manual/book-options.html#num-action-book-option">Use Split
                  Action Field for Number</ulink> in the Book Options section of the &app; Manual).
                </entry>
              </row>

              <row>
                <entry>
                  MEMO
                </entry>

                <entry>
                  Coords
                </entry>

                <entry>
<literallayout>Font
Align
Blocking_Chars</literallayout>
                </entry>

                <entry>
                  This type value tells &app; to print the split memo field at the specified
                  coordinates.
                </entry>
              </row>

              <row>
                <entry>
                  ACTION
                </entry>

                <entry>
                  Coords
                </entry>

                <entry>
<literallayout>Font
Align
Blocking_Chars</literallayout>
                </entry>

                <entry>
                  This type value tells &app; to print the split action field at the specified
                  coordinates. However, the printed field reflects the book option selection under
                  <menuchoice>
                    <guimenu>File</guimenu><guimenuitem>Properties</guimenuitem>
                  </menuchoice>
                  for number source (transaction number or anchor-split action - see
                  <ulink url="&url-docs-C;manual/book-options.html#num-action-book-option">Use Split
                  Action Field for Number</ulink> in the Book Options section of the &app; Manual).
                  If number source for the book is specified as anchor-split action, this field will
                  instead print the transaction number field.
                </entry>
              </row>

              <row>
                <entry>
                  AMOUNT_WORDS
                </entry>

                <entry>
                  Coords
                </entry>

                <entry>
<literallayout>Font
Align
Blocking_Chars</literallayout>
                </entry>

                <entry>
                  This type value tells &app; to print the check amount in words at the specified
                  coordinates. The amount will appear similar to the string "One thousand, two
                  hundred thirty four and 56/100".
                </entry>
              </row>

              <row>
                <entry>
                  AMOUNT_NUMBER
                </entry>

                <entry>
                  Coords
                </entry>

                <entry>
<literallayout>Font
Align
Blocking_Chars</literallayout>
                </entry>

                <entry>
                  This type value tells &app; to print the check amount in numbers at the specified
                  coordinates. The amount will appear similar to the number "$1,234.56".
                </entry>
              </row>

              <row>
                <entry>
                  ADDRESS
                </entry>

                <entry>
                  Coords
                </entry>

                <entry>
<literallayout>Font
Align
Blocking_Chars</literallayout>
                </entry>

                <entry>
                  This type value tells &app; to print the address at the specified coordinates.
                </entry>
              </row>

              <row>
                <entry>
                  SPLITS_ACCOUNT
                </entry>

                <entry>
                  Coords
                </entry>

                <entry>
<literallayout>Font
Align
Blocking_Chars</literallayout>
                </entry>

                <entry>
                  This type value tells &app; to print the account names for each split entry
                  stating at the specified coordinates. See the note on splits printing.
                </entry>
              </row>

              <row>
                <entry>
                  SPLITS_AMOUNT
                </entry>

                <entry>
                  Coords
                </entry>

                <entry>
<literallayout>Font
Align
Blocking_Chars</literallayout>
                </entry>

                <entry>
                  This type value tells &app; to print the amount for each split entry stating at
                  the specified coordinates. Amounts are printed with currency symbols. See the note
                  on splits printing.
                </entry>
              </row>

              <row>
                <entry>
                  SPLITS_MEMO
                </entry>

                <entry>
                  Coords
                </entry>

                <entry>
<literallayout>Font
Align
Blocking_Chars</literallayout>
                </entry>

                <entry>
                  This type value tells &app; to print the memo text for each split entry stating at
                  the specified coordinates. See the note on splits printing.
                </entry>
              </row>

              <row>
                <entry>
                  TEXT
                </entry>

                <entry>
                  Coords, Text
                </entry>

                <entry>
<literallayout>Font
Align
Blocking_Chars</literallayout>
                </entry>

                <entry>
                  This type value tells &app; to print an arbitrary string at the specified
                  coordinates. The string to be printed is specified with the
                  <emphasis>Text_n</emphasis> key.
                </entry>
              </row>

              <row>
                <entry>
                  PICTURE
                </entry>

                <entry>
                  Coords, Filename
                </entry>

                <entry>
                  (none)
                </entry>

                <entry>
                  This type value tells &app; to print an image at the specified coordinates. The
                  image to be printed is specified with the <emphasis>Filename_n</emphasis> key.
                  This type is only recognized when using gtk version 2.10 or later.
                </entry>
              </row>
            </tbody>
          </tgroup>
        </table>

        <note>
          <para>SPLIT items include all split entries for the transaction except for the split that applies to the
            current account register (referred to as the anchor-split). This is usually the last
            split listed when splits are displayed in the register. The coordinate location defines
            the lower left location for the split information.
          </para>
        </note>
      </sect3>
    </sect2>

    <sect2 id="check_format_notes">
      <title>Creating Check Format Files</title>

      <para>Creating your own check format file is a fairly simple task. The easiest way to start is to copy an
        existing check format file from the application directory (typically
        <filename class="directory">/usr/share/gnucash/checks</filename>) to the directory
        <filename class="directory">&dir-data;checks</filename><footnoteref linkend="dir-old-chk" />.
        Make sure to change the guid so the new file will be accepted by gnucash, and change the
        title to something descriptive. Then change or add individual item fields as necessary. You
        can also create a new check file by clicking the <guibutton>Save Format</guibutton> button
        on the <guilabel>Custom format</guilabel> page of the check printing dialog.
      </para>

      <note>
        <para>Key names are case sensitive. If you are having problems with a check format file, ensure that all
          key names have capital letters as documented above.
        </para>
      </note>
    </sect2>
  </sect1>
</appendix>