diff -Nurd cadubi-1.3.orig/cadubi cadubi-1.3/cadubi --- cadubi-1.3.orig/cadubi Fri Feb 20 01:05:10 2004 +++ cadubi-1.3/cadubi Fri Jun 17 09:43:04 2005 @@ -1,4 +1,4 @@ -#!/usr/bin/perl +#!/usr/bin/env perl5.8.6 ## ## IMPORTANT -- Cadubi is no longer being maintained. 1.3 is a release ## for licensing and documentation fixes. See: @@ -6,9 +6,6 @@ ## http://langworth.com/CadubiProject ## -eval 'exec /usr/local/stow/perl-5.8.x/bin/perl -w -S $0 ${1+"$@"}' - if 0; # not running under some shell - $VERSION = '1.3'; ######################################################################## @@ -17,14 +14,12 @@ # kludge to make this easier (?) for package maintainers # (sorry guys, i wrote this years before i had the remotest clue as to # what the hell i was doing) -use FindBin qw($Bin); -$HELPFILE = "$Bin/help.txt"; +$HELPFILE = '@PREFIX@/share/cadubi/help.txt'; # other stuff $DEBUG = 0; $CADUBI_VERSION = $VERSION; use Term::ReadKey; -use lib "$Bin/../lib"; # global variables $ESC = "\x1b"; # our most important var diff -Nurd cadubi-1.3.orig/cadubi.1 cadubi-1.3/cadubi.1 --- cadubi-1.3.orig/cadubi.1 Wed Dec 31 19:00:00 1969 +++ cadubi-1.3/cadubi.1 Fri Jun 17 09:12:19 2005 @@ -0,0 +1,156 @@ +.\" created by Abel Daniel for the Debian Gnu/Linux version, but may be used by + others. +.TH "cadubi" "1" "1.1b1-4" "Abel Daniel" "User commands" +.SH "NAME" +cadubi \- Creative ASCII Drawing Utility By Ian +.SH "DESCRIPTION" +cadubi is an application written in Perl that allows you to draw text\-based +images that are viewable on typical UNIX\-based consoles. Usually the +applications +that emulate these consoles support various text modes, such as background and +foreground colors, bold, and inverse. This text art, commonly called +"ASCII art", is used in various places such as online BBSes, email and +login prompts. +.SH "OPTIONS" +.TP +.B \-h \-\-help +display some documentation +.TP +.BI \-m \-\-mute +turn off beeping +.TP +.BI "\-s ["W "] ["H ] +.TP +.BI "\-\-size ["W "] ["H ] +sets the size of the console for use with cadubi, where W is number of columns +and H is number of rows. +.TP +.B \-v \-\-version +show cadubi's version +.SH "CONFIGURING" +Beeping and commandline options can be also set in /usr/bin/cadubi. +.SH "KEYBOARD" +.TP +.B i j k l +Move the cursor around. Holding down shift and typing these keys will move the +ursor five spaces instead of one. +.TP +.B space +Paint the current pen on the screen. +.TP +.B return/enter +Move the cursor down one line and all the way to the left of the console. +.TP +.BI "delete " "or " "backspace " "or "` +Delete the caracter before the cursor. +.TP +.B p +Prompt for a pen character +.TP +.B f +Prompt for foreground color (see section colors). +.TP +.B b +Prompt for background color (see section colors). +.TP +.B g +Toggle bold mode. +.TP +.B v +Toggle inverse mode. +.TP +.B shift-w +Toggle blink (highly annoying). +.TP +.B t +Enter text mode. This allows you to type like as if you were using a normal +text editor, and all the characters drawn onscreen will use the same mode +as the pen +. +Pressing Esc will exit text mode. +.TP +.B control-w +Refresh the entire screen by redrawing each character. +.TP +.B control-r +Open a file. +.TP +.B control-o +Save the file. +.TP +.B control-h +Show the quick help screen. +.TP +.B control-x +Exit cadubi. +.SH "USING" +Cadubi has a 'pen' which describes the current mode. Properties of the pen are +the painting character, foreground color, background color, bold, inverse, and +blink. Whenever you paint or use the text mode, the characters drawn on the +screen will have the properties of the pen. The current mode of the pen is +shown at the bottom of the console and is what will be drawn on screen +when you paint. +. +Typically, foreground text colors are the same as background colors, unless +the text is bold. If the text is bold, foreground colors are usually lighter +than +the background color, making text easier to read when the text has the same +foreground and background color. Refer to the Quick Help (control-'h') to see +what the colors look like on your console. + +Text mode is an extremely useful feature. Once in the text mode you can type +as if you were using a normal text editor, and all the characters drawn +onscreen will use the same mode as the pen. To enter text mode, +press the 't' key. To exit, press escape. + +When cadubi reads a file, it will only read as much that will fit in the +workspace (the area of the console minus the bottom row [status bar]). To gain +more workspace, see the '-s' operator in section "options". + +Cadubi optimizes its output files to display properly and take up as little +space as possible. All cadubi output can be viewed with the 'cat' utility. + +.SH "COLORS" +The color codes are case-insensitive. +The following color codes can be choosed as fore- or background colors: +.IP +0 or N \- Normal (standard text) +.IP +1 or W \- White +.IP +2 or R \- Red +.IP +3 or G \- Green +.IP +4 or Y \- Yellow +.IP +5 or B \- Blue +.IP +6 or M \- Magenta +.IP +7 or C \- Cyan +.IP +8 or K \- Black +.SH "WARNING" +Cadubi uses escape sequences for things like color. These may differ from +system to system. This means that the file generated by cadubi may +trash your console when viewed with for example cat. +It is generally safe to use the files on the +same type of console as they were generated on. +.SH "AUTHORS" +Cadubi was created and is currently being maintained by Ian Langworth. Please +send all questions, comments, hate mail and bug reports to cadubi@logicallemon. +com +.SH "SEE ALSO" +The "Keyboard and Console HOWTO" and the "Text Terminal HOWTO" from the +Linuxdoc project (www.linuxdoc.org). Both are available in a Debian GNU/Linux +system by installing the doc-linux-text package at +.B /usr/share/doc/HOWTO/en-txt/Keyboard-and-Console-HOWTO.gz +and +.B /usr/share/doc/HOWTO/en-txt/Text-Terminal-HOWTO.gz +respectively. + +This man page was copy-pasted from other documentation by Abel Daniel (abli@mai +lbox.hu) for the Debian GNU/Linux distributions, but can be used by +others. +