File: letterize.1

package info (click to toggle)
letterize 1.4-1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 116 kB
  • ctags: 18
  • sloc: ansic: 187; makefile: 83; xml: 55
file content (56 lines) | stat: -rw-r--r-- 2,994 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
'\" t
.\"     Title: letterize
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 04/05/2015
.\"    Manual: Miscellanea
.\"    Source: letterize
.\"  Language: English
.\"
.TH "LETTERIZE" "1" "04/05/2015" "letterize" "Miscellanea"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
letterize_ \- phone\-number to letter\-mnemonic generator
.SH "SYNOPSIS"
.HP \w'\fBletterize\fR\ 'u
\fBletterize\fR \fInnnnnnn\fR
.SH "DESCRIPTION"
.PP
This program tries to help you find a letter mnemonic matching a given phone number\&.
.PP
It emits to standard output each possible pronounceable mnemonic, one per line, using the American standard mapping of dial letters to numbers (2 goes to ABC, 3 to DEF, 4 to GHI, 5 to JKL, 6 to MNO, 7 to PRS, 8 to TUV, 9 to XYZ)\&.
.PP
The program uses a table of pronounceable letter\-triples derived from a dictionary scan\&. Each potential mnemonic must be such that all of its letter\-triples are in the table to be emitted\&. About 30% of possible triples are considered pronounceable\&.
.PP
A typical 7\-digit phone number has 19,683 possible mnemonics, but this test usually cuts the list down to a few hundred or so, a reasonable number to eyeball\-check\&. For some numbers, the list will, sadly, be empty\&.
.PP
It\*(Aqs best to leave out punctuation such as dashes and parens\&.
.SH "BUGS"
.PP
The filtering method doesn\*(Aqt know what plausible medial triples are not reasonable at the beginnings and ends of words\&.
.PP
I\*(Aqm not sure what table position 0 (which is what 0 and 1 are mapped to) means\&. If you figure it out, you tell me\&. I really should have generated my own table, but that would have been more work than this seemed worth \-\- if your number contains either, you probably need to generate your mnemonic in disjoint pieces around the digits anyway\&.
.SH "AUTHOR"
.PP
Eric S\&. Raymond
<esr@snark\&.thyrsus\&.com>\&. It\*(Aqs based on a table of plausible letter\-triples that had no name attached to it\&. Surf to
\m[blue]\fBhttp://www\&.catb\&.org/~esr/\fR\m[]
for updates and related resources\&.