forked from sulkasormi/frogcomposband
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
214 lines (166 loc) · 10.2 KB
/
readme.txt
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
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
--- DISCLAIMER ---
FrogComposband may ruin your social life, work productivity, or
daily exercise routine. You play the game at your own risk; in no
event shall the FrogComposband authors owe you a new keyboard, or
be liable to you for any other direct, indirect, punitive, magical
or other injuries or damages of any nature whatsoever.
----- How to install -----
--- LINUX (instructions by Chris Kousky; lightly edited)
Download and unpack the source archive, or clone the git repository:
$ git clone https://github.com/sulkasormi/frogcomposband.git
Make sure you have the appropriate development packages installed.
For example, you might run (Ubuntu or Mint):
$ sudo apt-get install autoconf gcc libc6-dev libncursesw5-dev libx11-dev
From the root of the source archive:
$ sh autogen.sh
$ ./configure
$ make clean
$ make
To install, you may need to elevate your credentials:
$ su
$ make install
$ exit
Then run frogcomposband as desired:
$ frogcomposband -- -n<number of windows> ## for normal ASCII graphics (recommended)
or
$ frogcomposband -g -- -n<# of windows> ## for 8x8 tile graphics
NOTE: some users have reported installation problems when compiling under
Linux (and Mac). Running ./configure using the --with-no-install parameter
will bypass this issue by building an executable to run in-place.
You can change game windows' font, location, and size, by environment
variables, for example:
$ set env ANGBAND_X11_FONT '-*-*-medium-r-normal--24-*-*-*-*-*-iso8859-1'
$ frogcomposband -- -n
Then font size will be changed.
You can set ANGBAND_X11_FONT_n for a specific window which has window number n.
Window locations are ANGBAND_X11_AT_X_n and ANGBAND_X11_AT_Y_n.
Window sizes are ANGBAND_X11_COLS_n and ANGBAND_X11_ROWS_n.
(Thanks to Nick McConnell for implementing and improving building under Linux/MAC!)
(ALT: For development, doing an install is undesirable. Try the following instead:
$ sudo apt-get install clang-3.5 llvm-3.5
$ sh autogen.sh
$ ./configure SANITIZE_FLAGS=-fsanitize=address --with-no-install CC=clang-3.5
$ make clean
$ make -j4
$ cp src/frogcomposband .
$ ASAN_SYMBOLIZER_PATH=/usr/bin/llvm-symbolizer-3.5 ./frogcomposband -g -u<Savefile> -- -n1
Note: Never pass sanitizer flags to CFLAGS as sanitizing configure causes it to fail.
Instead, configure will append SANITIZE_FLAGS to CFLAGS and LDFLAGS once it has finished
generating test programs. (see configure.ac)
Note, you need to remember to copy the executable up after every build (TODO: Fix Makefile to do this!)
Also, I like to develop with the address sanitizer enabled at all times. This works best with clang as
your compiler, rather than gcc. Of course, 3.5 should be replaced with latest version of clang.).
***Fonts on Linux: My experience with linux has been that the fonts are just plain awful. Here, I document
how I managed to install better fonts and use them in FrogComposband. I spent nearly a day on this, so I'm
hoping this might prove useful to somebody else. But mostly, it is here to remind me how I did so I don't
stumble so much next time.
[1] Install some better fonts. For example
$ sudo apt-get install fonts-liberation
[2] See what fonts are on your system that FrogComposband can use:
$ xlsfonts
Notice that the new fonts aren't there!
[3] Find where the new fonts were installed. For example
$ fc-list | grep liberation
/usr/share/fonts/truetype/liberation/LiberationSansNarrow-Italic.ttf: Liberation Sans Narrow:style=Italic
/usr/share/fonts/truetype/liberation/LiberationSans-Regular.ttf: Liberation Sans:style=Regular
/usr/share/fonts/truetype/liberation/LiberationMono-BoldItalic.ttf: Liberation Mono:style=Bold Italic
/usr/share/fonts/truetype/liberation/LiberationSerif-Italic.ttf: Liberation Serif:style=Italic
/usr/share/fonts/truetype/liberation/LiberationMono-Bold.ttf: Liberation Mono:style=Bold
/usr/share/fonts/truetype/liberation/LiberationSansNarrow-Regular.ttf: Liberation Sans Narrow:style=Regular
/usr/share/fonts/truetype/liberation/LiberationSerif-Bold.ttf: Liberation Serif:style=Bold
/usr/share/fonts/truetype/liberation/LiberationMono-Regular.ttf: Liberation Mono:style=Regular
/usr/share/fonts/truetype/liberation/LiberationSans-Italic.ttf: Liberation Sans:style=Italic
/usr/share/fonts/truetype/liberation/LiberationSerif-BoldItalic.ttf: Liberation Serif:style=Bold Italic
/usr/share/fonts/truetype/liberation/LiberationSansNarrow-BoldItalic.ttf: Liberation Sans Narrow:style=Bold Italic
/usr/share/fonts/truetype/liberation/LiberationMono-Italic.ttf: Liberation Mono:style=Italic
/usr/share/fonts/truetype/liberation/LiberationSans-BoldItalic.ttf: Liberation Sans:style=Bold Italic
/usr/share/fonts/truetype/liberation/LiberationSerif-Regular.ttf: Liberation Serif:style=Regular
/usr/share/fonts/truetype/liberation/LiberationSansNarrow-Bold.ttf: Liberation Sans Narrow:style=Bold
/usr/share/fonts/truetype/liberation/LiberationSans-Bold.ttf: Liberation Sans:style=Bold
[4] Bang head on wall in frustration!!
[5] Tell X Server about the fonts:
$ cd /usr/share/fonts/truetype/liberation/
$ su
$ mkfontscale
$ mkfontdir
$ exit
$ cat fonts.dir
...
LiberationMono-Regular.ttf -misc-liberation mono-medium-r-normal--0-0-0-0-m-0-adobe-standard
LiberationMono-Regular.ttf -misc-liberation mono-medium-r-normal--0-0-0-0-m-0-ascii-0
LiberationMono-Regular.ttf -misc-liberation mono-medium-r-normal--0-0-0-0-m-0-ibm-cp437
... [and many more]
$ xset +fp /usr/share/fonts/truetype/liberation
$ xset fp rehash
$ xlsfonts | grep liberation
...
-misc-liberation sans-medium-i-normal--0-0-0-0-p-0-iso8859-1
-misc-liberation sans-medium-i-normal--0-0-0-0-p-0-iso8859-10
-misc-liberation sans-medium-i-normal--0-0-0-0-p-0-iso8859-13
-misc-liberation sans-medium-i-normal--0-0-0-0-p-0-iso8859-15
-misc-liberation sans-medium-i-normal--0-0-0-0-p-0-iso8859-16
... [and many more]
[6] Now, try to find a font you like. For example:
$ cd [path to frogcomposband]
~/Src/frogcomposband> ANGBAND_X11_FONT='-misc-liberation mono-medium-r-normal--20-0-0-0-m-0-iso8859-1' ./frogcomposband -mx11
You can play with the point size since these are vector fonts. I chose 20pt since my eyes suck!
[7] Smile. Grab beer to recover from step [4].
--- Curses
Curses is for Linux, of course, so everything said above also applies here.
To run with a single 'big' terminal, simply run, for example:
$ ./frogcomposband -mgcu -uCrusher
To add additional terminal windows, you need to specify sub-options. You can
configure, from the command line, a strip of terminals on the right hand side
of the screen, or on the bottom of the screen, or both.
For example:
$ ./frogcomposband -mgcu -uCrusher -- -right 57x26,*
This specifies that the right hand strip will be be 57 columns wide, and will
contain 2 additional terminals. The first one, on top, will be 57x26 (i.e., 26
rows high) while the second terminal will be 57x(LINES-26) (i.e., * means fill
to whatever is leftover). These terminals will be numbered 1 and 2, respectively.
Another example:
$ ./frogcomposband -mgcu -uCrusher -- -bottom -bottom *x10
This adds a bottom strip 10 rows high, and this strip will contain a single
additional terminal window (numbered as Term-1) that will be as wide as the
screen allows (i.e, Term-1 will be COLSx10).
Finally, you can combine the -right and -bottom commands, in either order.
For example:
$ ./frogcomposband -mgcu -uCrusher -- -right 57x26,* -bottom *x10
Here, Term-1 and Term-2 are on the right strip, sized as 57x26 and 57x(LINES-26),
while Term-3 is on the bottom strip, sized (COLS-57)x10. Term-0, the Main Terminal,
is, of course, located in the top left and sized as (COLS-57)x(LINES-10). The
map terminal will always use as much space as possible.
Finally, the order of the -right and -bottom command is significant, as it affects
both the child terminal numbering and also resolves the conflict over the overlap
region in the bottom-right corner of the screen.
For example, the meaning of the following should now be clear:
$ ./frogcomposband -mgcu -uCrusher -- -bottom *x10 -right 57x26,*
You cannot specify more than 7 child terminals.
--- Windows
Download the binary archive for Windows. Unzip it to any location that you
will have full permissions and launch frogcomposband to play.
To compile the source code in MinGW:
$ ./autogen.sh
$ ./configure --enable-win
$ make
MinGW sometimes randomly chokes on one of these steps, in which case you
will need to redo that step.
---------- Basics ------------
The in-game documentation has been updated for FrogComposband 7.1.liquorice.
Press '?' to activate the help system, then select your favorite topic; e.g.
press 'a' twice for General Information; press 'a' followed by 'b' for an
introduction to the help files and how to best read them [yes, this is that
kind of manual!]; press 'a' followed by 'j' for the Newbie Guide. If you
get lost in the depths of the help system, press '!' to return to the
help's main page.
Helpfiles are also available as HTML files for viewing outside the game
in your favorite browser; for example, the General Information page is at
lib/help/html/general.html and the Newbie Guide at lib/help/html/tang.html.
If you are still stuck, you can usually find friendly people at angband.live
who will try to help you out.
--------- Commands -----------
Again, please refer to the in-game help; press '?' for help and then 'c'
for Commands. Choose the section that interests you ("Command Descriptions"
is a separate, lengthy file that explains all commands in detail).
Or open lib/help/html/command.html or lib/help/html/commdesc.html in your browser.
--- Most of this file inherited from PosChengband, updated for FrogComposband 7.1.liquorice.