<?xml version="1.0"?>

<!-- This is a test document for Australia Post 4-state barcodes  generator -->

<doc title="Australia Post 4-state barcodes">
  <para>
    This document contains several examples of 4-state barcodes
    used by Australia Post. A special stylesheet encodes barcode information
    into a string of digits (sequence of bar states) and then draws them in SVG.
    On the left, final barcodes are shown; on the right, barcode generator
    stylesheet input parameters are listed.
  </para>
  <para>
    Validity of the samples below has been checked with barcode generators provided
    by Australia Post. However, our stylesheet supports more
    input combinations than reference implementations; validity
    of barcodes in these additional formats could not be assessed
    independently.
  </para>

  <para>
    Barcode generator parameters have the following meaning:
    <para>
    "FCC" - a two-digit number identifying type of the barcode to be generated
             (mandatory).
    </para>
    <para>
    "DPID" - an eigth-digit number representing the "Delivery Point Identifier"
             (mandatory).
    </para>
    <para>
    "CI" - a "Customer Information" field (optional; used with Customer Barcodes 2 or 3).
    </para>  
    <para>
    "CIencoding"  - customer encoding type: defines how information supplied
                    in a "CI" parameter should be treated.
    </para>
  </para>
  <para>
    Please refer to explanations inside the 4state-au.xsl stylesheet for more information
    about the stylesheet usage.
  </para>
  
  <barcodes>
  <barcode FCC="11" DPID="39549554" CI="" CIencoding="">
    <description>
    "Standard Customer Barcode". The whole barcode is 37 bars long and contains
    no customer information.
    (This barcode is used as an example in the "Guide to Printing the 4-State Barcode")
    </description>
  </barcode>

  <barcode FCC="45" DPID="39549554" CI="" CIencoding="">
    <description>
    "Reply Paid Barcode". The whole barcode is also 37 bars long;
    its properties are essentially the same as for the "Standard Customer Barcode".
    </description>
  </barcode>

  <barcode FCC="59" DPID="12345678" CI="8765" CIencoding="N">
    <description>
    "Customer Barcode 2" with numeric customer information encoded using 'N' table.
    The whole barcode is 52 bars long. Customer information can be up to 16 bars long 
    (which corresponds to 8 digits in the 'N' encoding). In this example, customer data  
    are padded with eight filler bars (bar state '3').
    </description>
  </barcode>

  <barcode FCC="59" DPID="56439111" CI="ABA 9" CIencoding="C">
    <description>
    "Customer Barcode 2" with alpha-numeric customer information encoded using 'C' table.
    (This barcode is used as an example in the "Guide to Printing the 4-State Barcode").
    The whole barcode is 52 bars long. Customer information can be up to 16 bars long which
    corresponds to 5 characters in 'N' encoding. In this example, customer data has the maximum
    length; it is padded with a single filler bar (bar state '3').
    </description>
  </barcode>

  <barcode FCC="59" DPID="56439111" CI="0000010000033223" CIencoding="custom">
    <description>
    "Customer Barcode 2" with customer information already encoded in bar states.
    This allows customers to use any private encoding besides 'C' and 'N' tables.
    In this example, the customer information represents the same "ABA 9"
    string encoded using "C" table as in the previous example; the resulting 
    barcode should therefore be identical to the previous one.
    </description>
  </barcode>

  <barcode FCC="62" DPID="12345678" CI="STATE SZ#6" CIencoding="C">
    <description>
    "Customer Barcode 3" with alpha-numeric customer information encoded using 'C' table.
    The whole barcode is 67 bars long. Customer information can be up to 31 bars long which
    corresponds to 10 characters in 'C' encoding. In this example, customer data already
    has the maximum length; it is padded with a single filler bar (bar state '3').
    </description>
  </barcode>

  <barcode FCC="62" DPID="10913627" CI="123456789009876" CIencoding="N">
    <description>
    "Customer Barcode 3" with numeric customer information encoded using 'N' table.
    The whole barcode is 67 bars long. Customer information can be up to 31 bars long which
    corresponds to 15 digits in 'N' encoding. In this example, customer data has the maximum
    length; it is padded with a single filler bar (bar state '3').
    </description>
  </barcode>

  <barcode FCC="62" DPID="19563573" CI="01300112020131020301" CIencoding="custom">
    <description>
    "Customer Barcode 3" with customer information already encoded in bar states.
    The whole barcode is 67 bars long. Customer information can be up to 31 bars long.
    In this example, customer data is 20 bars long: it is padded with 11 
    filler bars ('3') to the total of 31 bars.
    </description>
  </barcode>
  </barcodes>
</doc>