igramscii.1 - gramscii - A simple editor for ASCII box-and-arrow charts Err bitreich.org 70 1Log /scm/gramscii/log.gph bitreich.org 70 1Files /scm/gramscii/files.gph bitreich.org 70 1Refs /scm/gramscii/refs.gph bitreich.org 70 1Tags /scm/gramscii/tag bitreich.org 70 1README /scm/gramscii/file/README.md.gph bitreich.org 70 1LICENSE /scm/gramscii/file/COPYING.gph bitreich.org 70 i--- Err bitreich.org 70 igramscii.1 (16676B) Err bitreich.org 70 i--- Err bitreich.org 70 i 1 .TH GRAMSCII 1 "28/09/2019" "" "" Err bitreich.org 70 i 2 .SH NAME Err bitreich.org 70 i 3 gramscii \- simple editor for ASCII box diagrams Err bitreich.org 70 i 4 .SH SYNOPSIS Err bitreich.org 70 i 5 .PP Err bitreich.org 70 i 6 gramscii Err bitreich.org 70 i 7 .RI [-s] Err bitreich.org 70 i 8 .RI [-h] Err bitreich.org 70 i 9 .RI [file ...] Err bitreich.org 70 i 10 .PP Err bitreich.org 70 i 11 .SH DESCRIPTION Err bitreich.org 70 i 12 .PP Err bitreich.org 70 i 13 gramscii is a simple interactive editor to create ASCII box-and-arrows Err bitreich.org 70 i 14 diagrams. It uses vi-like keybindings for drawing and editing boxes Err bitreich.org 70 i 15 (rectangles, palallelograms, trapezia, triangles), arrows, and text. Err bitreich.org 70 i 16 .PP Err bitreich.org 70 i 17 .SH OPTIONS Err bitreich.org 70 i 18 .TP 5m Err bitreich.org 70 i 19 .BI -s Err bitreich.org 70 i 20 Start gramscii in script-mode. In this mode the screen is set to 25 rows Err bitreich.org 70 i 21 by 80 columns, no status bar is present, drawings and cursor movements Err bitreich.org 70 i 22 are not shown, and the state of the screen is dumped to stdout when the Err bitreich.org 70 i 23 program ends. With this flag, gramscii can be used in a pipeline, Err bitreich.org 70 i 24 getting commands from stdin (or from a file) and making its output Err bitreich.org 70 i 25 available for further processing. Err bitreich.org 70 i 26 .TP Err bitreich.org 70 i 27 .BI -h Err bitreich.org 70 i 28 Print short usage unstructions and exit. Err bitreich.org 70 i 29 .PP Err bitreich.org 70 i 30 If one or more files are provided after the last option, gramscii will Err bitreich.org 70 i 31 consider them command files and will read them one after the other Err bitreich.org 70 i 32 (i.e., as if the characters in the file were typed while gramscii was Err bitreich.org 70 i 33 running), before accepting commands from stdin. This allows to use Err bitreich.org 70 i 34 gramscii scripts. For instance, if you start gramscii as: Err bitreich.org 70 i 35 .EX Err bitreich.org 70 i 36 Err bitreich.org 70 i 37 gramscii file.txt Err bitreich.org 70 i 38 Err bitreich.org 70 i 39 .EE Err bitreich.org 70 i 40 and "file.txt" contains the lines: Err bitreich.org 70 i 41 .EX Err bitreich.org 70 i 42 Err bitreich.org 70 i 43 gg10lbLLJJb Err bitreich.org 70 i 44 gg10l15jbLLJJ Err bitreich.org 70 i 45 Err bitreich.org 70 i 46 .EE Err bitreich.org 70 i 47 then gramscii will show two boxes and then will start accepting Err bitreich.org 70 i 48 commands as usual. Err bitreich.org 70 i 49 .SH COMMANDS Err bitreich.org 70 i 50 gramscii is a visual modal editor. Commands are associated to Err bitreich.org 70 i 51 keystrokes, and keystrokes have different meaning in different modes. Err bitreich.org 70 i 52 The default mode is Err bitreich.org 70 i 53 .B move Err bitreich.org 70 i 54 mode, which allows the user to move the cursor around the screen. Err bitreich.org 70 i 55 Exiting from any other mode (either via pressing Err bitreich.org 70 i 56 .B [ESC] Err bitreich.org 70 i 57 or by toggling the current mode) automatically puts gramscii in Err bitreich.org 70 i 58 .B move Err bitreich.org 70 i 59 mode. There are four classes of commands in gramscii, namely Err bitreich.org 70 i 60 .B GENERAL, Err bitreich.org 70 i 61 .B MOVEMENTS, Err bitreich.org 70 i 62 .B MODES, Err bitreich.org 70 i 63 and Err bitreich.org 70 i 64 .B STYLES. Err bitreich.org 70 i 65 Each of those classes of commands is described in a separate subsection Err bitreich.org 70 i 66 below. Err bitreich.org 70 i 67 .SS GENERAL Err bitreich.org 70 i 68 General commands available in Err bitreich.org 70 i 69 .B move Err bitreich.org 70 i 70 mode: Err bitreich.org 70 i 71 .TP 5m Err bitreich.org 70 i 72 .BI C Err bitreich.org 70 i 73 Crop chart to the largest non-blank region. The first line and the first Err bitreich.org 70 i 74 column of the cropped chart will contain the first non-blank line and Err bitreich.org 70 i 75 the first non-blank column of the original chart, respectively. Err bitreich.org 70 i 76 .TP 5m Err bitreich.org 70 i 77 .BI e Err bitreich.org 70 i 78 Load (edit) an existing file from disk. gramscii asks the user if they Err bitreich.org 70 i 79 want to save the current screen (only if the screen has been modified Err bitreich.org 70 i 80 since the Err bitreich.org 70 i 81 last Err bitreich.org 70 i 82 .BI w Err bitreich.org 70 i 83 command). Err bitreich.org 70 i 84 .TP 5m Err bitreich.org 70 i 85 .BI E Err bitreich.org 70 i 86 Load (edit) an existing file from disk, discarding any change to the Err bitreich.org 70 i 87 current screen. Err bitreich.org 70 i 88 .TP 5m Err bitreich.org 70 i 89 .BI M a Err bitreich.org 70 i 90 Mark (label) the current cursor position as 'a'. The label 'a' must be Err bitreich.org 70 i 91 one of the 26 ASCII alphabetic characters. The cursor can be moved to a Err bitreich.org 70 i 92 previously marked position using the global positioning command Err bitreich.org 70 i 93 .B g Err bitreich.org 70 i 94 (see below). Position marks are case-insensitive, meaning that both Err bitreich.org 70 i 95 .I 'c' Err bitreich.org 70 i 96 and Err bitreich.org 70 i 97 .I 'C' Err bitreich.org 70 i 98 indicate the same mark. Err bitreich.org 70 i 99 .TP 5m Err bitreich.org 70 i 100 .BI N Err bitreich.org 70 i 101 Start a new empty screen. If the current screen has been modified since Err bitreich.org 70 i 102 the last Err bitreich.org 70 i 103 .BI w Err bitreich.org 70 i 104 command, gramscii will ask the user if they want to save the current Err bitreich.org 70 i 105 screen before creating a new one. Err bitreich.org 70 i 106 .TP 5m Err bitreich.org 70 i 107 .BI p Err bitreich.org 70 i 108 Paste the content of the yank buffer at the cursor position. The yank Err bitreich.org 70 i 109 buffer contains the rectangle yanked/cut in Err bitreich.org 70 i 110 .B visual Err bitreich.org 70 i 111 mode. Err bitreich.org 70 i 112 .TP 5m Err bitreich.org 70 i 113 .BI q Err bitreich.org 70 i 114 Quit gramscii, and prompt for a filename if the current screen contains Err bitreich.org 70 i 115 unsaved changes. Err bitreich.org 70 i 116 .TP 5m Err bitreich.org 70 i 117 .BI Q Err bitreich.org 70 i 118 Quit gramscii and discard any change to the current screen. Err bitreich.org 70 i 119 .TP 5m Err bitreich.org 70 i 120 .BI r Err bitreich.org 70 i 121 Read a file at the current cursor position. gramscii will prompt for the Err bitreich.org 70 i 122 name of the file to read. If the first non-blank character of the name Err bitreich.org 70 i 123 given is a '!', gramscii will run the command specified after '!' in a Err bitreich.org 70 i 124 shell, and will import its standard output. Err bitreich.org 70 i 125 .TP 5m Err bitreich.org 70 i 126 .BI R Err bitreich.org 70 i 127 Redraw the screen Err bitreich.org 70 i 128 .TP 5m Err bitreich.org 70 i 129 .BI u Err bitreich.org 70 i 130 Undo the last change. gramscii supports an undo history of indefinite Err bitreich.org 70 i 131 length. The command Err bitreich.org 70 i 132 .BI u Err bitreich.org 70 i 133 gets the last change from the history, and moves the history pointer Err bitreich.org 70 i 134 back by one change. See the related command Err bitreich.org 70 i 135 .BI U Err bitreich.org 70 i 136 below. Err bitreich.org 70 i 137 .TP 5m Err bitreich.org 70 i 138 .BI U Err bitreich.org 70 i 139 Redo, i.e., cancel a previous Err bitreich.org 70 i 140 .BI u Err bitreich.org 70 i 141 command. gramscii supports an undo history of indefinite length. The Err bitreich.org 70 i 142 command Err bitreich.org 70 i 143 .BI U Err bitreich.org 70 i 144 moves to the following change, if possible. For instance, the sequence Err bitreich.org 70 i 145 .BI uuU Err bitreich.org 70 i 146 will go back two changes, and then forward one, effectively resetting Err bitreich.org 70 i 147 the state of the screen to what it was before the last change occurred. Err bitreich.org 70 i 148 .TP 5m Err bitreich.org 70 i 149 .BI w Err bitreich.org 70 i 150 Write the current screen to a file. If the current screen has already Err bitreich.org 70 i 151 been associated to a file, use the same filename. Otherwise, the user is Err bitreich.org 70 i 152 prompted for a filename to save the screen to. Err bitreich.org 70 i 153 .TP 5m Err bitreich.org 70 i 154 .BI W Err bitreich.org 70 i 155 Write the current screen to a new file. This commands acts like Err bitreich.org 70 i 156 .B w Err bitreich.org 70 i 157 but always prompts for a file name to use. Err bitreich.org 70 i 158 .TP 5m Err bitreich.org 70 i 159 .BI # Err bitreich.org 70 i 160 Start a comment. Discard all the characters until a newline is Err bitreich.org 70 i 161 entered. Useful to include comments in scripts. Err bitreich.org 70 i 162 Err bitreich.org 70 i 163 .SS MOVEMENTS Err bitreich.org 70 i 164 The following movement commands are available in any mode where cursor Err bitreich.org 70 i 165 movements are meaningful, currently only Err bitreich.org 70 i 166 .B move, box, arrow, parallelogram, trapezium, erase, Err bitreich.org 70 i 167 and Err bitreich.org 70 i 168 .B visual Err bitreich.org 70 i 169 (see Err bitreich.org 70 i 170 .B MODES Err bitreich.org 70 i 171 below). Err bitreich.org 70 i 172 .TP 5m Err bitreich.org 70 i 173 .BI h Err bitreich.org 70 i 174 move the cursor to the left by 1 column Err bitreich.org 70 i 175 .TP 5m Err bitreich.org 70 i 176 .BI j Err bitreich.org 70 i 177 move the cursor down by 1 row Err bitreich.org 70 i 178 .TP 5m Err bitreich.org 70 i 179 .BI k Err bitreich.org 70 i 180 move the cursor up by 1 row Err bitreich.org 70 i 181 .TP 5m Err bitreich.org 70 i 182 .BI l Err bitreich.org 70 i 183 move the cursor right by 1 column Err bitreich.org 70 i 184 .PP Err bitreich.org 70 i 185 gramscii accepts also the uppercase commands Err bitreich.org 70 i 186 .B H, J, K, L, Err bitreich.org 70 i 187 which will move in the corresponding direction by a LONG_STEP number of Err bitreich.org 70 i 188 units at a time (defaults to 5, change LONG_STEP in config.h as you Err bitreich.org 70 i 189 wish). Err bitreich.org 70 i 190 .TP 5m Err bitreich.org 70 i 191 .BI g Err bitreich.org 70 i 192 Initiate a global positioning command (go). These are two- or Err bitreich.org 70 i 193 three-letter commands starting with a Err bitreich.org 70 i 194 .BI g Err bitreich.org 70 i 195 and followed by a direction command, or by a character that indicates a Err bitreich.org 70 i 196 global position, or by a valid position mark previously defined with Err bitreich.org 70 i 197 .B M Err bitreich.org 70 i 198 and preceded by a single quote. In particular: Err bitreich.org 70 i 199 .RS Err bitreich.org 70 i 200 .TP 5m Err bitreich.org 70 i 201 .BI h Err bitreich.org 70 i 202 move the cursor to the first column of the current row. Err bitreich.org 70 i 203 .TP 5m Err bitreich.org 70 i 204 .BI l Err bitreich.org 70 i 205 move the cursos to the last column of the current row. Err bitreich.org 70 i 206 .TP 5m Err bitreich.org 70 i 207 .BI j Err bitreich.org 70 i 208 move the cursor to the last row of the current column. Err bitreich.org 70 i 209 .TP 5m Err bitreich.org 70 i 210 .BI k Err bitreich.org 70 i 211 move the cursos to the first row of the current column. Err bitreich.org 70 i 212 .TP 5m Err bitreich.org 70 i 213 .BI g Err bitreich.org 70 i 214 move the cursor to the top-left corner of the screen Err bitreich.org 70 i 215 .TP 5m Err bitreich.org 70 i 216 .BI G Err bitreich.org 70 i 217 move the cursor to the bottom-right corner of the screen Err bitreich.org 70 i 218 .TP 5m Err bitreich.org 70 i 219 .BI m Err bitreich.org 70 i 220 move the cursor to the middle of the screen. Err bitreich.org 70 i 221 .TP 5m Err bitreich.org 70 i 222 .BI 'a Err bitreich.org 70 i 223 (single-quote followed by a character) move the cursor to the position Err bitreich.org 70 i 224 previously marked (labelled) with character Err bitreich.org 70 i 225 .BI 'a' Err bitreich.org 70 i 226 by the command Err bitreich.org 70 i 227 .B M Err bitreich.org 70 i 228 (mark). The character 'a' must be one of the 26 ASCII alphabetic Err bitreich.org 70 i 229 characters. Notice that position marks are case-insensitive, so the two Err bitreich.org 70 i 230 commands: Err bitreich.org 70 i 231 .B g'b Err bitreich.org 70 i 232 and Err bitreich.org 70 i 233 .B g'B Err bitreich.org 70 i 234 move the cursor to the position mark associated to the letter 'b', if it Err bitreich.org 70 i 235 exists. Err bitreich.org 70 i 236 .PP Err bitreich.org 70 i 237 If you want to move the cursor to the first row of the current Err bitreich.org 70 i 238 column, you could use the two-letter command Err bitreich.org 70 i 239 .B gk Err bitreich.org 70 i 240 (which can be read as "go-up"). Similarly, the command Err bitreich.org 70 i 241 .B gh Err bitreich.org 70 i 242 (to be read "go-left"), will move the cursor to the first column of the Err bitreich.org 70 i 243 current line. Notice that the command Err bitreich.org 70 i 244 .B gg Err bitreich.org 70 i 245 is effectively equivalent to the sequence Err bitreich.org 70 i 246 .B ghgk Err bitreich.org 70 i 247 (or Err bitreich.org 70 i 248 .B gkgh Err bitreich.org 70 i 249 ) while the command Err bitreich.org 70 i 250 .B gG Err bitreich.org 70 i 251 is equivalent to Err bitreich.org 70 i 252 .B glgj Err bitreich.org 70 i 253 (or Err bitreich.org 70 i 254 .B gjgl Err bitreich.org 70 i 255 ). Err bitreich.org 70 i 256 .PP Err bitreich.org 70 i 257 Global positioning commands are available in Err bitreich.org 70 i 258 .B box, arrow, visual, parallelogram, trapezium, Err bitreich.org 70 i 259 and Err bitreich.org 70 i 260 .B erase Err bitreich.org 70 i 261 mode. Notice that Err bitreich.org 70 i 262 .B gg, gG, gm Err bitreich.org 70 i 263 and moves to position marks like Err bitreich.org 70 i 264 .B g'b, Err bitreich.org 70 i 265 are not available in Err bitreich.org 70 i 266 .B arrow Err bitreich.org 70 i 267 mode. Err bitreich.org 70 i 268 .PP Err bitreich.org 70 i 269 Typing Err bitreich.org 70 i 270 .BI g Err bitreich.org 70 i 271 followed by any character that is not listed above has no effect on the Err bitreich.org 70 i 272 cursor. Err bitreich.org 70 i 273 .SS MULTIPLIERS Err bitreich.org 70 i 274 Simple cursor movement commands (hjklHJKL) can be preceded by a number Err bitreich.org 70 i 275 that acts as a multiplier. For instance, the command: Err bitreich.org 70 i 276 .PP Err bitreich.org 70 i 277 .RS Err bitreich.org 70 i 278 14h Err bitreich.org 70 i 279 .PP Err bitreich.org 70 i 280 .RE Err bitreich.org 70 i 281 will move the cursor by 14 steps to the left. Similarily, the command: Err bitreich.org 70 i 282 .PP Err bitreich.org 70 i 283 .RS Err bitreich.org 70 i 284 7J Err bitreich.org 70 i 285 .PP Err bitreich.org 70 i 286 .RE Err bitreich.org 70 i 287 will move the cursor by 7 LONG_STEPs rows down (with the default Err bitreich.org 70 i 288 LONG_STEP equal to 5, this will correspond to 35 rows down). Err bitreich.org 70 i 289 .PP Err bitreich.org 70 i 290 Multipliers can be used whenever a movement command is legal, i.e. in Err bitreich.org 70 i 291 move, box, arrox, parallelogram, trapezium, visual, and erase mode. So Err bitreich.org 70 i 292 for instance the sequence: Err bitreich.org 70 i 293 .RS Err bitreich.org 70 i 294 ggb13l18jb Err bitreich.org 70 i 295 .PP Err bitreich.org 70 i 296 .RE Err bitreich.org 70 i 297 will draw a 18x13 box whose top-left corner coincides with the top-left Err bitreich.org 70 i 298 corner of the screen. Err bitreich.org 70 i 299 .PP Err bitreich.org 70 i 300 Multipliers are ignored by global positioning commands (i.e., those Err bitreich.org 70 i 301 starting with Err bitreich.org 70 i 302 .B g) Err bitreich.org 70 i 303 .SS MODES Err bitreich.org 70 i 304 The currently supported modes are: Err bitreich.org 70 i 305 .B move, Err bitreich.org 70 i 306 .B box, Err bitreich.org 70 i 307 .B parallelogram, Err bitreich.org 70 i 308 .B trapezium, Err bitreich.org 70 i 309 .B arrow, Err bitreich.org 70 i 310 .B erase, Err bitreich.org 70 i 311 .B text, Err bitreich.org 70 i 312 and Err bitreich.org 70 i 313 .B visual. Err bitreich.org 70 i 314 The current mode is shown in the Err bitreich.org 70 i 315 status bar (see Err bitreich.org 70 i 316 .B STATUS BAR Err bitreich.org 70 i 317 below for more details). gramscii starts in Err bitreich.org 70 i 318 .B move Err bitreich.org 70 i 319 mode (mov). The following commands are used to change mode: Err bitreich.org 70 i 320 .TP 7m Err bitreich.org 70 i 321 .BI [ESC] Err bitreich.org 70 i 322 Return to Err bitreich.org 70 i 323 .B move Err bitreich.org 70 i 324 mode. Err bitreich.org 70 i 325 .TP 7m Err bitreich.org 70 i 326 .BI b Err bitreich.org 70 i 327 Toggle Err bitreich.org 70 i 328 .B box Err bitreich.org 70 i 329 mode. All movements in Err bitreich.org 70 i 330 .B box Err bitreich.org 70 i 331 mode identify a rectangular box (see Err bitreich.org 70 i 332 .B Err bitreich.org 70 i 333 MOVEMENTS Err bitreich.org 70 i 334 above). When you are happy with the shape of your box, just press Err bitreich.org 70 i 335 .B b Err bitreich.org 70 i 336 again or Err bitreich.org 70 i 337 .B [ENTER] Err bitreich.org 70 i 338 to draw the current box permanently and return to Err bitreich.org 70 i 339 .B move Err bitreich.org 70 i 340 mode. The horizontal and vertical borders of the box are drawn using Err bitreich.org 70 i 341 the current Err bitreich.org 70 i 342 .B HL Err bitreich.org 70 i 343 style and the current Err bitreich.org 70 i 344 .B VL Err bitreich.org 70 i 345 style, respectively. The corners are drawn using the current Err bitreich.org 70 i 346 .B CN Err bitreich.org 70 i 347 style, See Err bitreich.org 70 i 348 .B STYLES Err bitreich.org 70 i 349 below for more information. If you press Err bitreich.org 70 i 350 .B [ESC] Err bitreich.org 70 i 351 while in box mode, gramscii will return to Err bitreich.org 70 i 352 .B move Err bitreich.org 70 i 353 mode discarding the current box. Err bitreich.org 70 i 354 .TP 7m Err bitreich.org 70 i 355 .BI z Err bitreich.org 70 i 356 Toggle Err bitreich.org 70 i 357 .B parallelogram Err bitreich.org 70 i 358 mode. All moves in Err bitreich.org 70 i 359 .B parallelogram Err bitreich.org 70 i 360 mode identify the bounding box of a parallelogram (see Err bitreich.org 70 i 361 .B MOVEMENTS Err bitreich.org 70 i 362 above). By default the parallelogram leans to the right. Pressing Err bitreich.org 70 i 363 .B Z Err bitreich.org 70 i 364 while in parallelogram mode toggles the direction towards which the Err bitreich.org 70 i 365 parallelogram leans. Press Err bitreich.org 70 i 366 .BI z Err bitreich.org 70 i 367 again or Err bitreich.org 70 i 368 .B [ENTER] Err bitreich.org 70 i 369 to draw the current parallelogram and return to Err bitreich.org 70 i 370 .B move Err bitreich.org 70 i 371 mode. If you press Err bitreich.org 70 i 372 .B [ESC] Err bitreich.org 70 i 373 while in parallelogram mode, the current parallelogram will be discarded Err bitreich.org 70 i 374 and gramscii will return to Err bitreich.org 70 i 375 .B move Err bitreich.org 70 i 376 mode. Err bitreich.org 70 i 377 .TP 7m Err bitreich.org 70 i 378 .BI t Err bitreich.org 70 i 379 Toggle Err bitreich.org 70 i 380 .B trapezium Err bitreich.org 70 i 381 mode. All moves in Err bitreich.org 70 i 382 .B trapezium Err bitreich.org 70 i 383 mode identify the bounding box of a trapezium (see Err bitreich.org 70 i 384 .B MOVEMENTS Err bitreich.org 70 i 385 above). A trapezium with a short horizontal side of length zero is a Err bitreich.org 70 i 386 triangle, and gramscii knows that. By default, the trapezium is Err bitreich.org 70 i 387 isosceles, with the short side up. Err bitreich.org 70 i 388 Pressing Err bitreich.org 70 i 389 .B T Err bitreich.org 70 i 390 while in trapezium mode toggles the type and orientation of the Err bitreich.org 70 i 391 trapezium. Press Err bitreich.org 70 i 392 .BI t Err bitreich.org 70 i 393 again or Err bitreich.org 70 i 394 .B [ENTER] Err bitreich.org 70 i 395 to draw the current trapezium and return to Err bitreich.org 70 i 396 .B move Err bitreich.org 70 i 397 mode. If you press Err bitreich.org 70 i 398 .B [ESC] Err bitreich.org 70 i 399 while in trapezium mode, the current trapezium will be discarded Err bitreich.org 70 i 400 and gramscii will return to Err bitreich.org 70 i 401 .B move Err bitreich.org 70 i 402 mode. Err bitreich.org 70 i 403 .TP 7m Err bitreich.org 70 i 404 .BI a Err bitreich.org 70 i 405 Toggle Err bitreich.org 70 i 406 .B arrow Err bitreich.org 70 i 407 mode. All movements in Err bitreich.org 70 i 408 .B arrow Err bitreich.org 70 i 409 mode change the position of the end-point of the current arrow. Press Err bitreich.org 70 i 410 .BI a Err bitreich.org 70 i 411 again or Err bitreich.org 70 i 412 .B [ENTER] Err bitreich.org 70 i 413 to draw the current arrow and return to Err bitreich.org 70 i 414 .B move Err bitreich.org 70 i 415 mode. If you press Err bitreich.org 70 i 416 .B [ESC] Err bitreich.org 70 i 417 while in arrow mode, gramscii will return to Err bitreich.org 70 i 418 .B move Err bitreich.org 70 i 419 mode discarding the current arrow. The horizontal and vertical segments Err bitreich.org 70 i 420 of the arrow are drawn using the current Err bitreich.org 70 i 421 .B HL Err bitreich.org 70 i 422 and Err bitreich.org 70 i 423 .B VL Err bitreich.org 70 i 424 line styles. Corners are drawn using the current Err bitreich.org 70 i 425 .B CN Err bitreich.org 70 i 426 style. Similarly, the start and the end point of the arrow are drawn Err bitreich.org 70 i 427 using the current Err bitreich.org 70 i 428 .B SP Err bitreich.org 70 i 429 and Err bitreich.org 70 i 430 .B EP Err bitreich.org 70 i 431 styles. See Err bitreich.org 70 i 432 .B STYLES Err bitreich.org 70 i 433 below for more information. Err bitreich.org 70 i 434 .TP 7m Err bitreich.org 70 i 435 .BI A Err bitreich.org 70 i 436 Exactly as Err bitreich.org 70 i 437 .BI a Err bitreich.org 70 i 438 toggles Err bitreich.org 70 i 439 .B arrow Err bitreich.org 70 i 440 mode, but the end point marker is automatically set according to the Err bitreich.org 70 i 441 direction of the arrow. Err bitreich.org 70 i 442 .TP 7m Err bitreich.org 70 i 443 .BI x Err bitreich.org 70 i 444 Toggle Err bitreich.org 70 i 445 .B erase Err bitreich.org 70 i 446 mode. In erase mode, any character traversed by the cursor is erased, Err bitreich.org 70 i 447 i.e., reset to the default background character (space). If you press Err bitreich.org 70 i 448 .BI [ESC] Err bitreich.org 70 i 449 while in Err bitreich.org 70 i 450 .BI erase Err bitreich.org 70 i 451 mode, the current erase operation is aborted. Press Err bitreich.org 70 i 452 .B x Err bitreich.org 70 i 453 again or Err bitreich.org 70 i 454 .B [ENTER] Err bitreich.org 70 i 455 to make the erase permanent and return to Err bitreich.org 70 i 456 .B move Err bitreich.org 70 i 457 mode. Err bitreich.org 70 i 458 .TP 7m Err bitreich.org 70 i 459 .BI i Err bitreich.org 70 i 460 Enter Err bitreich.org 70 i 461 .B text Err bitreich.org 70 i 462 mode. While in text mode, each character typed is printed on the screen Err bitreich.org 70 i 463 at the corresponding location, and the cursor is advanced by a single Err bitreich.org 70 i 464 position to the right. Movement modes are not allowed while in Err bitreich.org 70 i 465 .B text Err bitreich.org 70 i 466 mode. By pressing Err bitreich.org 70 i 467 .B [ENTER] Err bitreich.org 70 i 468 the cursor is placed on the following row (if possible), at the same Err bitreich.org 70 i 469 column where the cursor was when the command Err bitreich.org 70 i 470 .BI i Err bitreich.org 70 i 471 was typed. Press Err bitreich.org 70 i 472 .B [ESC] Err bitreich.org 70 i 473 to exit Err bitreich.org 70 i 474 .B text Err bitreich.org 70 i 475 mode and return to Err bitreich.org 70 i 476 .B move Err bitreich.org 70 i 477 mode. Err bitreich.org 70 i 478 .TP 7m Err bitreich.org 70 i 479 .BI v Err bitreich.org 70 i 480 Toggle Err bitreich.org 70 i 481 .B visual Err bitreich.org 70 i 482 mode. Visual mode allows to highlight a rectangular region of the Err bitreich.org 70 i 483 screen, and to perform an operation into it. After entering Err bitreich.org 70 i 484 .B visual Err bitreich.org 70 i 485 mode, you can use Err bitreich.org 70 i 486 .B MOVEMENTS Err bitreich.org 70 i 487 commands to highlight a rectangle. Then, you can use one of the Err bitreich.org 70 i 488 following command on the highlighted region: Err bitreich.org 70 i 489 .RS Err bitreich.org 70 i 490 .TP 5m Err bitreich.org 70 i 491 .BI y Err bitreich.org 70 i 492 Yank (copy) the highlighted rectangle to the yank buffer. The content of Err bitreich.org 70 i 493 the yank buffer can be retrieved by using the Err bitreich.org 70 i 494 .B p Err bitreich.org 70 i 495 command while in Err bitreich.org 70 i 496 .B move Err bitreich.org 70 i 497 mode. The yank buffer is overwritten by subsequent yank/cut commands. Err bitreich.org 70 i 498 .TP 5m Err bitreich.org 70 i 499 .BI x Err bitreich.org 70 i 500 Cut region. The content of the highlighted rectangle will be put in the Err bitreich.org 70 i 501 yank buffer and all the characters in the region are set to the default Err bitreich.org 70 i 502 background character (space). The yank buffer is overwritten by Err bitreich.org 70 i 503 subsequent yank/cut commands. Err bitreich.org 70 i 504 .TP 5m Err bitreich.org 70 i 505 .BI f Err bitreich.org 70 i 506 Fill region. gramscii will wait for a character on input and then will Err bitreich.org 70 i 507 fill the highlighted region with that character. Err bitreich.org 70 i 508 .TP 5m Err bitreich.org 70 i 509 .BI C Err bitreich.org 70 i 510 Crop-to-region. Crop the chart to the content of the highlighted region. Err bitreich.org 70 i 511 Everything else in the screen is erased. Err bitreich.org 70 i 512 .TP 5m Err bitreich.org 70 i 513 .BI v Err bitreich.org 70 i 514 leave Err bitreich.org 70 i 515 .B visual Err bitreich.org 70 i 516 mode and return to Err bitreich.org 70 i 517 .B move Err bitreich.org 70 i 518 mode. Err bitreich.org 70 i 519 .TP 5m Err bitreich.org 70 i 520 .BI [ENTER] Err bitreich.org 70 i 521 same as Err bitreich.org 70 i 522 .BI v, Err bitreich.org 70 i 523 i.e., leave Err bitreich.org 70 i 524 .B visual Err bitreich.org 70 i 525 mode and return to Err bitreich.org 70 i 526 .B move Err bitreich.org 70 i 527 mode. Err bitreich.org 70 i 528 .TP 5m Err bitreich.org 70 i 529 .BI [ESC] Err bitreich.org 70 i 530 same as Err bitreich.org 70 i 531 .BI v, Err bitreich.org 70 i 532 i.e., leave Err bitreich.org 70 i 533 .B visual Err bitreich.org 70 i 534 mode and return to Err bitreich.org 70 i 535 .B move Err bitreich.org 70 i 536 mode. Err bitreich.org 70 i 537 .RE Err bitreich.org 70 i 538 Err bitreich.org 70 i 539 .SS STYLES Err bitreich.org 70 i 540 The style of lines, corners and markers can be changed at any time while Err bitreich.org 70 i 541 in Err bitreich.org 70 i 542 .B move, Err bitreich.org 70 i 543 .B box, Err bitreich.org 70 i 544 and Err bitreich.org 70 i 545 .B arrow Err bitreich.org 70 i 546 mode. Some caveats apply to parallelogram and trapezium mode though (see Err bitreich.org 70 i 547 BUGS). The following style commands are available: Err bitreich.org 70 i 548 .TP 5m Err bitreich.org 70 i 549 .B . Err bitreich.org 70 i 550 (dot) Reset all styles to their default values. Err bitreich.org 70 i 551 .TP 5m Err bitreich.org 70 i 552 .BI - Err bitreich.org 70 i 553 (dash) Change the style used for horizontal lines. Indicated in the Err bitreich.org 70 i 554 .B STATUS BAR Err bitreich.org 70 i 555 as "HL". Default is '-'. Err bitreich.org 70 i 556 .TP 5m Err bitreich.org 70 i 557 .BI | Err bitreich.org 70 i 558 (pipe) Change the style used for vertical lines. Indicated in the Err bitreich.org 70 i 559 .B STATUS BAR Err bitreich.org 70 i 560 as "VL". Default is '|'. Err bitreich.org 70 i 561 .TP 5m Err bitreich.org 70 i 562 .BI + Err bitreich.org 70 i 563 (plus) Change the style used for corners (i.e., intersections between Err bitreich.org 70 i 564 horizontal and vertical lines). Indicated in the Err bitreich.org 70 i 565 .B STATUS BAR Err bitreich.org 70 i 566 as "CN". Default is '+'. Err bitreich.org 70 i 567 .TP 5m Err bitreich.org 70 i 568 .BI < Err bitreich.org 70 i 569 (less-than) Change the style used for arrow start points. Indicated in Err bitreich.org 70 i 570 the Err bitreich.org 70 i 571 .B STATUS BAR Err bitreich.org 70 i 572 as "SP". Default is '+'. Err bitreich.org 70 i 573 .TP 5m Err bitreich.org 70 i 574 .BI > Err bitreich.org 70 i 575 (greater-than) Change the style used for arrow end points. Indicated in Err bitreich.org 70 i 576 the Err bitreich.org 70 i 577 .B STATUS BAR Err bitreich.org 70 i 578 as "EP". Default is '>'. Err bitreich.org 70 i 579 .PP Err bitreich.org 70 i 580 If a style command is issued in Err bitreich.org 70 i 581 .B box Err bitreich.org 70 i 582 or Err bitreich.org 70 i 583 .B arrow Err bitreich.org 70 i 584 mode, the new style will be applied to the box/arrow that is currently being Err bitreich.org 70 i 585 drawn, and will remain active until the next style command is used. Err bitreich.org 70 i 586 Err bitreich.org 70 i 587 .SH STATUS BAR Err bitreich.org 70 i 588 Unless script-mode has been requested using option Err bitreich.org 70 i 589 .RI -s, Err bitreich.org 70 i 590 gramscii shows a status bar on the last line of the screen. The bar Err bitreich.org 70 i 591 reports information about the current screen, and in particular: Err bitreich.org 70 i 592 .RS Err bitreich.org 70 i 593 .TP 10m Err bitreich.org 70 i 594 x:XXX Err bitreich.org 70 i 595 Current column position of the cursor (the leftmost column is 0). Err bitreich.org 70 i 596 .TP 10m Err bitreich.org 70 i 597 y:YYY Err bitreich.org 70 i 598 Current row position of the cursor (top is 0). Err bitreich.org 70 i 599 .TP 10m Err bitreich.org 70 i 600 MODE: xxx Err bitreich.org 70 i 601 Current mode. It is one of Err bitreich.org 70 i 602 .B mov Err bitreich.org 70 i 603 (move), Err bitreich.org 70 i 604 .B box Err bitreich.org 70 i 605 (box), Err bitreich.org 70 i 606 .B par Err bitreich.org 70 i 607 (parallelogram), Err bitreich.org 70 i 608 .B trp Err bitreich.org 70 i 609 (trapezium), Err bitreich.org 70 i 610 .B arr Err bitreich.org 70 i 611 (arrow), Err bitreich.org 70 i 612 .B txt Err bitreich.org 70 i 613 (text), Err bitreich.org 70 i 614 .B del Err bitreich.org 70 i 615 (erase), or Err bitreich.org 70 i 616 .B vis Err bitreich.org 70 i 617 (visual). Err bitreich.org 70 i 618 .TP 10m Err bitreich.org 70 i 619 HL:x Err bitreich.org 70 i 620 Style used for horizontal lines. Err bitreich.org 70 i 621 .TP 10m Err bitreich.org 70 i 622 VL:x Err bitreich.org 70 i 623 Style used for vertical lines. Err bitreich.org 70 i 624 .TP 10m Err bitreich.org 70 i 625 CN:x Err bitreich.org 70 i 626 Style used for corners. Err bitreich.org 70 i 627 .TP 10m Err bitreich.org 70 i 628 SP:x Err bitreich.org 70 i 629 Style used for arrow starting points. Err bitreich.org 70 i 630 .TP 10m Err bitreich.org 70 i 631 EP:x Err bitreich.org 70 i 632 Style used for arrow end points. Err bitreich.org 70 i 633 .RE Err bitreich.org 70 i 634 .PP Err bitreich.org 70 i 635 The rightmost side of the status bar also reports the name of the file Err bitreich.org 70 i 636 associated to the current screen: Err bitreich.org 70 i 637 .RS Err bitreich.org 70 i 638 .TP 12m Err bitreich.org 70 i 639 [] Err bitreich.org 70 i 640 No file is associated to the current screen, and no changes have been Err bitreich.org 70 i 641 made. The command Err bitreich.org 70 i 642 .B w Err bitreich.org 70 i 643 would prompt the user for the name of the file to save the screen to. Err bitreich.org 70 i 644 .TP 12m Err bitreich.org 70 i 645 ** Err bitreich.org 70 i 646 The screen has been changed, but there is no file associated to it. The Err bitreich.org 70 i 647 command Err bitreich.org 70 i 648 .B w Err bitreich.org 70 i 649 would prompt the user for the name of the file to save the screen to. Err bitreich.org 70 i 650 .TP 12m Err bitreich.org 70 i 651 [filename] Err bitreich.org 70 i 652 The screen corresponds to the file "filename" and it has not been Err bitreich.org 70 i 653 modified since the last write on disk. The command Err bitreich.org 70 i 654 .B w Err bitreich.org 70 i 655 would automatically save the screen into "filename". Err bitreich.org 70 i 656 .TP 12m Err bitreich.org 70 i 657 *filename* Err bitreich.org 70 i 658 The screen is associated to the file "filename", but the current buffer Err bitreich.org 70 i 659 includes some changes that have not been saved to the disk. The command Err bitreich.org 70 i 660 .B w Err bitreich.org 70 i 661 would automatically save the screen into "filename". Err bitreich.org 70 i 662 .RE Err bitreich.org 70 i 663 .SH BUGS Err bitreich.org 70 i 664 gramscii currently manages only a fixed screen of the same size of the Err bitreich.org 70 i 665 screen where it starts from. This will be changed in a future release to Err bitreich.org 70 i 666 support scrolling and "virtual" screens of any (reasonable) size. Err bitreich.org 70 i 667 .PP Err bitreich.org 70 i 668 It is not currently possible to change the style of the oblique sides of Err bitreich.org 70 i 669 a parallelogram or of a trapezium. Err bitreich.org 70 i 670 .PP Err bitreich.org 70 i 671 The trapezium routine does not handle well the case of trapezia whose Err bitreich.org 70 i 672 height would yield a negative length for the small horizontal side. Err bitreich.org 70 i 673 Nevertheless, an exceptionally creative user might consider this a Err bitreich.org 70 i 674 feature, rather than a bug. Err bitreich.org 70 i 675 .SH AUTHORS Err bitreich.org 70 i 676 gramscii is written and maintained by Vincenzo "KatolaZ" Nicosia Err bitreich.org 70 i 677 . You can use, copy, modify, and redistribute Err bitreich.org 70 i 678 gramscii under the terms of the GNU General Public License, version 3 of Err bitreich.org 70 i 679 the License or, at your option, any later version. Err bitreich.org 70 .