Provided by: barcode_0.98+debian-9_amd64 bug

NAME

       barcode - a stand alone program to run the barcode library

SYNOPSIS

       barcode [-b - | string] [-e encoding] [-o - | outfile] [ other-flags ]

DESCRIPTION

       The information below is extracted from the texinfo file, which is the preferred source of
       information.

       The barcode program is a front-end to access some features of the library from the command
       line.   It  is  able  to  read  user supplied strings from the command line or a data file
       (standard input by default) and encode all of them.

OPTIONS

       barcode accepts the following options:

       --help or -h
              Print a usage summary and exit.

       -i filename
              Identify a file where strings to be encoded are read from. If missing (and if -b is
              not  used)  it defaults to standard input. Each data line of the input file will be
              used to create one barcode output.

       -o filename
              Output file. It defaults to standard output.

       -b string
              Specify a single ``barcode'' string to be encoded.  The option can be used multiple
              times  in  order  to  encode  multiple  strings  (this  will  result  in multi-page
              postscript output or a table of barcodes if -t is  specified).   The  strings  must
              match  the encoding chosen; if it doesn't match the program will print a warning to
              stderr and generate ``blank'' output (although not zero-length).  Please note  that
              a string including spaces or other special characters must be properly quoted.

       -e encoding
              encoding  is  the name of the chosen encoding format being used. It defaults to the
              value of the environment variable BARCODE_ENCODING or  to  auto  detection  if  the
              environment is also unset.

       -g geometry
              The  geometry  argument  is  of  the  form  ``[<width>  x  <height>] [+ <xmargin> +
              <ymargin>]'' (with no intervening spaces). Unspecified margin values will result in
              no  margin;  unspecified  size  results  in  default  size.   The  specified values
              represent print points by default, and can be inches, millimeters  or  other  units
              according  to the -u option or the BARCODE_UNIT environment variable.  The argument
              is used to place the printout code on the  page.  Note  that  an  additional  white
              margin  of  10  points  is  added  to  the  printout. If the option is unspecified,
              BARCODE_GEOMETRY is looked up in the environment, if missing a default size and  no
              margin (but the default 10 points) are used.

       -t table-geometry
              Used to print several barcodes to a single page, this option is meant to be used to
              print stickers. The argument is of the form ``<columns> x <lines> [+ <leftmargin> +
              <bottommargin>  [-  <rightmargin> [- <topmargin>]]]'' (with no intervening spaces);
              if missing, the top and right margin will default to be the same as the bottom  and
              left  margin.  The margins are specified in print points or in the chosen unit (see
              -u below).  If the option is not specified,  BARCODE_TABLE  is  looked  up  in  the
              environment,  otherwise no table is printed and each barcode will get its own page.
              The size (but not the position) of a barcode  item  within  a  table  can  also  be
              selected  using  -g  (see  "geometry"  above), without struggling with external and
              internal margins.  I still think management of geometries in a table is suboptimal,
              but I can't make it better without introducing incompatibilities.

       -m margin(s)
              Specifies  an internal margin for each sticker in the table. The argument is of the
              form ``<xmargin>,<ymargin>''  and  the  margin  is  applied  symmetrically  to  the
              sticker.  If  unspecified,  the  environment  variable  BARCODE_MARGIN is used or a
              default internal margin of 10 points is used.

       -n     ``Numeric'' output: don't print the ASCII form of the code, only the bars.

       -c     No checksum character (for encodings that allow it, like code 39, other codes, like
              UPC or EAN, ignore this option).

       -E     Encapsulated  postscript  (default  is  normal  postscript).  When  the  output  is
              generated as EPS only one barcode is encoded.

       -P     PCL output. Please note that the Y direction goes from top to bottom for  PCL,  and
              the origin for an image is the top-left corner instead of the bottom-left

       -p pagesize
              Specify  a  non-default  page  size. The page size can be specified in millimeters,
              inches or plain numbers (for example: "210x297mm", "8.5x11in", "595x842").  A  page
              specification  as  numbers  will  be  interpreted  according  to  the  current unit
              specification (see -u below). If libpaper is available, you can  also  specify  the
              page size with its name, like "A3" or "letter" (libpaper is a standard component of
              Debian GNU/Linux, but may be missing elsewhere). The  default  page  size  is  your
              system-wide default if libpaper is there, A4 otherwise.

       -u unit
              Choose  the  unit  used in size specifications. Accepted values are ``mm'', ``cm'',
              ``in'' and  ``pt''.  By  default,  the  program  will  check  BARCODE_UNIT  in  the
              environment,  and  assume  points otherwise (this behaviour is compatible with 0.92
              and previous versions. If -u appears more than once, each  instance  will  modified
              the behaviour for the arguments at its right, as the command line is processes left
              to right. The program internally works with points, and any size is approximated to
              the  nearest  multiple of one point. The -u option affect -g (geometry), -t (table)
              and -p (page size).

ENCODING TYPES

       The program encodes text strings passed either on the command line (with -b) or  retrieved
       from  standard  input.  The  text representation is interpreted according to the following
       rules. When auto-detection of the encoding is enabled (i.e, no explicit encoding  type  is
       specified),  the  encoding  types are scanned to find one that can digest the text string.
       The following list of supported types is sorted in the same order the  library  uses  when
       auto-detecting a suitable encoding for a string.

       EAN    The  EAN  frontend  is  similar  to  UPC;  it  accepts  strings  of digits, 12 or 7
              characters long. Strings of 13  or  8  characters  are  accepted  if  the  provided
              checksum  digit  is correct.  I expect most users to feed input without a checksum,
              though. The add-2 and add-5 extension are accepted for  both  the  EAN-13  and  the
              EAN-8   encodings.    The   following   are   example   of   valid  input  strings:
              ``123456789012'' (EAN-13), ``1234567890128'' (EAN-13  wih  checksum),   ``1234567''
              (EAN-8),  ``12345670  12345''  (EAN-8 with checksum and add-5), ``123456789012 12''
              (EAN-13 with add-2), ``123456789012 12345'' (EAN-13 with add-5).

       UPC    The UPC frontend accepts only strings made up of digits  (and,  if  a  supplemental
              encoding  is  used, a blank to separate it).  It accepts strings of 11 or 12 digits
              (UPC-A) and 6 or 7 or 8 digits (UPC-E).

       The 12th digit of UPC-A is the checksum and is added by the library if  not  specified  in
       the  input;  if  it is specified, it must be the right checksum or the code is rejected as
       invalid.  For UPC-E, 6 digit are considered to be the middle part of the code, a leading 0
       is  assumed  and  the  checksum  is added; 7 digits are either considered the initial part
       (leading digit 0 or 1, checksum missing) or the final part (checksum specified, leading  0
       assumed);  8  digits  are  considered  to  be  the  complete code, with leading 0 or 1 and
       checksum.  For both UPC-A and UPC-E, a trailing string of 2 digits or 5 digits is accepted
       as  well.  Therefore,  the  following are examples of valid strings that can be encoded as
       UPC: ``01234567890'' (UPC-A) ``012345678905'' (UPC-A with checksum),  ``012345''  (UPC-E),
       ``01234567890 12'' (UPC-A, add-2) and ``01234567890 12345'' (UPC-A, add-5), ``0123456 12''
       (UPC-E, add-2).  Please note that when setting BARCODE_ANY to auto-detect the encoding  to
       be  used,  12-digit  strings  and  7-digit  strings will always be identified as EAN. This
       because I expect most user to provide input without a checksum. If  you  need  to  specify
       UPC-with-checksum  as input you must explicitly set BARCODE_UPC as a flag or use -e upc on
       the command line.

       ISBN   ISBN numbers are encoded as EAN-13 symbols, with an  optional  add-5  trailer.  The
              ISBN  frontend  of  the library accepts real ISBN numbers and deals with any hyphen
              and,  if  present,  the  ISBN  checksum  character  before  encoding  data.   Valid
              representations    for   ISBN   strings   are   for   example:   ``1-56592-292-1'',
              ``3-89721-122-X'' and ``3-89721-122-X 06900}''.

       code 128-B
              This encoding can represent all of the printing ASCII characters,  from  the  space
              (32) to DEL (127). The checksum digit is mandatory in this encoding.

       code 128-C
              The  ``C'' variation of Code-128 uses Code-128 symbols to represent two digits at a
              time (Code-128 is made up of 104 symbols whose interpretation is controlled by  the
              start  symbol being used). Code 128-C is thus the most compact way to represent any
              even number of digits. The encoder refuses to deal with an  odd  number  of  digits
              because  the  caller  is  expected  to  provide proper padding to an even number of
              digits.  (Since  Code-128  includes  control  symbols  to  switch  charset,  it  is
              theoretically  possible to represent the odd digit as a Code 128-A or 128-B symbol,
              but this tool doesn't currently implement this option).

       code 128 raw
              Code-128 output represented symbol-by-symbol in the input string.  To override part
              of  the problems outlined below in specifying code128 symbols, this pseudo-encoding
              allows the used to specify a list of code128  symbols  separated  by  spaces.  Each
              symbol  is represented by a number in the range 0-105.  The list should include the
              leading character.The checksum and the stop character are  automatically  added  by
              the  library.  Most  likely this pseudo-encoding will be used with BARCODE_NO_ASCII
              and some external program to supply the printed text.

       code 39
              The code-39 standard can encode uppercase letters, digits, the blank  space,  plus,
              minus, dot, star, dollar, slash, percent.  Any string that is only composed of such
              characters is accepted by the code-39 encoder. To avoid  loosing  information,  the
              encoder  refuses  to  encode  mixed-case strings (a lowercase string is nonetheless
              accepted as a shortcut, but is encoded as uppercase).

       interleaved 2 of 5
              This encoding can  only  represent  an  even  number  of  digits  (odd  digits  are
              represented by bars, and even digits by the interleaving spaces). The name stresses
              the fact that two of the five items (bars or spaces) allocated to each  symbol  are
              wide,  while  the  rest are narrow. The checksum digit is optional (can be disabled
              via BARCODE_NO_CHECKSUM).  Since the number of digits, including the checksum, must
              be  even, a leading zero is inserted in the string being encoded if needed (this is
              specifically stated in the specs I have access to).

       code 128
              Automatic selection between alphabet A, B and C  of  the  Code-128  standard.  This
              encoding  can  represent  all  ASCII symbols, from 0 (NUL) to 127 (DEL), as well as
              four special symbols, named F1, F2, F3, F4. The set of symbols  available  in  this
              encoding  is  not  easily  represented  as  input  to  the  barcode library, so the
              following convention is used.  In the input string, which  is  a  C-language  null-
              terminated  string,  the  NUL char is represented by the value 128 (0x80, 0200) and
              the F1-F4 characters are represented by the values 193-196 (0xc1-0xc4,  0301-0304).
              The values have been chosen to ease their representation as escape sequences.

       Since  the  shell doesn't seem to interpret escape sequences on the command line, the "-b"
       option cannot be easily used to designate the strings to be encoded. As a  workaround  you
       can  resort  to  the command echo, either within back-ticks or used separately to create a
       file that is then fed to the standard-input of  barcode  --  assuming  your  echo  command
       processes escape sequences.  The newline character is especially though to encode (but not
       impossible unless you use a csh variant.

       These problems only apply to the command-line tool; the use of library  functions  doesn't
       give any problem. In needed, you can use the ``code 128 raw'' pseudo-encoding to represent
       code128 symbols by their numerical value. This encoding is used late in the auto-selection
       mechanism because (almost) any input string can be represented using code128.

       Codabar
              Codabar  can  encode the ten digits and a few special symbols (minus, plus, dollar,
              colon, bar, dot). The  characters  ``A'',  ``B'',  ``C''  and  ``D''  are  used  to
              represent  four  different  start/stop  characters. The input string to the barcode
              library can include the start and stop characters or not  include  them  (in  which
              case  ``A''  is  used as start and ``B'' as stop). Start and stop characters in the
              input string can be either all lowercase or all uppercase and are always printed as
              uppercase.

       Plessey
              Plessey  barcodes  can  encode all the hexadecimal digits. Alphabetic digits in the
              input string must either be all lowercase or all  uppercase.  The  output  text  is
              always uppercase.

       MSI    MSI  can only encode the decimal digits. While the standard specifies either one or
              two check digits, the current implementation in this  library  only  generates  one
              check digit.

       code 93
              The  code-93  standard  can  natively  encode  48  different  characters, including
              uppercase letters, digits, the blank space, plus, minus, dot, star, dollar,  slash,
              percent,  as  well  as  five  special  characters:  a start/stop delimiter and four
              "shift characters" used for extended encoding.    Using  this  "extended  encoding"
              method,  any  standard  7-bit  ASCII  character can be encoded, but it takes up two
              symbol lengths in barcode if the character is not natively supported  (one  of  the
              48).   The  encoder  here  fully  implements  the  code  93 encoding standard.  Any
              characters natively supported (A-Z, 0-9, ".+-/$ encoded as such  -  for  any  other
              characters  (such  as lower case letters, brackets, parentheses, etc.), the encoder
              will revert to extended encoding.  As a note, the option to  exclude  the  checksum
              will  eliminate  the two modulo-47 checksums (called C and K) from the barcode, but
              this probably will make it unreadable by 9 These checksums are specified to be used
              at the firmware level, and their absence will be interpreted as an invalid barcode.

PCL OUTPUT

       While  the  default  output  is  Postscript  (possibly  EPS),  and Postscript can be post-
       processed to almost anything, it is sometimes desirable to create output  directly  usable
       by  the specific printer at hand.  PCL is currently supported as an output format for this
       reason.  Please note that the Y coordinate for PCL goes from  top  to  bottom,  while  for
       Postscript  it  goes from bottom to top. Consistently, while in Postscript you specify the
       bottom-left corner as origin, for PCL you specify the top-left corner.

       Barcode output for PCL Printers (HP LaserJet and compatibles), was  developed  using  PCL5
       Reference manuals from HP.  that really refers to these printers:

       LaserJet III, III P, III D, III Si,

       LaserJet 4 family

       LaserJet 5 family

       LaserJet 6 family

       Color LaserJet

       DeskJet 1200 and 1600.

       However,  barcode  printing  uses  a  very  small subset of PCL, probably also LaserJet II
       should print it without problem, but the resulting text may be horrible.

       The only real difference from one printer to another really  depends  on  which  font  are
       available  in  the  printer,  used  in  printing  the  label  associated  to  the bars (if
       requested).

       Earlier LaserJet supports only bitmaps fonts, so these are not "scalable".  (Ljet  II  ?),
       Also  these  fonts,  when  available,  have a specified direction, and not all of them are
       available in both Portrait and Landscape mode.

       From LaserJet 4 series, (except 4L/5L that are entry-level printers), Arial scalable  font
       should be available, so it's the "default font" used by this program.

       LaserJet  III  series  printers (and 4L, 5L), don't feature "Arial" as a resident font, so
       you should use BARCODE_OUT_PCL_III instead of BARCODE_OUT_PCL., and  font  the  font  used
       will be "Univers" instead of "Arial".

       Results on compatible printers, may depend on consistency of PCL5 compatibility, in doubt,
       try BARCODE_OUT_PCL_III

       PJL commands are not used here, as it's not very compatible.

       Tested Printers:

       Hp LaserJet 4050

       Hp LaserJet 2100

       Epson N-1200 emul PCL

       Toshiba DP2570 (copier) + PCL option

       Epson EPL-7100 emul. HP LaserJet II: bars print fine but text is bad.

BUGS

       The current management of borders/margins is far  from  optimal.  The  ``default''  margin
       applied  by  the  library  interferes  with  the external representation, but I feel it is
       mandatory to avoid creating barcode output with no surrounding white space (the problem is
       especially relevant for EPS output).

       EAN-128  is  not  (yet)  supported.  I plan to implement it pretty soon and then bless the
       package as version 1.0.

SEE ALSO

       barcode(3)

AUTHORS

       Alessandro Rubini <rubini@gnu.org> (maintainer)

       Leonid A. Broukhis <leob@mailcom.com> (several encodings)

       Andrea Scopece <a.scopece@tin.it> (PCL output)