source: projects/paper-tape/perl-tools/README.htm @ 30

Last change on this file since 30 was 30, checked in by sven, 15 years ago

Added new documentation as well as a great new layout and some new
features for the documentation system like syntax higlighting (using
geshi).
Furthermore much directory clean up and movements accross directories.

File size: 2.9 KB
Line 
1<html>
2<body>
3
4<h2>Perl tools</h2>
5
6<p>The perl tools are some self-explanatory perl scripts that e.g.
7   draw paper tapes (ASCII art), generate labels in different "fonts",
8   parse ASCII number files, etc.
9
10<p>They only require a perl compiler but nothing more -- no exotic
11   CPAN modules, etc. -- so they'll run on almost every platform.
12
13<h3>The files in detail</h3>
14
15<p>This is an overview over the perl tools:
16
17<ul>
18<li><a href="byte-tester">byte-tester</a>: Will simply output
19  a byte with the value you gave the program via argv[1]. Nice
20  for sending special bytes via shell scripts to the puncher
21<li><a href="hex-meter">hex-meter</a>: Generates a quite long
22  byte pattern that contains all possible byte values from 0x00
23  up to 0xFF. Nice for debugging and espacially practical for
24  counting rapidly the position on another paper tape.
25<li><a href="how-long-is-this-papertape">how-long-is-this-papertape</a>:
26  This is a kind of <tt>du</tt> shell utility for paper tapes &ndash;
27  it won't count the size some files take on your hard disk but
28  the length of paper tape they would produce if punched out ;-)
29<li><a href="label-it">label-it</a>: A very simple implementation of
30  a paper tape font: You input the label via command line arguments
31  and this script will produce some bytes that will look like text
32  when punched out on a paper tape ;-)
33  <br>This was the very first implementation of a paper tape font.
34<li><a href="punch-simulator">punch-simulator</a>: A very simple
35  program to print out how bytes (reading from STDIN) would look
36  on a paper tape. ASCII art :-)
37<li><a href="read-file">read-file</a>: This is a simple program that
38  reads in numbers from a text file and packs them together to bytes.
39  So this behaves a bit like byte-tester, only more complex.
40<li><a href="strip-null-bytes.c">strip-null-bytes (C program)</a>:
41  This is a quite simple program that strips all null bytes at the
42  start and end of a file/stdin and outputs that to stdout. Since
43  that s a quite low-level task, it's implemented in C.
44<li><a href="alter-udo-parser">udo-parser 0</a>,
45    <a href="udo-parser">udo-parser 1</a>: Some simple Perl ASCII
46  file parsers that generate byte data to stdout.
47</ul>
48
49
50<h3>Copyright for the complete directory</h3>
51<p>Copyright 2008 Sven Köppel, all tools in this directory are
52   released under the GPL.
53
54<p>The Paper Tape Project Perl Tools are free software: you can
55   redistribute them and/or modify them under the terms of the
56   GNU General Public License as published by the Free Software
57   Foundation, either version 2 of the License, or (at your option)
58   any later version.
59
60<p>Programs from the Paper Tape Project are distributed in the hope
61   that they will be useful, but WITHOUT ANY WARRANTY; without even
62   the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
63   PURPOSE.  See the GNU General Public License for more details.
64
65<p>For a copy of the GNU General Public License, see
66   <http://www.gnu.org/licenses/>.
Note: See TracBrowser for help on using the repository browser.
© 2008 - 2013 technikum29 • Sven Köppel • Some rights reserved
Powered by Trac
Expect where otherwise noted, content on this site is licensed under a Creative Commons 3.0 License