Quieten the linter

bwipp · Nov 21, 2020 · a650d93 · a650d93
1 parent 8a71eaf
commit a650d93
Show file tree

Hide file tree

Showing 20 changed files with 173 additions and 200 deletions.
diff --git a/README.md b/README.md
@@ -1,64 +1,84 @@
 Barcode Writer in Pure PostScript
 =================================
 
-[![GitHub license](https://img.shields.io/github/license/bwipp/postscriptbarcode.svg)](https://github.com/bwipp/postscriptbarcode/blob/master/LICENSE) [![Release](https://img.shields.io/github/release/bwipp/postscriptbarcode.svg)](https://github.com/bwipp/postscriptbarcode/releases/latest) [![Github commits (since latest release)](https://img.shields.io/github/commits-since/bwipp/postscriptbarcode/latest.svg)](https://github.com/bwipp/postscriptbarcode/commits/master) [![Travis](https://img.shields.io/travis/bwipp/postscriptbarcode/master.svg)](https://travis-ci.org/bwipp/postscriptbarcode)
+[![GitHub license](https://img.shields.io/github/license/bwipp/postscriptbarcode.svg)](https://github.com/bwipp/postscriptbarcode/blob/master/LICENSE)
+[![Release](https://img.shields.io/github/release/bwipp/postscriptbarcode.svg)](https://github.com/bwipp/postscriptbarcode/releases/latest)
+[![Github commits (since latest release)](https://img.shields.io/github/commits-since/bwipp/postscriptbarcode/latest.svg)](https://github.com/bwipp/postscriptbarcode/commits/master)
+[![Travis](https://img.shields.io/travis/bwipp/postscriptbarcode/master.svg)](https://travis-ci.org/bwipp/postscriptbarcode)
 
 Useful links:
 
-  * Homepage: https://bwipp.terryburton.co.uk
-  * Documentation: https://github.com/bwipp/postscriptbarcode/wiki
-  * Documentation in PDF format for print: https://bit.ly/2LzxYcU
-  * Download: https://github.com/bwipp/postscriptbarcode/releases/latest
-  * Source: https://github.com/bwipp/postscriptbarcode.git
-  * Support: https://github.com/bwipp/postscriptbarcode/issues?q=is%3Aissue+label%3Aquestion
-  * Issues: https://github.com/bwipp/postscriptbarcode/issues
-  * Presentation: Slides: https://goo.gl/WqYB6A Materials: https://goo.gl/dth54z
+* Homepage: <https://bwipp.terryburton.co.uk>
+* Documentation: <https://github.com/bwipp/postscriptbarcode/wiki>
+* Documentation in PDF format for print: <https://bit.ly/2LzxYcU>
+* Download: <https://github.com/bwipp/postscriptbarcode/releases/latest>
+* Source: <https://github.com/bwipp/postscriptbarcode.git>
+* Support: <https://github.com/bwipp/postscriptbarcode/issues?q=is%3Aissue+label%3Aquestion>
+* Issues: <https://github.com/bwipp/postscriptbarcode/issues>
+* Presentation: Slides: <https://goo.gl/WqYB6A> Materials: <https://goo.gl/dth54z>
 
-Barcode Writer in Pure Postscript (BWIPP) generates all barcode formats entirely within PostScript so that the process of converting the input data into the printed output can be performed by the printer or RIP itself. This is ideal for variable data printing (VDP) and avoids the need to re-implement the barcode generation process whenever your language needs change.
+Barcode Writer in Pure Postscript (BWIPP) generates all barcode formats
+entirely within PostScript so that the process of converting the input data
+into the printed output can be performed by the printer or RIP itself. This is
+ideal for variable data printing (VDP) and avoids the need to re-implement the
+barcode generation process whenever your language needs change.
 
-Since this resource is written in PostScript and interpreted within the virtual machine of a printer it is compatible with any operating system and hardware platform.
-
-It makes including any barcode within a PostScript document as simple as inserting the following directive:
+Since this resource is written in PostScript and interpreted within the virtual
+machine of a printer it is compatible with any operating system and hardware
+platform.
 
+It makes including any barcode within a PostScript document as simple as
+inserting the following directive:
 
     0 0 moveto (978-1-56581-231-4) (includetext)
     /isbn /uk.co.terryburton.bwipp findresource exec
 
 There is a web-based demonstration of the project here:
 
-https://the-burtons.xyz/barcode-generator/
+<https://the-burtons.xyz/barcode-generator/>
 
 This project is dedicated to the memory of Craig K. Harmon.
 
 
 "Flavours" of Named Resources
 -----------------------------
 
-BWIPP is essentially a set of generic PostScript Level 2 named resources that are provided in four flavours for ease of use. The one to use depends on how you intend to deploy the library.
+BWIPP is essentially a set of generic PostScript Level 2 named resources that
+are provided in four flavours for ease of use. The one to use depends on how
+you intend to deploy the library.
 
-  * "Packaged" or "unpackaged": The named resources have been packaged for DSC conformance, portability and ease of distribution. You will most likely want to use a packaged flavour in production, however the unpackaged versions of the resources are useful for understanding the code, developing the library and debugging.
+* "Packaged" or "unpackaged": The named resources have been packaged for DSC
+  conformance, portability and ease of distribution. You will most likely want
+  to use a packaged flavour in production, however the unpackaged versions of
+  the resources are useful for understanding the code, developing the library
+  and debugging.
 
-  * "Separate files" or "monolithic": The resource is provided as separate files that are formatted for direct use by Adobe Distiller, GhostScript, a printer hard disk or a document manager. The monolithic flavours contain all of the resources in a single file that is suitable for inclusion in the Prolog section of a each PostScript document or installing to a printer's initial job VM to provide persistence between jobs until the device is reset.
+* "Separate files" or "monolithic": The resource is provided as separate files
+  that are formatted for direct use by Adobe Distiller, GhostScript, a printer
+  hard disk or a document manager. The monolithic flavours contain all of the
+  resources in a single file that is suitable for inclusion in the Prolog
+  section of a each PostScript document or installing to a printer's initial
+  job VM to provide persistence between jobs until the device is reset.
 
 This leads to the following set of four files.
 
 For production use:
 
-  * `postscriptbarcode-packaged-resource` – Packaged; Separate files.
-  * `postscriptbarcode-monolithic-package` – Packaged; Monolithic file.
+* `postscriptbarcode-packaged-resource` – Packaged; Separate files.
+* `postscriptbarcode-monolithic-package` – Packaged; Monolithic file.
 
 For BWIPP development:
 
-  * `postscriptbarcode-resource` – Unpackaged; Seperate files.
-  * `postscriptbarcode-monolithic` – Unpackaged; Monolithic file.
+* `postscriptbarcode-resource` – Unpackaged; Seperate files.
+* `postscriptbarcode-monolithic` – Unpackaged; Monolithic file.
 
 
 Downloading
 -----------
 
 You can download prepared packages and the sources from here:
 
-https://github.com/bwipp/postscriptbarcode/releases/latest
+<https://github.com/bwipp/postscriptbarcode/releases/latest>
 
 Alternatively you can get and build the latest from version control:
 

diff --git a/SECURITY.md b/SECURITY.md
@@ -2,10 +2,13 @@
 
 ## Supported Versions
 
-All development is based done against the current head of the master branch, with releases being tagged periodically. 
+All development is based done against the current head of the master branch,
+with releases being tagged periodically.
 
 ## Reporting a Vulnerability
 
-For BWIPP, most security bugs are "just bugs" so report them openly via the issue tracker.
+For BWIPP, most security bugs are "just bugs" so report them openly via the
+issue tracker.
 
-If you determine that the issue is so serious as to place users' systems at grave risk then feel free to contact the author directly.
+If you determine that the issue is so serious as to place users' systems at
+grave risk then feel free to contact the author directly.
diff --git a/cited-by.md b/cited-by.md
@@ -6,56 +6,54 @@ The following is a list of known references to Barcode Writer in Pure PostScript
 If you are aware of any noteworthy additions to this list then please send a patch.
 
 
-#### Barcode Writer in Pure PostScript
+Barcode Writer in Pure PostScript
+---------------------------------
 
-https://bwipp.terryburton.co.uk
+Martínez, Juan J. (2004) "A Barcode Generator in Pure PostScript," <http://blackshell.usebox.net/archive/a-barcode-generator-in-pure-postscript.html>
 
-Martínez, Juan J. (2004) "A Barcode Generator in Pure PostScript," http://blackshell.usebox.net/archive/a-barcode-generator-in-pure-postscript.html
+Flack, Chapman. (2006) "Direct Use of the PostScript Language," <http://www.anastigmatix.net/postscript/direct.html>
 
-Flack, Chapman. (2006) "Direct Use of the PostScript Language," http://www.anastigmatix.net/postscript/direct.html
+Rocholl, Johann C. (2009) "Robust 1D Barcode Recognition on Mobile Devices," <https://ieeexplore.ieee.org/document/5597018/>
 
-Rocholl, Johann C. (2009) "Robust 1D Barcode Recognition on Mobile Devices," https://ieeexplore.ieee.org/document/5597018/
+Scarso, Luigi. (2009) "Una estensione di luatex: luatex lunatic," <http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.188.5052&rep=rep1&type=pdf>
 
-Scarso, Luigi. (2009) "Una estensione di luatex: luatex lunatic," http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.188.5052&rep=rep1&type=pdf
+Pluimers, Jeroen W. (2009) "Generating EAN-13 barcode EPS files for your article numbers," <http://wiert.me/2009/11/30/generating-ean-13-barcode-eps-files-for-your-article-numbers/>
 
-Pluimers, Jeroen W. (2009) "Generating EAN-13 barcode EPS files for your article numbers," http://wiert.me/2009/11/30/generating-ean-13-barcode-eps-files-for-your-article-numbers/
+Russell, Robert. (2010) "Barcodes in SAP with the Barcode Writer in Pure Postscript," <https://blogs.sap.com/2010/10/25/barcodes-in-sap-with-the-barcode-writer-in-pure-postscript/>
 
-Russell, Robert. (2010) "Barcodes in SAP with the Barcode Writer in Pure Postscript," https://blogs.sap.com/2010/10/25/barcodes-in-sap-with-the-barcode-writer-in-pure-postscript/
+Seichter, Dominik. (2010) "KBarcode4 Light Released," <http://domseichter.blogspot.com/2010/08/kbarcode4-light-released.html>
 
-Seichter, Dominik. (2010) "KBarcode4 Light Released," http://domseichter.blogspot.com/2010/08/kbarcode4-light-released.html
+Willis, Nathan. (2010) "Barcode Writer in Pure PostScript," Worldlabel.com Incorporated. <http://blog.worldlabel.com/2010/barcode-writer-in-pure-postscript.html>
 
-Willis, Nathan. (2010) "Barcode Writer in Pure PostScript," Worldlabel.com Incorporated. http://blog.worldlabel.com/2010/barcode-writer-in-pure-postscript.html
-
-Russell, Robert. (2010) "How to Print(PDF) QR Codes in standard SAP," http://www.rjruss.info/2010/09/how-to-printpdf-qr-codes-in-standard.html
+Russell, Robert. (2010) "How to Print(PDF) QR Codes in standard SAP," <http://www.rjruss.info/2010/09/how-to-printpdf-qr-codes-in-standard.html>
 
 Zhao, Y., Sun, W. (2010) "Practice of Imposition and Illustrator Variable Data Plate Making with Barcode," Proceedings of 17th IAPRI World Conference on Packaging. ISBN 978-1-935068-36-5.
 
-Russell, Robert. (2011) "More Barcodes with Barcode Writer in Pure Postscript," https://blogs.sap.com/2011/01/31/more-barcodes-with-barcode-writer-in-pure-postscript/
+Russell, Robert. (2011) "More Barcodes with Barcode Writer in Pure Postscript," <https://blogs.sap.com/2011/01/31/more-barcodes-with-barcode-writer-in-pure-postscript/>
 
-McNulty, John. (2011) "The Secret Lives of Objects," Sonic Arts Research Centre. Queen’s University Belfast. http://www.robotmouth.com/papers_files/TSLOO.pdf
+McNulty, John. (2011) "The Secret Lives of Objects," Sonic Arts Research Centre. Queen’s University Belfast. <http://www.robotmouth.com/papers_files/TSLOO.pdf>
 
-Russell, Robert. (2013) "Add FREE barcodes to the SAP Latin2 HP printer Driver," http://www.rjruss.info/2013/02/add-free-barcodes-to-sap-latin2-hp.html
+Russell, Robert. (2013) "Add FREE barcodes to the SAP Latin2 HP printer Driver," <http://www.rjruss.info/2013/02/add-free-barcodes-to-sap-latin2-hp.html>
 
 Ehlenbroker J., Lohweg V. (2014) "microIDENT - A System for Simple Coding and Authentication of Documents," Optical Document Security - The Conference on Optical Security and Counterfeit Detection IV.
 
-Russell, Robert. (2014) "Example SAP Smartform with QRcodes using the Barcode Writer in Pure Postscript," http://www.rjruss.info/2014/09/example-sap-smartform-with-qrcodes.html
+Russell, Robert. (2014) "Example SAP Smartform with QRcodes using the Barcode Writer in Pure Postscript," <http://www.rjruss.info/2014/09/example-sap-smartform-with-qrcodes.html>
 
 Scarso, Luigi. (2015) "Two applications of SWIGLIB: GraphicsMagick and Ghostscript," The TUGboat Journal, Volume 36, Number 3. p. 237.
 
 Ehlenbroker J., Lohweg V. (2016) "System for simple coding, authentication and copy detection of printed documents," U.S. Patent Application 15/114,422, published December 2016.
 
-Berisso, K. (2018) "DotCode Damage Testing," Journal of Computer Sciences and Applications, Volume 6, Number 1. pp. 43-47. http://pubs.sciepub.com/jcsa/6/1/6
-
-West, M., Campbell C. (2018) "barcOwned: Popping Shells with Your Cereal Box," DEF CON 26. https://www.youtube.com/watch?v=Wy79TLkqArg
+Berisso, K. (2018) "DotCode Damage Testing," Journal of Computer Sciences and Applications, Volume 6, Number 1. pp. 43-47. <http://pubs.sciepub.com/jcsa/6/1/6>
 
-Russell, Robert. (2020) "How to Print QRcodes, Data Matrix, Aztec Codes, Maxi Code and Han Xin Barcodes in SAP," https://www.rjruss.info/2020/04/how-to-print-qrcodes-data-matrix-aztec.html
+West, M., Campbell C. (2018) "barcOwned: Popping Shells with Your Cereal Box," DEF CON 26. <https://www.youtube.com/watch?v=Wy79TLkqArg>
 
-Burton, T. and Wright IV, G. (2020) "GS1 Updates Global Model Number Identifier For Use as a Basic UDI-DI to Meet EU MDR Requirements," MedTech Intelligence. https://www.medtechintelligence.com/feature_article/gs1-updates-global-model-number-identifier-for-use-as-a-basic-udi-di-to-meet-eu-mdr-requirements/
+Russell, Robert. (2020) "How to Print QRcodes, Data Matrix, Aztec Codes, Maxi Code and Han Xin Barcodes in SAP," <https://www.rjruss.info/2020/04/how-to-print-qrcodes-data-matrix-aztec.html>
 
+Burton, T. and Wright IV, G. (2020) "GS1 Updates Global Model Number Identifier For Use as a Basic UDI-DI to Meet EU MDR Requirements," MedTech Intelligence. <https://www.medtechintelligence.com/feature_article/gs1-updates-global-model-number-identifier-for-use-as-a-basic-udi-di-to-meet-eu-mdr-requirements/>
 
-#### pst-barcode
 
-http://www.ctan.org/tex-archive/graphics/pstricks/contrib/pst-barcode/
+pst-barcode
+-----------
 
 Goossens, M., Mittelbach F., Rahtz, S., Roegel, D. (2007) "The LaTeX Graphics Companion," Addison Wesley. ISBN 978-0-321-50892-8.
 
@@ -67,9 +65,9 @@ Voß, Herbert. (2010) "The current state of the PSTricks project," The TUGboat J
 
 Voß, Herbert. (2011) "Ch 26: pst-barcode - Bar codes" in "PSTricks. Graphics and PostScript for TeX and LaTeX," Cambridge: UIT Cambridge. pp. 497-508.
 
-Molnar, Peter. (2013) "Processing class assignments on paper (Part I)," Blog: I'd rather be programming... http://blog.petermolnar.us/2013/03/processing-class-assignments-on-paper.html
+Molnar, Peter. (2013) "Processing class assignments on paper (Part I)," Blog: I'd rather be programming... <http://blog.petermolnar.us/2013/03/processing-class-assignments-on-paper.html>
 
-Voß, Herbert. (2013) "QR-Codes im Rand ausgeben [QR Codes in the Margin]," Die TEXnische Komödie 4/2013. pp. 34–37. http://archiv.dante.de/DTK/PDF/komoedie_2013_4.pdf
+Voß, Herbert. (2013) "QR-Codes im Rand ausgeben [QR Codes in the Margin]," Die TEXnische Komödie 4/2013. pp. 34–37. <http://archiv.dante.de/DTK/PDF/komoedie_2013_4.pdf>
 
 Fischer, Ulrike. (2014) "biblatex variations," The TUGboat Journal, Volume 35, Number 3. pp. 256-260.
 
@@ -82,29 +80,19 @@ Tibi, Daniel. (2016) "Easy Codes: Generating Barcodes and QR Codes With LaTeX."
 Voß, Herbert. (2017) "The current state of the PSTricks project," The TUGboat Journal, Volume 38, Number 3. p. 329.
 
 
-#### Barcode Writer in Pure JavaScript
-
-https://github.com/metafloor/bwip-js
+Barcode Writer in Pure JavaScript
+---------------------------------
 
-Russell, Robert. (2015) "Barcodes in SAP with the Barcode Writer in Pure Postscript Updated and Also Available in JavaScript," https://blogs.sap.com/2015/02/01/barcodes-in-sap-with-the-barcode-writer-in-pure-postscript-updated-and-also-available-in-javascript/
+Russell, Robert. (2015) "Barcodes in SAP with the Barcode Writer in Pure Postscript Updated and Also Available in JavaScript," <https://blogs.sap.com/2015/02/01/barcodes-in-sap-with-the-barcode-writer-in-pure-postscript-updated-and-also-available-in-javascript/>
 
 
-#### Scribus Barcode Generator Plugin
-
-http://documentation.scribus.net/index.php/Barcode_Generator
+Scribus Barcode Generator Plugin
+--------------------------------
 
 "Libre Graphics: Scribus. Open Source Desktop Publishing Turns Pro," Linux Format, Issue 80 (June 2006). Future Publishing. p. 54.
 
-Byfield, Bruce. (2011) "Four Hidden Tools in Scribus," Linux Journal, November 2011. Belltown Media Inc. http://www.linuxjournal.com/content/four-hidden-tools-scribus
+Byfield, Bruce. (2011) "Four Hidden Tools in Scribus," Linux Journal, November 2011. Belltown Media Inc. <http://www.linuxjournal.com/content/four-hidden-tools-scribus>
 
-Willis, Nathan. (2013) "Scribus 1.4.3 adds color models and more," LWN.net. Eklektix, Inc. https://lwn.net/Articles/563035/
+Willis, Nathan. (2013) "Scribus 1.4.3 adds color models and more," LWN.net. Eklektix, Inc. <https://lwn.net/Articles/563035/>
 
 White, Robert. (2015) "Beginning Scribus," Apress Media, LLC. pp 300-301. ISBN 978-1-4842-0722-2.
-
-
-#### KBarcode
-
-http://www.kbarcode.net/
-
-Willis, Nathan. (2010) "Generating Barcodes with KBarcode," Worldlabel.com Incorporated. http://blog.worldlabel.com/2010/generating-barcodes-with-kbarcode.html
-
diff --git a/contrib/Examples/perl/ean13_print/ean13s.pl b/contrib/Examples/perl/ean13_print/ean13s.pl
@@ -3,9 +3,9 @@
 
 die 'Requires two arguments' if (@ARGV!=2);
 
-open(PS,'barcode.ps') || die 'File not found';
-$_=join('',<PS>);
-close(PS);
+open (my ($ps), '<', 'barcode.ps') || die 'File not found';
+$_=join('',<$ps>);
+close($ps);
 
 print "%!PS-Adobe-2.0\n";
 

diff --git a/contrib/Examples/perl/eps_gen/genfigs.pl b/contrib/Examples/perl/eps_gen/genfigs.pl
@@ -2,9 +2,9 @@
 
 use strict;
 
-open(PS,'barcode.ps') || die 'File not found';
-$_=join('',<PS>);
-close(PS);
+open (my ($ps), '<', 'barcode.ps') || die 'File not found';
+$_=join('',<$ps>);
+close($ps);
 m/
     %\ --BEGIN\ TEMPLATE--
     (.*)
@@ -19,11 +19,11 @@
 $template.="[% call %]\n";
 $template.="showpage\n";
 
-open(IN,'figs.txt');
-my @figs=<IN>;
-close(IN);
+open (my ($in), '<', 'figs.txt') || die 'File not found';
+my @figs=<$in>;
+close($in);
 
-foreach $_ (@figs) {
+foreach (@figs) {
     m/^(.*):(.*):(.*):(.*)$/ || die "Bad line: $_";
     my $filename=$1;
     my $width=$2;
@@ -33,16 +33,7 @@
     $barcode=~s/\[% call %\]/$contents/;
     $barcode=~s/\[% width %\]/$width/;
     $barcode=~s/\[% height %\]/$height/;
-    open(OUT,"> $filename");
-    print OUT $barcode;
-    close(OUT);
+    open(my ($out), '>', $filename) || die 'Open file failed';
+    print $out $barcode;
+    close($out);
 }
-
-
-
-
-
-
-
-
-
diff --git a/libs/README.md b/libs/README.md
@@ -11,7 +11,7 @@ directly or embed lots of static data about the resources in their code.
 
 The library implements parsing of the Metadata Specification provided here:
 
-https://github.com/bwipp/postscriptbarcode/wiki/Metadata-Specification
+<https://github.com/bwipp/postscriptbarcode/wiki/Metadata-Specification>
 
 
 Building