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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
|
# The man page reading club: tetris(6)
*This post is part of a [series](../../series)*
Sometimes you just need to relax and have some fun :-)
## Boredom
*"Phew, that was a long read!" you think as you reach the end of the
`sh(1)` manual page. After such an intense brain-workout you would
normally have a nice walk outside - but the Geiger counter on the wall
tells you that this might not be a good idea in this timeline. Your second
choice would be to have a beer and listen to some good music or watch a
movie, but none of these options is available in the bunker. It's almost
as if the nuclear winter is... bad?*
*You try to think what else you can do to ease your boredom.
There's no internet, no books, no videogames... wait a minute!*
```
$ man man
```
*You scroll down until you see the list of available sections, and
you find the one you were looking for:*
```
6 Games.
```
*Yes! You thought you saw this
[some time ago](https://sebastiano.tronto.net/blog/2022-05-29-man),
but you had ignored it. You also remember that the `intro(1)` page
mentioned analogous intoductory pages for each section. So you type:*
```
$ man 6 intro
```
*And so you discover that the folder `/usr/games` contains dozens of
games and other fun little programs. These are already installed in your
system, no need to download files or insert CD roms.*
*There is so much choice, so many games you have never heard of. But for
this time you decide to go with a classic.*
## tetris(6)
*Follow along at [man.openbsd.org](https://man.openbsd.org/OpenBSD-7.1/tetris)*
Before starting the game it is better to learn the rules, so let's type
`man tetris` first!
```
DESCRIPTION
The tetris command runs a display-based game. The object is to fit
shapes together to form complete rows, which then vanish. When the
shapes fill up to the top, the game ends.
```
The default control keys are listed below:
```
j move left
k rotate 1/4 turn counterclockwise
l move right
<space> drop
p pause
q quit
```
Some of the options are quite straightforward: `-c` to play in "classic
mode", with a slightly different graphics and shapes that turn clockwise;
`-l` to specify a level; `-p` to show the next shape that will drop, in
exchange for a lower score; `-s` to print the highscores and exit. The
most interesting is `-k`:
```
-k keys
The default control keys can be changed using the -k option. The
keys argument must have the six keys in order; remember to quote
any space or tab characters from the shell.
```
The sections PLAY and SCORING explain the gameplay and the criteria for
assigning points. There is also an ENVIRONMENT section with a single line:
```
LOGNAME Name displayed in high score file.
```
This means that you can set that shell variable to have your score
saved in the `$HOME/.tetris.score` file under a different name -
this can be useful for example when lending your pc to someone else
to let them play.
## Having fun
*"Enough of this reading, let's just play!"*
*You decide to remap the keys to play with your left hand, and to use the
old nick name you used on online forums, when the internet still existed.
And why not trying the "classic" mode as well?*
```
$ LOGNAME=porkynator tetris -c -k 'asd pq'
```
*And you start playing the night away*
```
Score: 47 [] []
[] []
[] []
[] [] []
[] [][] []
[] [] []
[] []
[] []
[] []
[] []
[] []
[] []
[] []
[] []
[] []
[] []
[] [][]
[][][] [][]
[][][][] [][]
[][][][] [][]
[][][][][][][][][][][][]
a - left s - rotate d - right <space> - drop p - pause q - quit
```
## Conclusions
This was a short and unimportant post meant to cool down after last month's
double post on the shell. I'll take it as an excuse to mention that `/usr/games`
[won't be in the default `$PATH`](https://undeadly.org/cgi?action=article;sid=20220810120423)
starting from OpenBSD 7.2. If you want to have a fun tetris session,
in the future you might have to specify the full path
```
$ /usr/games/tetris
```
or just update your `$PATH`.
*Next in the series: [ed(1)](../2022-12-24-ed)*
|
