diff -ur --new-file barcode-0.93/.backupdate barcode-0.94/.backupdate --- barcode-0.93/.backupdate Fri Jun 25 08:47:22 1999 +++ barcode-0.94/.backupdate Sun Oct 24 13:10:56 1999 @@ -1 +1 @@ -Fri Jun 25 08:47:22 MEST 1999 +Sun Oct 24 13:10:56 MEST 1999 diff -ur --new-file barcode-0.93/ChangeLog barcode-0.94/ChangeLog --- barcode-0.93/ChangeLog Sun Sep 26 19:54:40 1999 +++ barcode-0.94/ChangeLog Sun Oct 24 12:50:37 1999 @@ -1,3 +1,17 @@ +1999-10-24 Alessandro Rubini + + * INSTALL: added instructions to install on a Debian GNU/Linux system + + * debian/*: edited information for proper Debian support + + * debian/rules (binary-arch): new file, from "deb-make" + + * Makefile.in (install): added "-m 0644" to install non-executables + + * code128.c (Barcode_128b_encode): fixed checksum calculation. + +====> Version 0.93 released to ftp.prosa.it and ftp.gnu.org + 1999-09-26 Alessandro Rubini * doc/doc.barcode: fixed the rendering of complex options (-g and -t) diff -ur --new-file barcode-0.93/INSTALL barcode-0.94/INSTALL --- barcode-0.93/INSTALL Thu Aug 19 10:19:13 1999 +++ barcode-0.94/INSTALL Sun Oct 24 12:50:21 1999 @@ -1,4 +1,7 @@ +Installing on generic Unix systems +---------------------------------- + The package includes both a library and a standalone program. To install everything try @@ -13,3 +16,16 @@ no access to non-gnu systems. If your operating system isn't able to compile barcode and you are willing to help porting, feel free to call me. + +Installing on Debian/GNU systems +-------------------------------- + +The suggested installation here includes creation of a Debian package: + + debian/rules binary + +Then, just install using dpkg: + + dpkg -i ../barcode-0.94_*.deb + +(the "*" here will represent your architecture: "i386", "alpha", "sparc", ...) diff -ur --new-file barcode-0.93/Makefile.in barcode-0.94/Makefile.in --- barcode-0.93/Makefile.in Sun Sep 26 12:56:33 1999 +++ barcode-0.94/Makefile.in Sun Oct 24 12:59:55 1999 @@ -58,11 +58,11 @@ $(INSTALL) -d $(BINDIR) $(INCDIR) $(LIBDIR) $(MAN1DIR) \ $(MAN3DIR) $(INFODIR) $(INSTALL) -c $(TARGET) $(BINDIR) - $(INSTALL) -c $(HEADER) $(INCDIR) - $(INSTALL) -c $(LIBRARY) $(LIBDIR) - $(INSTALL) -c $(MAN1) $(MAN1DIR) - $(INSTALL) -c $(MAN3) $(MAN3DIR) - $(INSTALL) -c $(INFO) $(INFODIR) + $(INSTALL) -c -m 0644 $(HEADER) $(INCDIR) + $(INSTALL) -c -m 0644 $(LIBRARY) $(LIBDIR) + $(INSTALL) -c -m 0644 $(MAN1) $(MAN1DIR) + $(INSTALL) -c -m 0644 $(MAN3) $(MAN3DIR) + $(INSTALL) -c -m 0644 $(INFO) $(INFODIR) uninstall: $(RM) -f $(BINDIR)/$(TARGET) @@ -83,6 +83,7 @@ $(MAKE) -C doc clean distclean: mostlyclean + if [ -f build ]; then debian/rules clean; fi # remove the configure stuff as well $(RM) -f Makefile config.h config.log config.status config.cache @@ -105,6 +106,7 @@ printv: @grep -n VERSION $(HEADER) /dev/null @grep -n set.version doc/doc.$(TARGET) /dev/null + @grep -n dpkg.-i INSTALL # and this is how I make the distribution distrib: $(INFO) distclean tar printv diff -ur --new-file barcode-0.93/README barcode-0.94/README --- barcode-0.93/README Fri Aug 6 11:00:59 1999 +++ barcode-0.94/README Sun Oct 24 12:52:11 1999 @@ -30,7 +30,8 @@ problem you encounter). [This paragraph copied verbatim from bookland.py] I would like to thank both Judah Milgram and Michele Comitini -(mcm@glisco.it) for their help with this tool +(mcm@glisco.it) for their help with this tool, as well as Jim Westveer +for introducing me to Debian packaging. /alessandro (rubini@prosa.it, rubini@gnu.org) diff -ur --new-file barcode-0.93/barcode.h barcode-0.94/barcode.h --- barcode-0.93/barcode.h Sun Sep 26 12:59:01 1999 +++ barcode-0.94/barcode.h Sun Oct 24 00:57:10 1999 @@ -24,8 +24,8 @@ #include -#define BARCODE_VERSION "0.93" -#define BARCODE_VERSION_INT 9300 +#define BARCODE_VERSION "0.94" +#define BARCODE_VERSION_INT 9400 /* * The object diff -ur --new-file barcode-0.93/code128.c barcode-0.94/code128.c --- barcode-0.93/code128.c Fri Aug 6 12:03:27 1999 +++ barcode-0.94/code128.c Wed Oct 13 08:35:29 1999 @@ -136,7 +136,7 @@ } code = text[i]-32; strcat(partial, codeset[code]); - checksum += code * i+1; /* first * 1 + second * 2 + third * 3... */ + checksum += code * (i+1); /* first * 1 + second * 2 + third * 3... */ sprintf(textptr, "%i:12:%c ", textpos, text[i]); textptr += strlen(textptr); textpos += SYMBOL_WID; /* width of each code */ diff -ur --new-file barcode-0.93/debian/README.debian barcode-0.94/debian/README.debian --- barcode-0.93/debian/README.debian Thu Jan 1 01:00:00 1970 +++ barcode-0.94/debian/README.debian Sun Oct 24 12:55:53 1999 @@ -0,0 +1,9 @@ +The Debian Package barcode +---------------------------- + +This Debian package is integrated in the upstream release of GNU +barcode, maintained by Alessandro Rubini (rubini@gnu.org, +rubini@prosa.it). Since I have no extended experience with Debian +packages, I'm willing to accept any fixes that seem fit, as well as a +real Debian maintainer for the Debian package. + diff -ur --new-file barcode-0.93/debian/changelog barcode-0.94/debian/changelog --- barcode-0.93/debian/changelog Thu Jan 1 01:00:00 1970 +++ barcode-0.94/debian/changelog Sun Oct 24 01:15:53 1999 @@ -0,0 +1,9 @@ +barcode (0.94) unstable; urgency=low + + * Initial Release. + + -- Alessandro Rubini Sun, 24 Oct 1999 01:10:23 +0200 + +Local variables: +mode: debian-changelog +End: diff -ur --new-file barcode-0.93/debian/control barcode-0.94/debian/control --- barcode-0.93/debian/control Thu Jan 1 01:00:00 1970 +++ barcode-0.94/debian/control Sun Oct 24 12:23:48 1999 @@ -0,0 +1,14 @@ +Source: barcode +Section: misc +Priority: optional +Maintainer: Alessandro Rubini +Standards-Version: 2.5.0 + +Package: barcode +Architecture: any +Depends: ${shlibs:Depends} +Description: Creates barcodes in .ps format + GNU barcode can create printouts for the conventional + product packagging standards: UPC-A, UPC-E, EAN-13, EAN-8, ISBN, code 39 + code 128 (b and c), and interleaved 2 of 5 . Ouput is generated as + either Postscript or Encapsulated Postscript. diff -ur --new-file barcode-0.93/debian/copyright barcode-0.94/debian/copyright --- barcode-0.93/debian/copyright Thu Jan 1 01:00:00 1970 +++ barcode-0.94/debian/copyright Sun Oct 24 12:26:54 1999 @@ -0,0 +1,8 @@ +This package was written by Alessandro Rubini rubini@gnu.org on Sun, 24 Oct 1999 01:10:23 +0200. + +The pristine source can be downloaded from ftp://ftp.gnu.org/pub/barcode +and GNU mirrors. Latest and greatest version (also beta) are immediately +uploaded to ftp://ftp.prosa.it/pub/software. + +Copyright: GPL (see /usr/doc/copyright/GPL) + diff -ur --new-file barcode-0.93/debian/dirs barcode-0.94/debian/dirs --- barcode-0.93/debian/dirs Thu Jan 1 01:00:00 1970 +++ barcode-0.94/debian/dirs Sun Oct 24 01:17:14 1999 @@ -0,0 +1,3 @@ +usr/bin +usr/include +usr/info diff -ur --new-file barcode-0.93/debian/info barcode-0.94/debian/info --- barcode-0.93/debian/info Thu Jan 1 01:00:00 1970 +++ barcode-0.94/debian/info Sun Oct 24 12:30:41 1999 @@ -0,0 +1,15 @@ +# This is a configuration files for installing a .info menu +# The Description to be placed into the directory +DESCR="Barcode library and frontend" + +# The section this info file should be placed in (Regexp) followed by +# the new section name to be created if the Regexp does not match +# (Optional. If not given the .info will be appended to the directory) +SECTION_MATCH="[cC]ommands" +SECTION_NAME="General Commands" + +# The file referred to from the Info directory +FILE=barcode.info + +# Optional. The files to be copied to /usr/info +FILES=doc/*.info diff -ur --new-file barcode-0.93/debian/rules barcode-0.94/debian/rules --- barcode-0.93/debian/rules Thu Jan 1 01:00:00 1970 +++ barcode-0.94/debian/rules Sun Oct 24 12:51:29 1999 @@ -0,0 +1,50 @@ +#!/usr/bin/make -f +# Made with the aid of debmake, by Christoph Lameter, +# based on the sample debian/rules file for GNU hello by Ian Jackson. + +package=barcode + +build: + $(checkdir) + ./configure --prefix=/usr + $(MAKE) CFLAGS="-O2 -g -Wall" + touch build + +clean: + $(checkdir) + -rm -f build + -$(MAKE) distclean + -rm -f `find . -name "*~"` + -rm -rf debian/tmp debian/files* core debian/substvars + +binary-indep: checkroot build + $(checkdir) +# There are no architecture-independent files to be uploaded +# generated by this package. If there were any they would be +# made here. + +binary-arch: checkroot build + $(checkdir) + -rm -rf debian/tmp + install -d debian/tmp + cd debian/tmp && install -d `cat ../dirs` + $(MAKE) install prefix=`pwd`/debian/tmp/usr +# Must have debmake installed for this to work. Otherwise please copy +# /usr/bin/debstd into the debian directory and change debstd to debian/debstd + debstd ChangeLog README TODO INSTALL + dpkg-gencontrol + chown -R root.root debian/tmp + chmod -R go=rX debian/tmp + dpkg --build debian/tmp .. + +define checkdir + test -f debian/rules +endef + +binary: binary-indep binary-arch + +checkroot: + $(checkdir) + test root = "`whoami`" + +.PHONY: binary binary-arch binary-indep clean checkroot diff -ur --new-file barcode-0.93/doc/barcode.html barcode-0.94/doc/barcode.html --- barcode-0.93/doc/barcode.html Sun Sep 26 19:53:40 1999 +++ barcode-0.94/doc/barcode.html Sun Oct 24 12:28:02 1999 @@ -1,14 +1,14 @@ + from barcode.texinfo on 24 October 1999 --> Barcode -

barcode 0.93

+

barcode 0.94

A library for drawing bar codes

-

September 1999

+

October 1999

by Alessandro Rubini (rubini@{gnu.org,prosa.it})

@@ -207,7 +207,7 @@

The Flags

-The following flags are supported by version 0.93 of the +The following flags are supported by version 0.94 of the library:

@@ -399,9 +399,11 @@ 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 with -e and no -error is printed if they don't match (this may be construed as -a bug). +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-lenght). +Please note that a string including spaces or +other special characters must be properly quoted.
-e encoding
@@ -601,7 +603,7 @@

-This document was generated on 26 September 1999 using the +This document was generated on 24 October 1999 using the texi2html translator version 1.51.

diff -ur --new-file barcode-0.93/doc/barcode.info barcode-0.94/doc/barcode.info --- barcode-0.93/doc/barcode.info Sun Sep 26 19:53:40 1999 +++ barcode-0.94/doc/barcode.info Sun Oct 24 12:28:01 1999 @@ -2,10 +2,10 @@ the input file barcode.texinfo. This file is the User's Manual for the barcode library (version -0.93). +0.94). - This file documents the 0.93 release of the barcode library and -sample programs (September 1999). + This file documents the 0.94 release of the barcode library and +sample programs (October 1999).  File: barcode.info, Node: Top, Next: Overview, Prev: (dir), Up: (dir) @@ -175,7 +175,7 @@ The Flags ********* - The following flags are supported by version 0.93 of the library: + The following flags are supported by version 0.94 of the library: `BARCODE_ENCODING_MASK' The mask is used to extract the encoding-type identifier from the @@ -328,9 +328,11 @@ 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 - with -e and no error is printed if they don't match (this may be - construed as a bug). + 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-lenght). 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 @@ -496,15 +498,15 @@  Tag Table: -Node: Top281 -Node: Overview492 -Node: The Barcode Object1370 -Node: The Field List2753 -Node: Supported Flags6479 -Node: The API8988 -Node: The barcode Executable11689 -Node: The Command Line12142 -Node: Supported Encodings16588 -Node: Bugs and Pending Issues20459 +Node: Top279 +Node: Overview490 +Node: The Barcode Object1368 +Node: The Field List2751 +Node: Supported Flags6477 +Node: The API8986 +Node: The barcode Executable11687 +Node: The Command Line12140 +Node: Supported Encodings16727 +Node: Bugs and Pending Issues20598  End Tag Table diff -ur --new-file barcode-0.93/doc/barcode.ps barcode-0.94/doc/barcode.ps --- barcode-0.93/doc/barcode.ps Sun Sep 26 19:53:40 1999 +++ barcode-0.94/doc/barcode.ps Sun Oct 24 12:28:01 1999 @@ -8,7 +8,7 @@ %DVIPSWebPage: (www.radicaleye.com) %DVIPSCommandLine: dvips -f barcode.dvi %DVIPSParameters: dpi=600, compressed -%DVIPSSource: TeX output 1999.09.26:1953 +%DVIPSSource: TeX output 1999.10.24:1227 %%BeginProcSet: texc.pro %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -1318,67 +1318,62 @@ 4886A34886A448864A82A4481B80A8B51AC0B3AA6C1B80A86C1B006E5EA46C62A36C62A3 6C6D4C5BA36C62A26C6D4C5BA26C6E4B5B6D616F92B5FC6D96C7FC6D6D4A5B6D6D4A5B6D 6D4A5B6D6D4A5B6D01FF023F5B6D02C090B55A6ED9F8075C021F90B648C8FC020716F802 -0116E06E6C1580030702F8C9FCDB003F90CAFC527379F061>48 D<923801FFFE033FEBFF -F84AB7FC020F16E0023F16F84A16FE49B97E49DA003F80010F01F0010714F04901800101 -804948C880D97FF86F7F02E081496C834801FC6F148014FF486E6E14C08181481AE081A9 -6C5C1BC06C4A5C6C5C6D90C815806D5AD90FF85D90CA150062606295B55A4D5C624D5C4D -5C4D91C7FC4D13FC4D5B4CB512E0047F1480037FB548C8FC92B612F818C018F8F0FF806F -15F092C7003F13FC050713FF050114C071807213F8727F727F867214801BC07214E01BF0 -A27214F81BFCA37214FEA31BFFEBFF80000313E0487F001F13FC487FA2487FA2B67EA31B -FEA3601BFCA292C8FC6C1AF84A5D4A18F06C494B14E05C6C01C04B14C06C90C915804E14 -006C6D4B5B6C01F092B55A6C01FC4A5C27007FFFC001075C6D01FE013F14C0010F90B85A -6D4DC7FC010117F8D9003F16E0020F93C8FC020015F0030749C9FC507378F061>51 -D<93B5FC031F14F092B612FE02076F7E021F16E04A16F891B87E49DAF00713FF0107DA00 -01804901FC6D6C7F49496E7F49496E7F49496E7F90B5486E7F484A8048854891C86C7FA2 -487114805C481AC0A2487213E0A2484918F0A31BF8A2B5FCA27313FCA51BFEA71BFF61A2 -7EA396B6FC7EA2806C5FA27E606C7F607E6C6E5C6CEF1FBF6D6DEC3F3F6D6D147F6D6D14 -FE6D6DEB01FC6D01FE130701019039FFC01FF86D91B500F014FE023F15C06E15800203EC -FE00DA007F13F8030713C092C9FC4F13FCA41BF8A31BF0D91FF093B5FCEB7FFC496C18E0 -487F486E17C06048801B804E1400A26260624E5B4B5C626C91C8485B4A4B5B4A92B55A6C -01F04A91C7FC02804A5B6C01E0020F5B6D6C023F13F002FE91B55A90273FFFE00F5C6D90 -B7C8FC010716FC6D16F0010016C0023F92C9FC020714F09126007FFECAFC507378F061> -57 D<92383FFFF80207B612E0027F15FC49B87E010717E0011F83499026F0007F13FC49 -48C7000F7F90B502036D7E486E6D806F6D80727F486E6E7F8486727FA28684A26C5C7280 -6C5C6D90C8FC6D5AEB0FF8EB03E090CAFCA70507B6FC041FB7FC0303B8FC157F0203B9FC -021FECFE0391B612800103ECF800010F14C04991C7FC017F13FC90B512F04814C0485C48 -91C8FC485B5A485B5C5A5CA2B5FC5CA360A36E5DA26C5F6E5D187E6C6D846E4A48806C6D -4A4814FC6C6ED90FF0ECFFFC6C02E090263FE07F14FE00019139FC03FFC06C91B6487E01 -3F4B487E010F4B1307010303F01301D9003F0280D9003F13FC020101F8CBFC57507ACE5E ->97 D<903801FFFCB6FCA8C67E131F7FB3ADF0FFFC050FEBFFE0057F14FE0403B77E040F -16E0043F16F84CD9007F13FE9226FDFFF001077F92B500C001018094C86C13E004FC6F7F -4C6F7F04E06F7F4C6F7F5E747F93C915804B7014C0A27414E0A21DF087A21DF8A31DFC87 -A41DFEAF1DFCA4631DF8A31DF098B5FC1DE0A25014C0A26F1980501400705D705F704B5B -505B704B5B04FC4B5BDBE7FE92B55A9226C3FF8001035C038101E0011F49C7FC9226807F -FC90B55A4B6CB712F04A010F16C04A010393C8FC4A010015F84A023F14C090C9000301F0 -C9FC5F797AF76C>I<93383FFFF00307B612C0033F15F84AB712FE0207707E021F17E002 -7F8391B526FC001F7F010302C001037F4991C7487F49495C495B4901F04A7F5B90B55A48 -5CA2485C4891C8FCA248715B5C48715B725B4A6F5B489438007FC0071FC7FC96C8FC5AA2 -5CA3B5FCAF7E80A47E80A27E806CF11F80F23FC06C6E167FA26C6EEEFF80816C606C6E17 -006D6D4B5A6D6D15076D6D4B5A6D6D6C4A5A6D02E0EC7FF06D02F849485A01009126FF80 -1F5B6E91B6C7FC021F5E020716F8020116E06E6C1580030702FCC8FCDB003F13804A507A -CE56>I<97380FFFE00607B6FCA8F00003190086B3AD93383FFF800307B512F8033F14FF -4AB712C0020716F0021F16FC027F9039FE007FFE91B500F0EB0FFF01030280010190B5FC -4949C87E49498149498149498149498190B548814884484A8192CAFC5AA2485BA25A5C5A -A35A5CA4B5FCAF7EA4807EA37EA2807EA26C7F616C6E5D6C606C80616D6D5D6D6D5D6D6D -92B67E6D6D4A15FC010301FF0207EDFFFE6D02C0EB3FFE6D6C9039FC01FFF86E90B65A02 -0F16C002031600DA007F14FC030F14E09226007FFEC749C7FC5F797AF76C>I<93387FFF -80030FB512FC037FECFF804AB712E0020716F8021F16FE027FD9F8077F49B5D8C0008049 -91C7003F13E04901FC020F7F49496E7F49498049496E7F49496E7F90B55A48727E92C914 -804884485B1BC048841BE0485BA27313F05AA25C5AA21BF885A2B5FCA391BAFCA41BF002 -F8CCFCA67EA3807EA47E806CF103F0F207F86C7F1A0F6C6E17F06C191F6F17E06C6E163F -6D6DEE7FC06D6D16FF6D6D4B13806D6D4B13006D6D6CEC0FFE6D02E0EC3FFC6D02F8ECFF -F86D9126FFC00F5B023F91B65A020F178002034CC7FC020016F8031F15E0030392C8FCDB -000F13E04D507BCE58>I<93381FFFE00303B6FC031F15E092B712FC020316FF020F17C0 -023FD9FC0014F091B500C0010F13FC4991C700037F4901FC02007F010F496F13C049496F -7F49496F7F4B8149496F7F90B5C96C7F4886A24849707F481B80A248497014C0A2481BE0 -A348497113F0A3481BF8A5B51AFCAE6C1BF8A46C1BF06E94B5FCA36C1BE0A26C6D4C14C0 -A26C1B806E5E6C1B006C6E4B5BA26C6E4B5B6D6D4B5B6D6D4B5B6D6D4B5B6D6D92B55A6D -01FF02035C6D02C0010F91C7FC010002FC90B512FC6E90B75A021F17E00207178002014C -C8FCDA003F15F0030392C9FCDB001F13E056507BCE61>111 D<902601FFF8EB07FEB691 -383FFFC094B512F00403804C14FE4C8093261FFC3F138093263FE07F13C0DC7F80B5FCC6 -6C5D011FDAFE0114E06DEBF9FC16F815FB16F016E015FF16C07114C05E72138095381FFE -0093C76C5AF001E095C8FCA25DA65DB3B3A2B812F8A8434E7ACD4F>114 -D E +0116E06E6C1580030702F8C9FCDB003F90CAFC527379F061>48 D52 D<93B5FC031F14F092B612FE02076F7E021F16E04A16F891 +B87E49DAF00713FF0107DA0001804901FC6D6C7F49496E7F49496E7F49496E7F90B5486E +7F484A8048854891C86C7FA2487114805C481AC0A2487213E0A2484918F0A31BF8A2B5FC +A27313FCA51BFEA71BFF61A27EA396B6FC7EA2806C5FA27E606C7F607E6C6E5C6CEF1FBF +6D6DEC3F3F6D6D147F6D6D14FE6D6DEB01FC6D01FE130701019039FFC01FF86D91B500F0 +14FE023F15C06E15800203ECFE00DA007F13F8030713C092C9FC4F13FCA41BF8A31BF0D9 +1FF093B5FCEB7FFC496C18E0487F486E17C06048801B804E1400A26260624E5B4B5C626C +91C8485B4A4B5B4A92B55A6C01F04A91C7FC02804A5B6C01E0020F5B6D6C023F13F002FE +91B55A90273FFFE00F5C6D90B7C8FC010716FC6D16F0010016C0023F92C9FC020714F091 +26007FFECAFC507378F061>57 D<92383FFFF80207B612E0027F15FC49B87E010717E001 +1F83499026F0007F13FC4948C7000F7F90B502036D7E486E6D806F6D80727F486E6E7F84 +86727FA28684A26C5C72806C5C6D90C8FC6D5AEB0FF8EB03E090CAFCA70507B6FC041FB7 +FC0303B8FC157F0203B9FC021FECFE0391B612800103ECF800010F14C04991C7FC017F13 +FC90B512F04814C0485C4891C8FC485B5A485B5C5A5CA2B5FC5CA360A36E5DA26C5F6E5D +187E6C6D846E4A48806C6D4A4814FC6C6ED90FF0ECFFFC6C02E090263FE07F14FE000191 +39FC03FFC06C91B6487E013F4B487E010F4B1307010303F01301D9003F0280D9003F13FC +020101F8CBFC57507ACE5E>97 D<903801FFFCB6FCA8C67E131F7FB3ADF0FFFC050FEBFF +E0057F14FE0403B77E040F16E0043F16F84CD9007F13FE9226FDFFF001077F92B500C001 +018094C86C13E004FC6F7F4C6F7F04E06F7F4C6F7F5E747F93C915804B7014C0A27414E0 +A21DF087A21DF8A31DFC87A41DFEAF1DFCA4631DF8A31DF098B5FC1DE0A25014C0A26F19 +80501400705D705F704B5B505B704B5B04FC4B5BDBE7FE92B55A9226C3FF8001035C0381 +01E0011F49C7FC9226807FFC90B55A4B6CB712F04A010F16C04A010393C8FC4A010015F8 +4A023F14C090C9000301F0C9FC5F797AF76C>I<93383FFFF00307B612C0033F15F84AB7 +12FE0207707E021F17E0027F8391B526FC001F7F010302C001037F4991C7487F49495C49 +5B4901F04A7F5B90B55A485CA2485C4891C8FCA248715B5C48715B725B4A6F5B48943800 +7FC0071FC7FC96C8FC5AA25CA3B5FCAF7E80A47E80A27E806CF11F80F23FC06C6E167FA2 +6C6EEEFF80816C606C6E17006D6D4B5A6D6D15076D6D4B5A6D6D6C4A5A6D02E0EC7FF06D +02F849485A01009126FF801F5B6E91B6C7FC021F5E020716F8020116E06E6C1580030702 +FCC8FCDB003F13804A507ACE56>I<97380FFFE00607B6FCA8F00003190086B3AD93383F +FF800307B512F8033F14FF4AB712C0020716F0021F16FC027F9039FE007FFE91B500F0EB +0FFF01030280010190B5FC4949C87E49498149498149498149498190B548814884484A81 +92CAFC5AA2485BA25A5C5AA35A5CA4B5FCAF7EA4807EA37EA2807EA26C7F616C6E5D6C60 +6C80616D6D5D6D6D5D6D6D92B67E6D6D4A15FC010301FF0207EDFFFE6D02C0EB3FFE6D6C +9039FC01FFF86E90B65A020F16C002031600DA007F14FC030F14E09226007FFEC749C7FC +5F797AF76C>I<93387FFF80030FB512FC037FECFF804AB712E0020716F8021F16FE027F +D9F8077F49B5D8C000804991C7003F13E04901FC020F7F49496E7F49498049496E7F4949 +6E7F90B55A48727E92C914804884485B1BC048841BE0485BA27313F05AA25C5AA21BF885 +A2B5FCA391BAFCA41BF002F8CCFCA67EA3807EA47E806CF103F0F207F86C7F1A0F6C6E17 +F06C191F6F17E06C6E163F6D6DEE7FC06D6D16FF6D6D4B13806D6D4B13006D6D6CEC0FFE +6D02E0EC3FFC6D02F8ECFFF86D9126FFC00F5B023F91B65A020F178002034CC7FC020016 +F8031F15E0030392C8FCDB000F13E04D507BCE58>I<93381FFFE00303B6FC031F15E092 +B712FC020316FF020F17C0023FD9FC0014F091B500C0010F13FC4991C700037F4901FC02 +007F010F496F13C049496F7F49496F7F4B8149496F7F90B5C96C7F4886A24849707F481B +80A248497014C0A2481BE0A348497113F0A3481BF8A5B51AFCAE6C1BF8A46C1BF06E94B5 +FCA36C1BE0A26C6D4C14C0A26C1B806E5E6C1B006C6E4B5BA26C6E4B5B6D6D4B5B6D6D4B +5B6D6D4B5B6D6D92B55A6D01FF02035C6D02C0010F91C7FC010002FC90B512FC6E90B75A +021F17E00207178002014CC8FCDA003F15F0030392C9FCDB001F13E056507BCE61>111 +D<902601FFF8EB07FEB691383FFFC094B512F00403804C14FE4C8093261FFC3F13809326 +3FE07F13C0DC7F80B5FCC66C5D011FDAFE0114E06DEBF9FC16F815FB16F016E015FF16C0 +7114C05E72138095381FFE0093C76C5AF001E095C8FCA25DA65DB3B3A2B812F8A8434E7A +CD4F>114 D E %EndDVIPSBitmapFont end %%EndProlog @@ -1389,9 +1384,9 @@ %%EndSetup %%Page: 1 1 -1 0 bop 94 1385 a Fl(barco)5 b(de)65 b(0.93)p 94 1451 +1 0 bop 94 1385 a Fl(barco)5 b(de)65 b(0.94)p 94 1451 3780 34 v 2617 1548 a Fk(A)31 b(library)d(for)i(dra)m(wing)f(bar)h(co)s -(des)3242 1656 y(Septem)m(b)s(er)g(1999)94 5367 y Fj(b)l(y)45 +(des)3341 1656 y(Octob)s(er)g(1999)94 5367 y Fj(b)l(y)45 b(Alessandro)h(Rubini)f(\()p Fi(rubini@{gnu.org,prosa.it)o(})p Fj(\))p 94 5446 3780 17 v eop %%Page: 1 2 @@ -1545,7 +1540,7 @@ 3 3 bop 94 -116 a Fk(Chapter)30 b(4:)41 b(F)-8 b(unctions)30 b(Exp)s(orted)g(b)m(y)g(the)h(Library)1871 b(3)94 365 y Fh(3)81 b(The)53 b(Flags)219 708 y Fk(The)30 b(follo)m(wing)f -(\015ags)h(are)h(supp)s(orted)e(b)m(y)h(v)m(ersion)g(0.93)i(of)e(the)h +(\015ags)h(are)h(supp)s(orted)e(b)m(y)h(v)m(ersion)g(0.94)i(of)e(the)h (library:)94 917 y Fi(BARCODE_ENCODING_MASK)574 1017 y Fk(The)f(mask)h(is)e(used)h(to)h(extract)h(the)e(enco)s(ding-t)m(yp)s (e)g(iden)m(ti\014er)f(from)h(the)g Ff(\015ags)39 b Fk(\014eld.)94 @@ -1692,222 +1687,224 @@ 565 y(not)29 b(used\))f(it)g(defaults)f(to)i(standard)e(input.)38 b(Eac)m(h)29 b(data)g(line)e(of)h(the)h(input)d(\014le)i(will)d(b)s(e)j (used)574 664 y(to)k(create)g(one)e(barco)s(de)g(output.)94 -804 y Fi(-o)g(filename)574 903 y Fk(Output)g(\014le.)40 -b(It)30 b(defaults)f(to)j(standard)d(output.)94 1043 +824 y Fi(-o)g(filename)574 923 y Fk(Output)g(\014le.)40 +b(It)30 b(defaults)f(to)j(standard)d(output.)94 1083 y Fi(-b)h(string)66 b Fk(Sp)s(ecify)32 b(a)j(single)d(\\barco)s(de")i (string)f(to)h(b)s(e)g(enco)s(ded.)50 b(The)33 b(option)g(can)h(b)s(e)f -(used)g(m)m(ultiple)574 1142 y(times)j(in)e(order)h(to)h(enco)s(de)g(m) +(used)g(m)m(ultiple)574 1182 y(times)j(in)e(order)h(to)h(enco)s(de)g(m) m(ultiple)d(strings)i(\(this)f(will)f(result)i(in)f(m)m(ulti-page)h(p)s -(ostscript)574 1242 y(output)22 b(or)g(a)g(table)g(of)g(barco)s(des)g +(ostscript)574 1282 y(output)22 b(or)g(a)g(table)g(of)g(barco)s(des)g (if)f Fi(-t)g Fk(is)g(sp)s(eci\014ed\).)37 b(The)21 b(strings)g(m)m -(ust)h(matc)m(h)h(the)f(enco)s(ding)574 1342 y(c)m(hosen)33 -b(with)e Fi(-e)g Fk(and)g(no)h(error)g(is)f(prin)m(ted)f(if)h(they)h -(don't)g(matc)m(h)h(\(this)f(ma)m(y)g(b)s(e)f(construed)574 -1441 y(as)g(a)g(bug\).)94 1581 y Fi(-e)f(encoding)574 -1680 y Fb(enco)s(ding)j Fk(is)e(the)i(name)f(of)h(the)g(c)m(hosen)g +(ust)h(matc)m(h)h(the)f(enco)s(ding)574 1381 y(c)m(hosen;)29 +b(if)c(it)g(do)s(esn't)h(matc)m(h)h(the)f(program)g(will)d(prin)m(t)i +(a)h(w)m(arning)f(to)i Fi(stderr)d Fk(and)h(generate)574 +1481 y(\\blank")45 b(output)f(\(although)g(not)h(zero-lengh)m(t\).)85 +b(Please)44 b(note)i(that)f(a)g(string)e(including)574 +1581 y(spaces)31 b(or)g(other)f(sp)s(ecial)f(c)m(haracters)j(m)m(ust)e +(b)s(e)g(prop)s(erly)e(quoted.)94 1740 y Fi(-e)i(encoding)574 +1840 y Fb(enco)s(ding)j Fk(is)e(the)i(name)f(of)h(the)g(c)m(hosen)g (enco)s(ding)e(format)i(b)s(eing)e(used.)46 b(It)32 b(defaults)g(to)h -(the)574 1780 y(v)-5 b(alue)41 b(of)f(the)h(en)m(vironmen)m(t)g(v)-5 +(the)574 1939 y(v)-5 b(alue)41 b(of)f(the)h(en)m(vironmen)m(t)g(v)-5 b(ariable)39 b Fi(BARCODE_ENCODING)d Fk(or)41 b(to)g(auto)h(detection)f -(if)f(the)574 1880 y(en)m(vironmen)m(t)30 b(is)g(also)g(unset.)94 -2019 y Fi(-g)g(geometry)574 2119 y Fk(The)h(geometry)i(argumen)m(t)f +(if)f(the)574 2039 y(en)m(vironmen)m(t)30 b(is)g(also)g(unset.)94 +2198 y Fi(-g)g(geometry)574 2298 y Fk(The)h(geometry)i(argumen)m(t)f (is)e(of)i(the)g(form)f(\\)p Fi(<)p Ff(width)p Fi(>)h(x)f(<)p Ff(height)p Fi(>)h Fk([)p Fi(+)f(<)p Ff(xmar)-5 b(gin)p -Fi(>)32 b(+)f(<)p Ff(ymar-)574 2218 y(gin)p Fi(>)p Fk(]")37 +Fi(>)32 b(+)f(<)p Ff(ymar-)574 2398 y(gin)p Fi(>)p Fk(]")37 b(\(with)f(no)h(in)m(terv)m(ening)f(spaces\).)60 b(The)37 b(margin)e(v)-5 b(alues,)38 b(if)e(missing,)h(default)e(to)j(0\).)574 -2318 y(The)24 b(sp)s(eci\014ed)e(v)-5 b(alues)23 b(m)m(ust)h(b)s(e)g +2497 y(The)24 b(sp)s(eci\014ed)e(v)-5 b(alues)23 b(m)m(ust)h(b)s(e)g (in)m(teger)g(n)m(um)m(b)s(ers)e(and)i(they)g(represen)m(t)g(prin)m(t)e -(p)s(oin)m(ts)h(\(I)h(plan)574 2418 y(to)33 b(add)e(supp)s(ort)f(for)i +(p)s(oin)m(ts)h(\(I)h(plan)574 2597 y(to)33 b(add)e(supp)s(ort)f(for)i (di\013eren)m(t)f(units,)g(lik)m(e)g(inc)m(hes)g(and)h(millimeters,)d -(but)i(this)g(is)g(curren)m(tly)574 2517 y(not)d(supp)s(orted\).)38 +(but)i(this)g(is)g(curren)m(tly)574 2697 y(not)d(supp)s(orted\).)38 b(The)27 b(argumen)m(t)h(is)e(used)h(to)h(place)f(the)h(prin)m(tout)e -(co)s(de)h(on)h(the)f(page.)41 b(Note)574 2617 y(that)c(an)g +(co)s(de)h(on)h(the)f(page.)41 b(Note)574 2796 y(that)c(an)g (additional)d(white)h(margin)h(of)g(10)h(p)s(oin)m(ts)e(is)h(added)f -(to)i(the)g(prin)m(tout.)57 b(If)36 b(the)h(op-)574 2716 +(to)i(the)g(prin)m(tout.)57 b(If)36 b(the)h(op-)574 2896 y(tion)d(is)e(unsp)s(eci\014ed,)g Fi(BARCODE_GEOMETRY)e Fk(is)i(lo)s(ok)m(ed)i(up)f(in)f(the)i(en)m(vironmen)m(t,)g(if)f -(missing)574 2816 y(a)e(default)f(size)g(and)g(no)g(margin)f(\(but)h +(missing)574 2995 y(a)e(default)f(size)g(and)g(no)g(margin)f(\(but)h (the)h(default)f(10)h(p)s(oin)m(ts\))e(are)i(used.)94 -2956 y Fi(-t)f(table-geometry)574 3055 y Fk(Used)j(to)g(prin)m(t)e(sev) +3155 y Fi(-t)f(table-geometry)574 3254 y Fk(Used)j(to)g(prin)m(t)e(sev) m(eral)i(barco)s(des)f(to)i(a)f(single)e(page,)j(this)d(option)h(is)g -(mean)m(t)h(to)h(b)s(e)d(used)h(to)574 3155 y(prin)m(t)e(stic)m(k)m +(mean)m(t)h(to)h(b)s(e)d(used)h(to)574 3354 y(prin)m(t)e(stic)m(k)m (ers.)43 b(The)30 b(argumen)m(t)h(is)f(of)h(the)g(form)g(\\)p Fi(<)p Ff(c)-5 b(olumns)p Fi(>)32 b(x)e(<)p Ff(lines)p Fi(>)h Fk([)p Fi(+)g(<)p Ff(leftmar)-5 b(gin)p Fi(>)31 -b(+)574 3254 y(<)p Ff(b)-5 b(ottommar)g(gin)p Fi(>)39 +b(+)574 3454 y(<)p Ff(b)-5 b(ottommar)g(gin)p Fi(>)39 b Fk([)p Fi(-)d(<)p Ff(rightmar)-5 b(gin)p Fi(>)38 b Fk([)p Fi(-)e(<)p Ff(topmar)-5 b(gin)p Fi(>)p Fk(]]]")39 -b(\(with)c(no)h(in)m(terv)m(ening)f(spaces\);)574 3354 +b(\(with)c(no)h(in)m(terv)m(ening)f(spaces\);)574 3553 y(if)42 b(missing,)i(the)f(top)g(and)f(righ)m(t)g(margin)g(will)e (default)i(to)i(b)s(e)e(the)h(same)g(as)g(the)g(b)s(ottom)574 -3454 y(and)c(left)g(margin.)66 b(The)38 b(margins)g(are)i(sp)s +3653 y(and)c(left)g(margin.)66 b(The)38 b(margins)g(are)i(sp)s (eci\014ed)d(in)h(prin)m(t)g(p)s(oin)m(ts)g(or)h(in)e(the)j(c)m(hosen)f -(unit)574 3553 y(\(see)f Fi(-u)d Fk(b)s(elo)m(w\).)59 +(unit)574 3753 y(\(see)f Fi(-u)d Fk(b)s(elo)m(w\).)59 b(If)35 b(the)i(option)f(is)f(not)i(sp)s(eci\014ed,)f Fi(BARCODE_TABLE)d Fk(is)i(lo)s(ok)m(ed)h(up)g(in)f(the)574 -3653 y(en)m(vironmen)m(t,)c(otherwise)f(no)g(table)g(is)f(prin)m(ted)g +3852 y(en)m(vironmen)m(t,)c(otherwise)f(no)g(table)g(is)f(prin)m(ted)g (and)h(eac)m(h)i(barco)s(de)e(will)e(get)j(its)f(o)m(wn)g(page.)94 -3792 y Fi(-m)g(margin\(s\))574 3892 y Fk(Sp)s(eci\014es)21 +4012 y Fi(-m)g(margin\(s\))574 4111 y Fk(Sp)s(eci\014es)21 b(an)g(in)m(ternal)g(margin)g(for)g(eac)m(h)i(stic)m(k)m(er)g(in)d(the) i(table.)38 b(The)21 b(argumen)m(t)i(is)d(of)i(the)g(form)574 -3992 y(\\)p Fi(<)p Ff(xmar)-5 b(gin)p Fi(>,<)p Ff(ymar)g(gin)p +4211 y(\\)p Fi(<)p Ff(xmar)-5 b(gin)p Fi(>,<)p Ff(ymar)g(gin)p Fi(>)p Fk(")35 b(and)c(the)g(margin)g(is)g(applied)e(symmetrically)h -(to)i(the)g(stic)m(k)m(er.)45 b(If)574 4091 y(unsp)s(eci\014ed,)28 +(to)i(the)g(stic)m(k)m(er.)45 b(If)574 4311 y(unsp)s(eci\014ed,)28 b(the)h(en)m(vironmen)m(t)g(v)-5 b(ariable)28 b Fi(BARCODE_MARGIN)e -Fk(is)i(used)h(or)g(a)h(default)e(in)m(ternal)574 4191 -y(margin)i(of)g(10)i(p)s(oin)m(ts)d(is)g(used.)94 4330 +Fk(is)i(used)h(or)g(a)h(default)e(in)m(ternal)574 4410 +y(margin)i(of)g(10)i(p)s(oin)m(ts)d(is)g(used.)94 4570 y Fi(-n)384 b Fk(\\Numeric")31 b(output:)40 b(don't)31 b(prin)m(t)e(the)h(ASCI)s(I)f(form)h(of)g(the)h(co)s(de,)g(only)e(the)i -(bars.)94 4470 y Fi(-c)384 b Fk(No)35 b(c)m(hec)m(ksum)f(c)m(haracter)h +(bars.)94 4729 y Fi(-c)384 b Fk(No)35 b(c)m(hec)m(ksum)f(c)m(haracter)h (\(for)f(enco)s(dings)e(that)j(allo)m(w)e(it,)h(lik)m(e)f(co)s(de)h -(39,)h(other)f(co)s(des,)h(lik)m(e)574 4570 y(UPC)c(or)f(EAN,)h(ignore) -f(this)f(option\).)94 4709 y Fi(-E)384 b Fk(Encapsulated)21 +(39,)h(other)f(co)s(des,)h(lik)m(e)574 4829 y(UPC)c(or)f(EAN,)h(ignore) +f(this)f(option\).)94 4988 y Fi(-E)384 b Fk(Encapsulated)21 b(p)s(ostscript)g(\(default)g(is)g(normal)g(p)s(ostscript.)36 -b(When)22 b(the)g(output)f(is)g(generated)574 4809 y(a)31 +b(When)22 b(the)g(output)f(is)g(generated)574 5088 y(a)31 b(EPS)f(only)f(one)i(text)g(string)f(is)f(enco)s(ded.)94 -4948 y Fi(-p)h(pagesize)574 5048 y Fk(Sp)s(ecify)44 b(a)h(non-default)f +5247 y Fi(-p)h(pagesize)574 5347 y Fk(Sp)s(ecify)44 b(a)h(non-default)f (page)i(size.)85 b(The)45 b(page)h(size)f(can)g(b)s(e)f(sp)s(eci\014ed) -g(in)g(millimeters,)574 5147 y(inc)m(hes)34 b(or)g(plain)e(n)m(um)m(b)s +g(in)g(millimeters,)574 5446 y(inc)m(hes)34 b(or)g(plain)e(n)m(um)m(b)s (ers)g(\(for)i(example:)48 b Fi("210x297mm")p Fk(,)32 b Fi("8.5x11in")p Fk(,)g Fi("595x842")p Fk(\).)50 b(A)574 -5247 y(page)27 b(sp)s(eci\014cation)d(as)i(n)m(um)m(b)s(ers)e(will)f(b) +5546 y(page)27 b(sp)s(eci\014cation)d(as)i(n)m(um)m(b)s(ers)e(will)f(b) s(e)i(in)m(terpreted)g(according)g(to)i(the)f(curren)m(t)f(unit)f(sp)s -(ec-)574 5347 y(i\014cation)33 b(\(see)h Fi(-u)e Fk(b)s(elo)m(w\).)49 +(ec-)574 5645 y(i\014cation)33 b(\(see)h Fi(-u)e Fk(b)s(elo)m(w\).)49 b(If)33 b(libpap)s(er)d(is)i(a)m(v)-5 b(ailable,)33 b(y)m(ou)h(can)f -(also)g(sp)s(ecify)f(the)h(page)h(size)574 5446 y(with)40 -b(its)g(name,)k(lik)m(e)d Fi("A3")e Fk(or)i Fi("letter")e -Fk(\(libpap)s(er)f(is)i(a)h(standard)g(comp)s(onen)m(t)g(of)g(De-)574 -5546 y(bian)d(GNU/Lin)m(ux,)k(but)d(ma)m(y)h(b)s(e)e(missing)f -(elsewhere\).)68 b(The)39 b(default)f(page)i(size)g(is)e(y)m(our)574 -5645 y(system-wide)30 b(default)g(if)f(libpap)s(er)e(is)j(there,)h(A4)g -(otherwise.)p eop +(also)g(sp)s(ecify)f(the)h(page)h(size)p eop %%Page: 6 7 6 6 bop 94 -116 a Fk(Chapter)30 b(5:)41 b(The)30 b Ff(b)-5 b(ar)g(c)g(o)g(de)40 b Fk(fron)m(tend)30 b(program)2063 -b(6)94 365 y Fi(-u)30 b(unit)574 495 y Fk(Cho)s(ose)i(the)f(unit)f -(used)g(in)g(size)i(sp)s(eci\014cations.)42 b(Accepted)32 -b(v)-5 b(alues)31 b(are)g(\\mm",)i(\\cm",)f(\\in")574 -594 y(and)37 b(\\pt".)61 b(By)37 b(default,)h(the)f(program)f(will)f(c) +b(6)574 365 y(with)40 b(its)g(name,)k(lik)m(e)d Fi("A3")e +Fk(or)i Fi("letter")e Fk(\(libpap)s(er)f(is)i(a)h(standard)g(comp)s +(onen)m(t)g(of)g(De-)574 465 y(bian)d(GNU/Lin)m(ux,)k(but)d(ma)m(y)h(b) +s(e)e(missing)f(elsewhere\).)68 b(The)39 b(default)f(page)i(size)g(is)e +(y)m(our)574 565 y(system-wide)30 b(default)g(if)f(libpap)s(er)e(is)j +(there,)h(A4)g(otherwise.)94 710 y Fi(-u)f(unit)574 832 +y Fk(Cho)s(ose)i(the)f(unit)f(used)g(in)g(size)i(sp)s(eci\014cations.) +42 b(Accepted)32 b(v)-5 b(alues)31 b(are)g(\\mm",)i(\\cm",)f(\\in")574 +932 y(and)37 b(\\pt".)61 b(By)37 b(default,)h(the)f(program)f(will)f(c) m(hec)m(k)j Fi(BARCODE_UNIT)33 b Fk(in)j(the)h(en)m(vironmen)m(t,)574 -694 y(and)c(assume)g(p)s(oin)m(ts)g(otherwise)f(\(this)h(b)s(eha)m +1032 y(and)c(assume)g(p)s(oin)m(ts)g(otherwise)f(\(this)h(b)s(eha)m (viour)f(is)g(compatible)h(with)f(0.92)j(and)d(previous)574 -794 y(v)m(ersions.)50 b(If)33 b Fi(-u)g Fk(app)s(ears)g(more)g(than)g +1131 y(v)m(ersions.)50 b(If)33 b Fi(-u)g Fk(app)s(ears)g(more)g(than)g (once,)j(eac)m(h)e(instance)f(will)e(mo)s(di\014ed)h(the)h(b)s(eha)m -(viour)574 893 y(for)h(the)g(argumen)m(ts)g(at)g(its)f(righ)m(t,)i(as)f -(the)g(command)f(line)f(is)h(pro)s(cesses)g(left)h(to)g(righ)m(t.)50 -b(The)574 993 y(program)32 b(in)m(ternally)f(w)m(orks)h(with)f(p)s(oin) -m(ts,)h(and)f(an)m(y)i(size)f(is)f(appro)m(ximated)h(to)h(the)f -(nearest)574 1092 y(m)m(ultiple)c(of)j(one)f(p)s(oin)m(t.)40 +(viour)574 1231 y(for)h(the)g(argumen)m(ts)g(at)g(its)f(righ)m(t,)i(as) +f(the)g(command)f(line)f(is)h(pro)s(cesses)g(left)h(to)g(righ)m(t.)50 +b(The)574 1330 y(program)32 b(in)m(ternally)f(w)m(orks)h(with)f(p)s +(oin)m(ts,)h(and)f(an)m(y)i(size)f(is)f(appro)m(ximated)h(to)h(the)f +(nearest)574 1430 y(m)m(ultiple)c(of)j(one)f(p)s(oin)m(t.)40 b(The)30 b Fi(-u)f Fk(option)h(a\013ect)i Fi(-g)e Fk(\(geometry\),)i -Fi(-t)e Fk(\(table\))h(and)e Fi(-p)h Fk(\(page)574 1192 -y(size\).)94 1474 y Fj(5.2)69 b(Supp)t(orted)44 b(Enco)t(dings)219 -1666 y Fk(The)31 b(program)h(enco)s(des)g(text)g(strings)f(passed)g +Fi(-t)e Fk(\(table\))h(and)e Fi(-p)h Fk(\(page)574 1530 +y(size\).)94 1781 y Fj(5.2)69 b(Supp)t(orted)44 b(Enco)t(dings)219 +1961 y Fk(The)31 b(program)h(enco)s(des)g(text)g(strings)f(passed)g (either)g(on)h(the)g(command)g(line)e(\(with)g(-b\))i(or)g(retriev)m -(ed)94 1766 y(from)38 b(standard)f(input.)61 b(The)37 +(ed)94 2061 y(from)38 b(standard)f(input.)61 b(The)37 b(text)i(represen)m(tation)f(is)f(in)m(terpreted)g(according)g(to)i -(the)f(follo)m(wing)e(rules.)94 1866 y(When)30 b(auto-detection)h(of)e +(the)f(follo)m(wing)e(rules.)94 2161 y(When)30 b(auto-detection)h(of)e (the)h(enco)s(ding)f(is)f(enabled)g(\(i.e,)j(no)e(explicit)f(enco)s (ding)g(t)m(yp)s(e)i(is)e(sp)s(eci\014ed\),)h(the)94 -1965 y(enco)s(ding)h(t)m(yp)s(es)g(are)h(scanned)f(to)h(\014nd)e(one)i -(that)f(can)h(digest)f(the)h(text)g(string.)94 2130 y -Fg(UPC)574 2259 y Fk(The)k(UPC)g(fron)m(tend)g(accepts)i(only)d +2260 y(enco)s(ding)h(t)m(yp)s(es)g(are)h(scanned)f(to)h(\014nd)e(one)i +(that)f(can)h(digest)f(the)h(text)g(string.)94 2406 y +Fg(UPC)574 2528 y Fk(The)k(UPC)g(fron)m(tend)g(accepts)i(only)d (strings)g(made)i(up)e(of)h(digits)f(\(and,)j(if)d(a)i(supplemen)m(tal) -574 2359 y(enco)s(ding)f(is)g(used,)h(a)h(blank)d(to)i(separate)h +574 2628 y(enco)s(ding)f(is)g(used,)h(a)h(blank)d(to)i(separate)h (it\).)57 b(It)36 b(accepts)h(strings)d(of)i(11)h(digits)d(\(UPC-A\)) -574 2458 y(or)39 b(6)h(digits)d(\(UPC-E\).)j(The)f(12th)g(digit)f(of)h +574 2727 y(or)39 b(6)h(digits)d(\(UPC-E\).)j(The)f(12th)g(digit)f(of)h (UPC-A)g(is)f(the)i(c)m(hec)m(ksum)f(and)g(is)f(added)g(b)m(y)574 -2558 y(the)i(library)-8 b(,)40 b(if)e(y)m(ou)h(pass)g(a)h(12-digit)f +2827 y(the)i(library)-8 b(,)40 b(if)e(y)m(ou)h(pass)g(a)h(12-digit)f (string)f(it)h(will)d(b)s(e)j(rejected)h(as)f(in)m(v)-5 -b(alid.)65 b(F)-8 b(or)40 b(UPC-)574 2657 y(A,)45 b(a)g(trailing)d +b(alid.)65 b(F)-8 b(or)40 b(UPC-)574 2927 y(A,)45 b(a)g(trailing)d (string)h(of)h(2)h(digits)d(or)j(5)f(digits)f(is)g(accepted)j(as)e(w)m -(ell.)81 b(Therefore,)48 b(v)-5 b(alid)574 2757 y(strings)23 +(ell.)81 b(Therefore,)48 b(v)-5 b(alid)574 3026 y(strings)23 b(lo)s(ok)h(lik)m(e)f(one)h(of)g(the)g(follo)m(wing:)36 b(\\)p Fi(01234567890)p Fk(")21 b(\(UPC-A\),)k(\\)p Fi(012345)p -Fk(")e(\(UPC-E\),)574 2857 y(\\)p Fi(01234567890)46 b(12)p +Fk(")e(\(UPC-E\),)574 3126 y(\\)p Fi(01234567890)46 b(12)p Fk(")30 b(\(UPC-A,)h(add-2\))g(and)f(\\)p Fi(01234567890)45 -b(12345)p Fk(")29 b(\(UPC-A)i(add-5\).)94 3016 y Fg(EAN)574 -3145 y Fk(The)e(EAN)g(fron)m(tend)f(is)g(similar)e(to)j(UPC;)g(it)f +b(12345)p Fk(")29 b(\(UPC-A)i(add-5\).)94 3271 y Fg(EAN)574 +3394 y Fk(The)e(EAN)g(fron)m(tend)f(is)g(similar)e(to)j(UPC;)g(it)f (accepts)i(strings)e(of)h(digits,)f(12)i(or)e(7)h(c)m(haracters)574 -3245 y(long,)34 b(the)f(c)m(hec)m(ksum)g(digit)f(is)f(added)h(b)m(y)h +3493 y(long,)34 b(the)f(c)m(hec)m(ksum)g(digit)f(is)f(added)h(b)m(y)h (the)g(library)d(and)i(a)h(string)f(of)h(13)h(or)e(8)h(c)m(haracters) -574 3345 y(is)g(rejected.)51 b(The)33 b(add-2)h(and)f(add-5)g +574 3593 y(is)g(rejected.)51 b(The)33 b(add-2)h(and)f(add-5)g (extension)g(are)h(accepted)h(for)e(the)h(EAN13)h(enco)s(ding.)574 -3444 y(V)-8 b(alid)29 b(strings)g(lo)s(ok)g(lik)m(e)g(one)h(of)g(the)g +3692 y(V)-8 b(alid)29 b(strings)g(lo)s(ok)g(lik)m(e)g(one)h(of)g(the)g (follo)m(wing:)39 b(\\)p Fi(123456789012)p Fk(")27 b(\(EAN-13\),)32 -b(\\)p Fi(1234567)p Fk(")574 3544 y(\(EAN-8\),)44 b(\\)p +b(\\)p Fi(1234567)p Fk(")574 3792 y(\(EAN-8\),)44 b(\\)p Fi(123456789012)h(12)p Fk(")39 b(\(EAN-13)i(with)d(add-2\))h(and)g(\\)p -Fi(123456789012)45 b(12345)p Fk(")574 3644 y(\(EAN-13)33 -b(with)c(add-5\).)94 3803 y Fg(ISBN)574 3932 y Fk(ISBN)43 +Fi(123456789012)45 b(12345)p Fk(")574 3892 y(\(EAN-13)33 +b(with)c(add-5\).)94 4037 y Fg(ISBN)574 4159 y Fk(ISBN)43 b(n)m(um)m(b)s(ers)f(are)h(enco)s(ded)g(as)g(EAN-13)i(sym)m(b)s(ols,)g -(with)d(an)g(optional)h(add-5)g(trailer.)574 4032 y(The)37 +(with)d(an)g(optional)h(add-5)g(trailer.)574 4259 y(The)37 b(ISBN)g(fron)m(tend)f(of)h(the)g(library)e(accepts)j(real)e(ISBN)h(n)m -(um)m(b)s(ers)e(and)i(deals)f(with)g(an)m(y)574 4131 +(um)m(b)s(ers)e(and)i(deals)f(with)g(an)m(y)574 4359 y(h)m(yphen)d(and,)h(if)f(presen)m(t,)h(the)g(ISBN)g(c)m(hec)m(ksum)g (c)m(haracter)h(b)s(efore)e(enco)s(ding)g(data.)51 b(V)-8 -b(alid)574 4231 y(represen)m(tations)30 b(for)g(ISBN)f(strings)g(are)h +b(alid)574 4458 y(represen)m(tations)30 b(for)g(ISBN)f(strings)g(are)h (for)f(example:)40 b(\\)p Fi(1-56592-292-1)p Fk(",)28 -b(\\3-89721-122-)574 4331 y(X")j(and)f(\\3-89721-122-X)36 -b(06900".)94 4490 y Fg(co)s(de)31 b(128-B)574 4590 y +b(\\3-89721-122-)574 4558 y(X")j(and)f(\\3-89721-122-X)36 +b(06900".)94 4703 y Fg(co)s(de)31 b(128-B)574 4803 y Fk(This)37 b(enco)s(ding)g(can)h(represen)m(t)g(all)f(of)h(the)h(prin)m (ting)c(ASCI)s(I)i(c)m(haracters,)42 b(from)37 b(the)h(space)574 -4689 y(\(32\))32 b(to)g(DEL)e(\(127\).)43 b(The)30 b(c)m(hec)m(ksum)h +4902 y(\(32\))32 b(to)g(DEL)e(\(127\).)43 b(The)30 b(c)m(hec)m(ksum)h (digit)e(is)g(mandatory)i(in)e(this)g(enco)s(ding.)94 -4848 y Fg(co)s(de)i(128-C)574 4948 y Fk(The)h(\\C")g(v)-5 +5048 y Fg(co)s(de)i(128-C)574 5147 y Fk(The)h(\\C")g(v)-5 b(ariation)31 b(of)h(Co)s(de-128)h(uses)e(Co)s(de-128)i(sym)m(b)s(ols)d (to)j(represen)m(t)f(t)m(w)m(o)h(digits)d(at)j(a)574 -5048 y(time)28 b(\(Co)s(de-128)g(is)f(made)g(up)f(of)i(104)g(sym)m(b)s +5247 y(time)28 b(\(Co)s(de-128)g(is)f(made)g(up)f(of)i(104)g(sym)m(b)s (ols)e(whose)i(in)m(terpretation)e(is)h(con)m(trolled)g(b)m(y)g(the)574 -5147 y(start)35 b(sym)m(b)s(ol)e(b)s(eing)g(used\).)52 +5347 y(start)35 b(sym)m(b)s(ol)e(b)s(eing)g(used\).)52 b(Co)s(de)34 b(128-C)h(is)e(th)m(us)h(the)h(most)f(compact)i(w)m(a)m(y) -f(to)g(represen)m(t)574 5247 y(an)m(y)41 b(ev)m(en)h(n)m(um)m(b)s(er)d +f(to)g(represen)m(t)574 5446 y(an)m(y)41 b(ev)m(en)h(n)m(um)m(b)s(er)d (of)i(digits.)70 b(The)40 b(enco)s(der)g(refuses)g(to)h(deal)f(with)g -(an)g(o)s(dd)g(n)m(um)m(b)s(er)f(of)574 5347 y(digits)24 +(an)g(o)s(dd)g(n)m(um)m(b)s(er)f(of)574 5546 y(digits)24 b(b)s(ecause)h(the)g(caller)f(is)g(exp)s(ected)h(to)h(pro)m(vide)e (prop)s(er)f(padding)g(to)j(an)f(ev)m(en)g(n)m(um)m(b)s(er)f(of)574 -5446 y(digits.)38 b(\(Since)23 b(Co)s(de-128)i(includes)d(con)m(trol)j +5645 y(digits.)38 b(\(Since)23 b(Co)s(de-128)i(includes)d(con)m(trol)j (sym)m(b)s(ols)d(to)j(switc)m(h)f(c)m(harset,)j(it)c(is)g -(theoretically)574 5546 y(p)s(ossible)29 b(to)j(represen)m(t)f(the)h(o) -s(dd)e(digit)g(as)h(a)g(Co)s(de)g(128-A)i(or)e(128-B)i(sym)m(b)s(ol,)e -(but)f(this)g(to)s(ol)574 5645 y(do)s(esn't)h(curren)m(tly)e(implemen)m -(t)g(this)g(option\).)p eop +(theoretically)p eop %%Page: 7 8 7 7 bop 94 -116 a Fk(Chapter)30 b(5:)41 b(The)30 b Ff(b)-5 b(ar)g(c)g(o)g(de)40 b Fk(fron)m(tend)30 b(program)2063 -b(7)94 365 y Fg(co)s(de)31 b(39)574 490 y Fk(The)37 b(co)s(de-39)h -(standard)d(can)i(enco)s(de)g(upp)s(ercase)f(letters,)j(digits,)e(the)f -(blank)g(space,)j(plus,)574 589 y(min)m(us,)d(dot,)i(star,)f(dollar,)f -(slash,)g(p)s(ercen)m(t.)57 b(An)m(y)36 b(string)f(that)h(is)f(only)g -(comp)s(osed)g(of)h(suc)m(h)574 689 y(c)m(haracters)j(is)e(accepted)h -(b)m(y)g(the)f(co)s(de-39)i(enco)s(der.)61 b(T)-8 b(o)38 -b(a)m(v)m(oid)g(lo)s(osing)e(information,)i(the)574 789 -y(enco)s(der)c(refuses)g(to)h(enco)s(de)f(mixed-case)g(strings)f(\(a)i -(lo)m(w)m(ercase)g(string)e(is)g(nonetheless)h(ac-)574 -888 y(cepted)d(as)g(a)g(shortcut,)f(but)g(is)f(enco)s(ded)h(as)h(upp)s -(ercase\).)94 1038 y Fg(in)m(terlea)m(v)m(ed)g(2)g(of)g(5)574 -1137 y Fk(This)36 b(enco)s(ding)g(can)i(only)e(represen)m(t)h(an)g(ev)m -(en)h(n)m(um)m(b)s(er)e(of)h(digits)f(\(o)s(dd)h(digits)f(are)h(repre-) -574 1237 y(sen)m(ted)c(b)m(y)g(bars,)f(and)g(ev)m(en)h(digits)e(b)m(y)i -(the)f(in)m(terlea)m(ving)g(spaces\).)48 b(The)32 b(name)g(stresses)h -(the)574 1337 y(fact)i(that)g(t)m(w)m(o)g(of)f(the)g(\014v)m(e)g(items) -f(\(bars)h(or)f(spaces\))i(allo)s(cated)f(to)g(eac)m(h)h(sym)m(b)s(ol)e -(are)h(wide,)574 1436 y(while)41 b(the)i(rest)g(are)g(narro)m(w.)78 -b(The)42 b(c)m(hec)m(ksum)h(digit)f(is)g(optional)f(\(can)j(b)s(e)e -(disabled)e(via)574 1536 y Fi(BARCODE_NO_CHECKSUM)p Fk(\).)f(Since)31 -b(the)h(n)m(um)m(b)s(er)e(of)h(digits,)g(including)d(the)j(c)m(hec)m -(ksum,)i(m)m(ust)574 1636 y(b)s(e)40 b(ev)m(en,)k(a)c(leading)f(zero)i -(is)e(inserted)g(in)g(the)i(string)e(b)s(eing)g(enco)s(ded)g(if)h -(needed)f(\(this)h(is)574 1735 y(sp)s(eci\014cally)29 -b(stated)i(in)e(the)h(sp)s(ecs)g(I)g(ha)m(v)m(e)i(access)g(to\).)94 -1993 y Fj(5.3)69 b(Bugs)44 b(and)h(P)l(ending)g(Issues.)219 -2175 y Fk(The)d(curren)m(t)g(managemen)m(t)h(of)g(b)s(orders/margins)d -(is)h(far)h(from)g(optimal.)75 b(The)42 b(\\default")g(margin)94 -2275 y(applied)d(b)m(y)h(the)h(library)d(in)m(terferes)i(with)f(the)i -(external)g(represen)m(tation,)i(but)d(I)g(feel)g(it)g(is)g(mandatory) -94 2374 y(to)f(a)m(v)m(oid)f(creating)g(barco)s(de)f(output)h(with)e -(no)i(surrounding)c(white)j(space)h(\(the)g(problem)e(is)h(esp)s -(ecially)94 2474 y(relev)-5 b(an)m(t)31 b(for)f(EPS)g(output\).)219 -2599 y(Co)s(de128-A)i(should)c(b)s(e)i(supp)s(orted.)p -eop +b(7)574 365 y(p)s(ossible)29 b(to)j(represen)m(t)f(the)h(o)s(dd)e +(digit)g(as)h(a)g(Co)s(de)g(128-A)i(or)e(128-B)i(sym)m(b)s(ol,)e(but)f +(this)g(to)s(ol)574 465 y(do)s(esn't)h(curren)m(tly)e(implemen)m(t)g +(this)g(option\).)94 614 y Fg(co)s(de)i(39)574 739 y +Fk(The)37 b(co)s(de-39)h(standard)d(can)i(enco)s(de)g(upp)s(ercase)f +(letters,)j(digits,)e(the)f(blank)g(space,)j(plus,)574 +839 y(min)m(us,)d(dot,)i(star,)f(dollar,)f(slash,)g(p)s(ercen)m(t.)57 +b(An)m(y)36 b(string)f(that)h(is)f(only)g(comp)s(osed)g(of)h(suc)m(h) +574 938 y(c)m(haracters)j(is)e(accepted)h(b)m(y)g(the)f(co)s(de-39)i +(enco)s(der.)61 b(T)-8 b(o)38 b(a)m(v)m(oid)g(lo)s(osing)e +(information,)i(the)574 1038 y(enco)s(der)c(refuses)g(to)h(enco)s(de)f +(mixed-case)g(strings)f(\(a)i(lo)m(w)m(ercase)g(string)e(is)g +(nonetheless)h(ac-)574 1137 y(cepted)d(as)g(a)g(shortcut,)f(but)g(is)f +(enco)s(ded)h(as)h(upp)s(ercase\).)94 1287 y Fg(in)m(terlea)m(v)m(ed)g +(2)g(of)g(5)574 1386 y Fk(This)36 b(enco)s(ding)g(can)i(only)e +(represen)m(t)h(an)g(ev)m(en)h(n)m(um)m(b)s(er)e(of)h(digits)f(\(o)s +(dd)h(digits)f(are)h(repre-)574 1486 y(sen)m(ted)c(b)m(y)g(bars,)f(and) +g(ev)m(en)h(digits)e(b)m(y)i(the)f(in)m(terlea)m(ving)g(spaces\).)48 +b(The)32 b(name)g(stresses)h(the)574 1586 y(fact)i(that)g(t)m(w)m(o)g +(of)f(the)g(\014v)m(e)g(items)f(\(bars)h(or)f(spaces\))i(allo)s(cated)f +(to)g(eac)m(h)h(sym)m(b)s(ol)e(are)h(wide,)574 1685 y(while)41 +b(the)i(rest)g(are)g(narro)m(w.)78 b(The)42 b(c)m(hec)m(ksum)h(digit)f +(is)g(optional)f(\(can)j(b)s(e)e(disabled)e(via)574 1785 +y Fi(BARCODE_NO_CHECKSUM)p Fk(\).)f(Since)31 b(the)h(n)m(um)m(b)s(er)e +(of)h(digits,)g(including)d(the)j(c)m(hec)m(ksum,)i(m)m(ust)574 +1885 y(b)s(e)40 b(ev)m(en,)k(a)c(leading)f(zero)i(is)e(inserted)g(in)g +(the)i(string)e(b)s(eing)g(enco)s(ded)g(if)h(needed)f(\(this)h(is)574 +1984 y(sp)s(eci\014cally)29 b(stated)i(in)e(the)h(sp)s(ecs)g(I)g(ha)m +(v)m(e)i(access)g(to\).)94 2242 y Fj(5.3)69 b(Bugs)44 +b(and)h(P)l(ending)g(Issues.)219 2424 y Fk(The)d(curren)m(t)g +(managemen)m(t)h(of)g(b)s(orders/margins)d(is)h(far)h(from)g(optimal.) +75 b(The)42 b(\\default")g(margin)94 2524 y(applied)d(b)m(y)h(the)h +(library)d(in)m(terferes)i(with)f(the)i(external)g(represen)m(tation,)i +(but)d(I)g(feel)g(it)g(is)g(mandatory)94 2623 y(to)f(a)m(v)m(oid)f +(creating)g(barco)s(de)f(output)h(with)e(no)i(surrounding)c(white)j +(space)h(\(the)g(problem)e(is)h(esp)s(ecially)94 2723 +y(relev)-5 b(an)m(t)31 b(for)f(EPS)g(output\).)219 2848 +y(Co)s(de128-A)i(should)c(b)s(e)i(supp)s(orted.)p eop %%Page: -1 9 -1 8 bop 3849 -116 a Fk(i)94 365 y Fh(T)-13 b(able)55 b(of)e(Con)l(ten)l(ts)94 697 y Fj(1)135 b(Ov)l(erview)12 diff -ur --new-file barcode-0.93/doc/barcode_toc.html barcode-0.94/doc/barcode_toc.html --- barcode-0.93/doc/barcode_toc.html Sun Sep 26 19:53:40 1999 +++ barcode-0.94/doc/barcode_toc.html Sun Oct 24 12:28:02 1999 @@ -1,14 +1,14 @@ + from barcode.texinfo on 24 October 1999 --> Barcode - Table of Contents -

barcode 0.93

+

barcode 0.94

A library for drawing bar codes

-

September 1999

+

October 1999

by Alessandro Rubini (rubini@{gnu.org,prosa.it})

@@ -31,7 +31,7 @@

-This document was generated on 26 September 1999 using the +This document was generated on 24 October 1999 using the texi2html translator version 1.51.

diff -ur --new-file barcode-0.93/doc/barcodedoc.txt barcode-0.94/doc/barcodedoc.txt --- barcode-0.93/doc/barcodedoc.txt Sun Sep 26 19:53:40 1999 +++ barcode-0.94/doc/barcodedoc.txt Sun Oct 24 12:28:01 1999 @@ -4,10 +4,10 @@ the input file barcode.texinfo. This file is the User's Manual for the barcode library (version -0.93). +0.94). - This file documents the 0.93 release of the barcode library and -sample programs (September 1999). + This file documents the 0.94 release of the barcode library and +sample programs (October 1999). @@ -163,7 +163,7 @@ The Flags ********* - The following flags are supported by version 0.93 of the library: + The following flags are supported by version 0.94 of the library: `BARCODE_ENCODING_MASK' The mask is used to extract the encoding-type identifier from the @@ -313,9 +313,11 @@ 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 - with -e and no error is printed if they don't match (this may be - construed as a bug). + 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-lenght). 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 @@ -484,16 +486,16 @@ -Tag Table:Node: Top281 - Node: Overview492 - Node: The Barcode Object1370 -Node: The Field List2753 -Node: Supported Flags6479 -Node: The API8988 -Node: The barcode Executable11689 -Node: The Command Line12142 -Node: Supported Encodings16588 -Node: Bugs and Pending Issues20459 +Tag Table:Node: Top279 + Node: Overview490 + Node: The Barcode Object1368 +Node: The Field List2751 +Node: Supported Flags6477 +Node: The API8986 +Node: The barcode Executable11687 +Node: The Command Line12140 +Node: Supported Encodings16727 +Node: Bugs and Pending Issues20598 diff -ur --new-file barcode-0.93/doc/doc.barcode barcode-0.94/doc/doc.barcode --- barcode-0.93/doc/doc.barcode Sun Sep 26 19:53:37 1999 +++ barcode-0.94/doc/doc.barcode Wed Oct 13 22:39:30 1999 @@ -31,8 +31,8 @@ @setchapternewpage off -@set version 0.93 -@set update-month September 1999 +@set version 0.94 +@set update-month October 1999 @finalout @@ -328,7 +328,7 @@ @chapter Functions Exported by the Library %MANPAGE barcode.3 -%M .TH BARCODE 3 "September 1999" "GNU" "GNU barcode" +%M .TH BARCODE 3 "October 1999" "GNU" "GNU barcode" %M .UC 4 %M .SH NAME %M barcode \- a library to create and print bar codes @@ -419,7 +419,7 @@ @chapter The @i{barcode} frontend program %MANPAGE barcode.1 -%M .TH BARCODE 1 "September 1999" "GNU" "GNU barcode" +%M .TH BARCODE 1 "October 1999" "GNU" "GNU barcode" %M .UC 4 %M .SH NAME %M barcode \- a stand alone program to run the barcode library @@ -471,9 +471,11 @@ 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{-t} is specified). The - strings must match the encoding chosen with @t{-e} and no - error is printed if they don't match (this may be construed as - a bug). + strings must match the encoding chosen; if it doesn't + match the program will print a warning to @t{stderr} and + generate ``blank'' output (although not zero-lenght). + Please note that a string including spaces or + other special characters must be properly quoted. @item -e encoding @b{encoding} is the name of the chosen encoding format being