xref: /netbsd-src/games/cgram/cgram.6 (revision 2718af68c3efc72c9769069b5c7f9ed36f6b9def)
1.\" $NetBSD: cgram.6,v 1.4 2021/04/29 20:17:20 rillig Exp $
2.\"
3.\" Copyright (c) 2004, 2013 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by David A. Holland.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE.
29.\"
30.Dd April 29, 2021
31.Dt CGRAM 6
32.Os
33.Sh NAME
34.Nm cgram
35.Nd solve Sunday-paper cryptograms
36.Sh SYNOPSIS
37.Nm Op Ar file
38.Sh DESCRIPTION
39.Nm
40is a curses-based widget for solving Sunday-paper-type cryptograms
41based on substitution ciphers.
42If
43.Ar file
44is given, it is used as cleartext, otherwise a random cleartext is
45chosen using
46.Xr fortune 6 ;
47either way, a random substitution key is generated.
48.Pp
49The ciphertext is displayed.
50Typing a letter changes the key so that the letter under the cursor
51maps to the newly typed letter, and updates the display accordingly.
52Use Emacs-type cursor commands to move around.
53Enter a tilde
54.Pq ~
55to quit.
56Press asterisk
57.Pq *
58to enter an easier mode where correct characters are displayed in
59boldface.
60.Sh SEE ALSO
61.Xr caesar 6
62.Sh HISTORY
63.Nm
64was written circa 2004.
65It was imported into
66.Nx
67in 2013 and first appeared in
68.Nx 7.0 .
69