Jason Filley – SnakeLegs

Here’s a quick script to determine shell, perl, PHP, and groff files, and then run a quick check on them. For my use, I also use the WDG’s ‘validate’ command-line HTML validator, from the OpenBSD ports/packages collection.

quickcheck.sh.txt

Continue reading »

RE: keyboard mappings (keymaps) on BeOS and its open-source successor Haiku.

• listarchives.zip – Archive of BEOS-KEYMAPS@LISTSERV.SNAKELEGS.COM mailing list (gone now).
• uni2utf8.zip – Command-line application to print all Unicode values and their respective UTF-8 encodings. Source code included (4KB).
• dvorak-us-standard.zip – Dvorak Standard Keyboard keymap and graphic.
• dvorak-ansi-x4.22-1983.zip – Dvorak ANSI X4.22-1983 keymap and graphic. This is the ‘official’ version that no one uses. It differs from the Standard only in the placement of the keys [ ] { } = +.
• unicode-utf8-list.zip – Text file containing all current Unicode characters and lists them in the following format:

  # SAMPLE: 0xe28da1	#  U+2361	APL FUNCTIONAL SYMBOL UP TACK DIAERESIS 0xe18f8a	#  U+13CA	CHEROKEE LETTER QUU

  The Unicode values and character names are taken from the 3.0 specification database.

• characterentries.jpg – This picture just might save you a lot of time. It is a sample of the ways to enter characters in a keymap.
• diacritics.txt – List of the Latin diacritics in keymap fashion.
• dvorak-right.gif – Graphic of the Dvorak Right-Handed layout.
• dvorak-left.gif – Graphic of the Dvorak Left-Handed layout.
• charactermap.jpg – Screenshot of Michal Kowalski‘s incredibly helpful application.

To check troff/groff input files for errors, run:

groff -b -z -w w filename

EXAMPLE:

groff -b -z -w w /usr/share/man/cat1/f77.0

/usr/share/man/cat1/f77.0:421: warning: escape character ignored before a backspace character
/usr/share/man/cat1/f77.0:425: warning: escape character ignored before a backspace character
/usr/share/man/cat1/f77.0:425: a backspace character is not allowed in an escape name
/usr/share/man/cat1/f77.0:428: warning: escape character ignored before a backspace character
/usr/share/man/cat1/f77.0:433: warning: escape character ignored before a backspace character
/usr/share/man/cat1/f77.0:763: warning: escape character ignored before a backspace character

To quickly check a perl script or module, run:

perl -c filename

Always turn on warnings and use strict:

#!/usr/local/bin/perl -w
use strict;

To check the pod documentation, run:

podchecker -warnings -warnings filename

EXAMPLE:

# podchecker -warnings -warnings /usr/local/bin/rsnapshot
*** WARNING: No items in =over (at line 4502) / =back list at line 4518 in file /usr/local/bin/rsnapshot
*** WARNING: No items in =over (at line 4546) / =back list at line 4559 in file /usr/local/bin/rsnapshot
*** WARNING: 2 unescaped <> in paragraph at line 4582 in file /usr/local/bin/rsnapshot
*** WARNING: 2 unescaped <> in paragraph at line 4584 in file /usr/local/bin/rsnapshot
*** WARNING: 4 unescaped <> in paragraph at line 4586 in file /usr/local/bin/rsnapshot
*** WARNING: 2 unescaped <> in paragraph at line 4589 in file /usr/local/bin/rsnapshot
*** WARNING: No items in =over (at line 4600) / =back list at line 4608 in file /usr/local/bin/rsnapshot