-
Notifications
You must be signed in to change notification settings - Fork 181
/
mintty.1.html
1365 lines (1074 loc) · 48.3 KB
/
mintty.1.html
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
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!-- Creator : groff version 1.22.3 -->
<!-- CreationDate: Thu Jul 23 08:29:56 2015 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; vertical-align: top }
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
h1 { text-align: center }
</style>
<title>mintty</title>
</head>
<body>
<h1 align="center">mintty</h1>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#INVOCATION">INVOCATION</a><br>
<a href="#OPTIONS">OPTIONS</a><br>
<a href="#USAGE">USAGE</a><br>
<a href="#CONFIGURATION">CONFIGURATION</a><br>
<a href="#LIMITATIONS">LIMITATIONS</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<a href="#LICENSE">LICENSE</a><br>
<a href="#CONTACT">CONTACT</a><br>
<hr>
<h2>NAME
<a name="NAME"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">mintty - Cygwin
terminal emulator</p>
<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>mintty</b>
[<i>OPTION</i>]... [ <b>-</b> | <i>PROGRAM</i>
[<i>ARG</i>]... ]</p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>Mintty</b>
is a terminal emulator for Cygwin with a native Windows user
interface and minimalist design. Its terminal emulation is
largely compatible with <b>xterm</b>, but it does not
require an X server.</p>
<h2>INVOCATION
<a name="INVOCATION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">If a program
name is supplied on the command line, this is executed with
any additional arguments given. Otherwise, mintty looks for
a shell to execute in the <i>SHELL</i> environment variable.
If that is not set, it reads the user’s default shell
setting from <i>/etc/passwd</i>. As a last resort, it falls
back to <i>/bin/sh</i>. If a single dash is specified
instead of a program name, the shell is invoked as a login
shell.</p>
<h2>OPTIONS
<a name="OPTIONS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The standard
GNU option formats are accepted, with single dashes
introducing short options and double dashes introducing long
options. <b><br>
-c</b>, <b>--config</b> <i>FILENAME</i></p>
<p style="margin-left:22%;">Read settings from the
specified configuration file, in addition to
<i>/etc/minttyrc</i> and <i>~/.minttyrc</i>.</p>
<p style="margin-left:11%;"><b>-e</b>, <b>--exec</b>
<i>PROGRAM</i> [<i>ARG</i> ...]</p>
<p style="margin-left:22%;">Execute the specified program
in the terminal session and pass on any additional
arguments.</p>
<p style="margin-left:22%; margin-top: 1em">This option is
present for compatibility with other terminal emulators
only. It can be omitted, in which case the first non-option
argument, if any, is taken as the name of the program to
execute.</p>
<p style="margin-left:11%;"><b>-h</b>, <b>--hold
never</b>|<b>start</b>|<b>error</b>|<b>always</b></p>
<p style="margin-left:22%;">Determine whether to keep the
terminal window open when the command has finished and no
more processes are connected to the terminal. The argument
can be abbreviated to a single letter.</p>
<p style="margin-left:22%; margin-top: 1em">By default, the
window is closed immediately, except if the child process
has exited with status 255, which is used to indicate
failure to execute the shell command. (Exit status 255 is
also used by <b>ssh</b> to indicate connection errors.)</p>
<p style="margin-left:22%; margin-top: 1em">Alternatively,
the window can be set to never stay open, to always stay
open, or to stay open only if the child process terminates
with an error, i.e. with a non-zero exit status or due to a
signal indicating a runtime error.</p>
<p style="margin-left:11%;"><b>-i</b>, <b>--icon</b>
<i>FILE</i>[<b>,</b><i>INDEX</i>]</p>
<p style="margin-left:22%;">Load the window icon from an
executable, DLL, or icon file. The optional comma-separated
index can be used to select a particular icon in a file with
multiple icons.</p>
<p style="margin-left:11%;"><b>-l</b>, <b>--log</b>
<i>FILE</i>|<b>-</b></p>
<p style="margin-left:22%;">Copy all output into the
specified log file, or standard output if a dash is given
instead of a file name. (See also <i>script</i>(1) for a
more flexible logging tool.)</p>
<p style="margin-left:11%;"><b>-o</b>, <b>--option</b>
<i>NAME</i>=<i>VALUE</i></p>
<p style="margin-left:22%;">Override the named config file
option with the given value, e.g. <tt>-o
ScrollbackLines=1000</tt>.</p>
<p style="margin-left:11%;"><b>-p</b>, <b>--position</b>
<i>X</i><b>,</b><i>Y</i></p>
<p style="margin-left:22%;">Open the window with its top
left corner at the specified coordinates.</p>
<p style="margin-left:11%;"><b>-s</b>, <b>--size</b>
<i>COLS</i><b>,</b><i>ROWS</i></p>
<p style="margin-left:22%;">Set the default size of the
window in character columns and rows.</p>
<p style="margin-left:11%;"><b>-t</b>, <b>--title</b>
<i>TITLE</i></p>
<p style="margin-left:22%;">Use <i>TITLE</i> as the initial
window title. By default, the title is set to the executed
command.</p>
<p style="margin-left:11%;"><b>-T</b>, <b>--Title</b>
<i>TITLE</i></p>
<p style="margin-left:22%;">Use <i>TITLE</i> as the
permanent window title. The title is not changeable by
control sequences. This feature is only available on the
command line.</p>
<p style="margin-left:11%;"><b>-B</b>, <b>--Border
frame</b>|<b>void</b></p>
<p style="margin-left:22%;">Suppress window title, display
only a frame or no border. This feature is only available on
the command line.</p>
<p style="margin-left:11%;"><b>-u</b>, <b>--utmp</b></p>
<p style="margin-left:22%;">Create a utmp entry.</p>
<p style="margin-left:11%;"><b>-w</b>, <b>--window
normal</b>|<b>min</b>|<b>max</b>|<b>full</b>|<b>hide</b></p>
<p style="margin-left:22%;">Set the initial window state:
normal, minimised, maximised, full screen, or hidden.</p>
<p style="margin-left:11%;"><b>--class</b> <i>CLASS</i></p>
<p style="margin-left:22%;">Use <i>CLASS</i> as the window
class name of the main window. This allows scripting tools
to distinguish different mintty instances. The default is
"mintty".</p>
<p style="margin-left:11%;"><b>-H</b>, <b>--help</b></p>
<p style="margin-left:22%;">Display a brief help message
and exit.</p>
<p style="margin-left:11%;"><b>-V</b>, <b>--version</b></p>
<p style="margin-left:22%;">Print version information and
exit.</p>
<h2>USAGE
<a name="USAGE"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Mintty tries to
adhere to both Windows and Unix usage conventions. Where
they conflict, an option is usually provided. This section
primarily describes the default configuration; see the
<b>CONFIGURATION</b> section on how it can be
customised.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Menus</b>
<br>
The context menu can be opened by right-clicking the mouse
or by pressing the <b>Menu</b> key that is normally located
next to the right Ctrl key.</p>
<p style="margin-left:11%; margin-top: 1em">Mintty also
adds a couple of items to the window menu, which can be
accessed by clicking on the program icon or pressing
<b>Alt+Space</b>.</p>
<p style="margin-left:11%; margin-top: 1em">Both menus have
an entry that leads to the options dialog for changing
mintty’s configuration.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Copy &
paste</b> <br>
Screen contents can be selected by holding down the left
mouse button and dragging the mouse. If Alt is held down
before the left mouse button, a rectangular block instead of
whole lines will be selected. The selection can be extended
by holding down <b>Shift</b> while left-clicking.
Double-clicking or triple-clicking selects a whole word or
line, whereby word selection includes special characters
that commonly appear in file names and URLs.</p>
<p style="margin-left:11%; margin-top: 1em">By default,
selected text is automatically copied to the clipboard. This
can be disabled on the <b>Mouse</b> page of the options
dialog. Selected text can also be copied manually using
either the <b>Copy</b> menu command, the <b>Ctrl+Ins</b>
keyboard shortcut, or the middle mouse button combined with
<b>Shift</b>.</p>
<p style="margin-left:11%; margin-top: 1em">The selected
region is copied as "rich text" as well as normal
text, which means it can be pasted with colours and
formatting into applications that support it, e.g. word
processors.</p>
<p style="margin-left:11%; margin-top: 1em">The window
title can be copied using the <b>Copy Title</b> command in
the window menu.</p>
<p style="margin-left:11%; margin-top: 1em">The clipboard
contents can be pasted using either the <b>Paste</b> menu
command, the <b>Shift+Ins</b> keyboard shortcut, or the
middle mouse button. Not only text but also files and
directories can be pasted, whereby the latter are inserted
as Cygwin file names. Shell quoting is added to file names
that contain spaces or special characters.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Drag &
drop</b> <br>
Text, files and directories can be dropped into the mintty
window. They are inserted in the same way as if they were
pasted from the clipboard.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Opening
files, directories and URLs</b> <br>
Files, directories and URLs can be opened either by holding
<b>Ctrl</b> while left-clicking on them, or by selecting
them and choosing the <b>Open</b> command from the context
menu. Please note that opening a file or directory with a
relative path only works correctly if the path refers to the
current working directory of the process invoked by
mintty.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Font
zoom</b> <br>
The font size can be increased or decreased using the
keyboard shortcuts <b>Ctrl+plus</b> and <b>Ctrl+minus</b>,
or by holding <b>Ctrl</b> while rolling the mousewheel.
<b>Ctrl+zero</b> returns the font size to the default. If
Shift is also held while resizing, the window will be
resized to scale together with the font, keeping the
terminal character size if possible.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Drag
resize</b> <br>
The usual windows function to drag on the window border
resizes the terminal. If Shift is also held while resizing,
the font will be scaled along with the resizing. Note that
due to the different height/width factors, this is not a
precise operation.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Full
screen</b> <br>
Full screen mode can be toggled using either the <b>Full
Screen</b> command in the menu or either of the
<b>Alt+Enter</b> and <b>Alt+F11</b> keyboard shortcuts, or
the generic window title functions.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Default
size</b> <br>
If the window has been resized, it can be returned to the
default size set in the Window pane of the options using the
<b>Default size</b> command in the menu or the
<b>Alt+F10</b> shortcut.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Reset</b>
<br>
Sometimes a faulty application or printing a binary file
will leave the terminal in an unusable state. In that case,
resetting the terminal’s state via the <b>Reset</b>
command in the menu or the <b>Alt+F8</b> keyboard shortcut
may help.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Scrolling</b>
<br>
Mintty has a scrollback buffer that can hold up to 10000
lines in the default configuration. It can be accessed using
the scrollbar, the mouse wheel, or the keyboard. Hold the
<b>Shift</b> key while pressing the <b>Up</b> and
<b>Down</b> arrow keys to scroll line-by-line or the
<b>PageUp</b> and <b>PageDown</b> keys to scroll
page-by-page.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Flip
screen</b> <br>
Applications such as editors and file viewers normally use a
terminal feature called the alternate screen, which is a
second screen buffer without scrollback. When they exit,
they switch back to the primary screen to restore the
command line as it was before invoking the application.</p>
<p style="margin-left:11%; margin-top: 1em">The <b>Flip
Screen</b> menu command and <b>Alt+F12</b> shortcut allow
looking at the primary screen while the alternate screen is
active, and vice versa. For example, this allows to refer to
past commands while editing a file.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Switching
session</b> <br>
The <b>Ctrl+Tab</b> and <b>Ctrl+Shift+Tab</b> shortcuts can
be used to switch between mintty windows. Minimised windows
are skipped.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Closing a
session</b> <br>
Clicking the window’s close button, pressing
<b>Alt+F4</b>, or choosing <b>Close</b> from the window menu
sends a <i>SIGHUP</i> signal to the process running in
mintty, which normally causes it to exit.</p>
<p style="margin-left:11%; margin-top: 1em">That signal can
be ignored, though, in which case the program might have to
be forced to terminate by sending a <i>SIGKILL</i> signal
instead. This can be done by holding down <b>Shift</b> when
using the close button, shortcut or menu item.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Mouse
tracking</b> <br>
When an application activates mouse tracking, mouse events
are sent to the application rather than being treated as
window events. This is indicated by the mouse pointer
changing from an <b>I</b> shape to an arrow. Holding down
<b>Shift</b> overrides mouse tracking mode and sends mouse
events to the window instead, so that e.g. text can be
selected and the context menu can be accessed.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Alt
codes</b> <br>
The Windows Alt+Numpad method for entering character codes
is supported, whereby the Alt key has to be held while
entering the character code. Only the first key has to be on
the numpad; subsequent digits can be entered both on the
numpad or the main part of the keyboard.</p>
<p style="margin-left:11%; margin-top: 1em">If the first
key is the <b>’+’</b> on the numpad, the code is
interpreted as hexadecimal, whereby digits A through F can
be entered using the letter keys. If the first key is a
zero, the code is interpreted as octal. If the first key is
any other digit from 1 to 9, the code is interpreted as
decimal.</p>
<p style="margin-left:11%; margin-top: 1em">For UTF-8 and
other Unicode encodings such as GB18030, the entered code is
interpreted as a Unicode codepoint and encoded accordingly
before it is sent. For other encodings, the entered code is
sent as is. If it doesn’t fit into one byte, it is
sent as multiple bytes, with the the most significant
non-zero byte first.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Shortcuts</b>
<br>
An overview of all the keyboard shortcuts. <b><br>
Scrollback</b></p>
<p style="margin-left:22%; margin-top: 1em">−
<b>Shift+Up</b>: Line up <br>
− <b>Shift+Down</b>: Line down <br>
− <b>Shift+PgUp</b>: Page up <br>
− <b>Shift+PgDn</b>: Page down <br>
− <b>Shift+Home</b>: Top <br>
− <b>Shift+End</b>: Bottom</p>
<p style="margin-left:11%;"><b>Copy and paste</b></p>
<p style="margin-left:22%; margin-top: 1em">−
<b>Ctrl+Ins</b>: Copy <br>
− <b>Shift+Ins</b>: Paste <br>
− <b>Ctrl+Shift+Ins</b>: Copy and paste</p>
<p style="margin-left:11%;"><b>Window commands</b></p>
<p style="margin-left:22%; margin-top: 1em">−
<b>Alt+F2</b>: New (clone) <br>
− <b>Alt+F4</b>: Close <br>
− <b>Alt+F8</b>: Reset <br>
− <b>Alt+F10</b>: Default size <br>
− <b>Alt+F11</b> or <b>Alt+Enter</b>: Toggle full
screen <br>
− <b>Shift+Alt+F11</b> or <b>Shift+Alt+Enter</b>:
Toggle full screen and zoom font (Note that due to the
different height/width factors, this is not a precise
operation) <br>
− <b>Alt+F12</b>: Flip screen <br>
− <b>Alt+Space</b>: Window menu <br>
− <b>Ctrl+Tab</b>: Next window <br>
− <b>Ctrl+Shift+Tab</b>: Previous window</p>
<p style="margin-left:11%;"><b>Font zoom</b></p>
<p style="margin-left:22%; margin-top: 1em">−
<b>Ctrl+plus</b>: Zoom font in <br>
− <b>Ctrl+minus</b>: Zoom font out <br>
− <b>Ctrl+Shift+plus</b>: Zoom font and window in <br>
− <b>Ctrl+Shift+minus</b>: Zoom font and window out
<br>
− <b>Ctrl+zero</b>: Back to configured font size</p>
<p style="margin-left:11%;"><b>Ctrl+Shift+letter
shortcuts</b></p>
<p style="margin-left:22%; margin-top: 1em">An alternative
set of shortcuts for clipboard and window commands using
<b>Ctrl+Shift+letter</b> combinations is available. These
can be enabled on the Keys pane of the options dialog.</p>
<p style="margin-left:22%; margin-top: 1em">−
<b>Ctrl+Shift+C</b>: Copy <br>
− <b>Ctrl+Shift+V</b>: Paste <br>
− <b>Ctrl+Shift+N</b>: New <br>
− <b>Ctrl+Shift+W</b>: Close <br>
− <b>Ctrl+Shift+R</b>: Reset <br>
− <b>Ctrl+Shift+D</b>: Default size <br>
− <b>Ctrl+Shift+F</b>: Full screen <br>
− <b>Ctrl+Shift+S</b>: Flip screen</p>
<h2>CONFIGURATION
<a name="CONFIGURATION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Mintty has a
graphical options dialog that can be reached via the context
menu or the window menu. As usual, both the <b>Apply</b> and
<b>OK</b> buttons apply any changes made, but <b>OK</b> also
closes the dialog. <b>Cancel</b> discards changes.</p>
<p style="margin-left:11%; margin-top: 1em">In
configuration files, settings are stored as
<i>NAME</i>=<i>VALUE</i> pairs, with one per line. By
default, they are read from <i>/etc/minttyrc</i> and
<i>~/.minttyrc</i>. Additional configuration files can be
specified using the <b>--config</b> command line option.
These are read in order, with settings in later files
overriding those in earlier ones. Configuration changes are
saved to the last file specified, or <i>~/.minttyrc</i> if
none is given. Settings can also be specified on the command
line using <b>--option</b>.</p>
<p style="margin-left:11%; margin-top: 1em">The following
sections explain the settings on each pane of the options
dialog, followed by settings that do not appear in the
dialog. For each setting, its name in the config file is
shown in parentheses, along with its default value.</p>
<p style="margin-left:11%; margin-top: 1em">If there is
only a name in parentheses, there is currently no GUI
configuration facility for that option (see also Hidden
settings below).</p>
<p style="margin-left:11%; margin-top: 1em"><b>Looks</b>
<br>
Settings affecting mintty’s appearance. <b><br>
Colours</b></p>
<p style="margin-left:22%;">Clicking on one of the buttons
here opens the colour selection dialog. In the settings,
colours are represented as comma-separated RGB triples with
decimal 8-bit values ranging from 0 to 255. X-style
hexadecimal colour specifications such as #RRGGBB or
rgb:RR/GG/BB can be used as well.</p>
<p style="margin-left:22%; margin-top: 1em">−
<b>Foreground</b> (ForegroundColour=191,191,191) <br>
− <b>Background</b> (BackgroundColour=0,0,0) <br>
− <b>Cursor</b> (CursorColour=191,191,191)</p>
<p style="margin-left:11%;"><b>Transparency</b>
(Transparency=off)</p>
<p style="margin-left:22%;">Window transparency level, with
the following choices:</p>
<p style="margin-left:22%; margin-top: 1em">−
<b>Off</b> <br>
− <b>Low</b> <br>
− <b>Medium</b> <br>
− <b>High</b> <br>
− <b>Glass</b></p>
<p style="margin-left:22%; margin-top: 1em">The
<b>Glass</b> option is only available on Vista and above
with desktop compositing enabled. To make this reasonably
usable, the glass colour needs to be set to be as dark as
possible in the Windows control panel: choose
<i>Personalize</i> from the desktop context menu, click on
<i>Window Color</i>, turn the colour intensity up to the
maximum, show the colour mixer, and turn the brightness down
to black.</p>
<p style="margin-left:22%; margin-top: 1em">Numeric
transparency values ranging from 4 to 254 can be specified
in config files or on the command line. (Values below 4 are
multiplied by 16, for backward compatibility reasons.)</p>
<p style="margin-left:11%;"><b>Opaque when focused</b>
(OpaqueWhenFocused=no)</p>
<p style="margin-left:22%;">Enable to make the window
opaque when it is active (to avoid background distractions
when working in it).</p>
<p style="margin-left:11%;"><b>Cursor</b>
(CursorType=line)</p>
<p style="margin-left:22%;">The following cursor types are
available:</p>
<p style="margin-left:22%; margin-top: 1em">−
<b>Line</b> <br>
− <b>Block</b> <br>
− <b>Underscore</b></p>
<p style="margin-left:22%; margin-top: 1em">The line cursor
is displayed with the width set in the Accessibility Options
control panel.</p>
<p style="margin-left:11%;"><b>Cursor blink</b>
(CursorBlinks=yes)</p>
<p style="margin-left:22%;">If enabled, the cursor blinks
at the rate set in the Keyboard control panel.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Text</b>
<br>
Settings controlling text display. <b><br>
Font selection</b></p>
<p style="margin-left:22%;">Clicking on the <b>Select</b>
button opens a dialog where the font and its properties can
be chosen. Font styles other than <b>Bold</b> are ignored.
In the config file, this corresponds to the following
entries:</p>
<p style="margin-left:22%; margin-top: 1em">−
<b>Font</b> (Font=Lucida Console) <br>
− <b>Style</b> (FontIsBold=no) <br>
− <b>Size</b> (FontHeight=9)</p>
<p style="margin-left:11%;"><b>Show bold as font</b>
(BoldAsFont=no)</p>
<p style="margin-left:22%;">When this option is enabled,
the ANSI bold (or ’intense’) text attribute is
shown as a bold-style font. Where a bold variant of the
selected font that has the same width as the base font is
available, that is used; otherwise, the bolding is simulated
by rendering the text twice with a one-pixel offset.</p>
<p style="margin-left:11%;"><b>Show bold as colour</b>
(BoldAsColour=yes)</p>
<p style="margin-left:22%;">By default, text with the ANSI
bold attribute set is displayed with a different colour,
usually with increased brightness. This can be disabled
here.</p>
<p style="margin-left:22%; margin-top: 1em">Note that when
<b>BoldAsFont</b> is enabled, only bold text in one of the
eight ANSI colours has its colour changed, i.e. bold text
without an explicitly spefified colour is shown with a bold
font only. This matches <b>xterm</b> behaviour.</p>
<p style="margin-left:22%; margin-top: 1em">This option
also controls how the ’half-bright’ (or
’dim’) text attribute is displayed: if it is on,
half-bright text is shown with halved foreground colour
brightness; otherwise, it is shown by blending the
foreground colour with the background colour.</p>
<p style="margin-left:11%;"><b>Allow blinking</b>
(AllowBlinking=no)</p>
<p style="margin-left:22%;">When text blinking is disabled,
as it is by default, the blink attribute is displayed as a
bold background colour instead.</p>
<p style="margin-left:11%;"><b>Font smoothing</b>
(FontSmoothing=default)</p>
<p style="margin-left:22%;">Select the amount of font
smoothing from the following choices:</p>
<p style="margin-left:22%; margin-top: 1em">−
<b>Default</b>: Use Windows setting. <br>
− <b>None</b>: With all the jaggies. <br>
− <b>Partial</b>: Greyscale anti-aliasing. <br>
− <b>Full</b>: Subpixel anti-aliasing
("ClearType").</p>
<p style="margin-left:11%;"><b>Locale</b> (Locale=)</p>
<p style="margin-left:22%;">The locale setting consists of
a lowercase two-letter or three-letter language code
followed by a two-letter country code, for instance
<b>en_US</b> or <b>zh_CN</b>. The Windows default system and
user locales are shown in the drop-down list for this
setting. Alternatively, the language-neutral "C"
locale can be selected.</p>
<p style="margin-left:22%; margin-top: 1em">If no locale is
set here, which is the default, mintty uses the locale and
character set specified via the environment variables
<i>LC_ALL</i>, <i>LC_CTYPE</i> or <i>LANG</i>.</p>
<p style="margin-left:22%; margin-top: 1em">If the locale
option is set, however, it will override any environment
variable setting: <i>LC_ALL</i> and the <i>LC_*</i>
variables for specific locale categories are cleared, while
<i>LANG</i> is set according to the selected locale and
character set.</p>
<p style="margin-left:11%;"><b>Character set</b>
(Charset=)</p>
<p style="margin-left:22%;">The character set to be used
for encoding input and decoding output. If no locale is set,
this setting is ignored.</p>
<p style="margin-left:22%; margin-top: 1em">While changing
the character set takes effect immediately for text input
and ouput, it does not affect the processes already running
in mintty. This is because the environment variables of a
running process cannot be changed from outside that process.
Therefore mintty needs to be restarted for a character set
change to take full effect.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Keys</b>
<br>
Settings controlling keyboard behaviour. <b><br>
Backspace sends ^H</b> (BackspaceSendsBS=no)</p>
<p style="margin-left:22%;">By default, mintty sends
<b>^?</b> (ASCII DEL) as the keycode for the backspace key.
If this option is enabled, <b>^H</b> is sent instead. This
also changes the <b>Ctrl+Backspace</b> code from <b>^_</b>
to <b>^?</b>.</p>
<p style="margin-left:11%;">(DeleteSendsDEL=no)</p>
<p style="margin-left:22%;">By default, mintty sends VT100
Remove as the keycode for the keypad Del key. If this option
is set =true, <b>^?</b> (ASCII DEL) is sent instead.</p>
<p style="margin-left:11%;"><b>Ctrl+LeftAlt is AltGr</b>
(CtrlAltIsAltGr=no)</p>
<p style="margin-left:22%;">The AltGr key on non-US Windows
systems is a strange beast: pressing it is synonymous with
pressing the left Ctrl key and the right Alt key at the same
time, and Windows programs usually treat any Ctrl+Alt
combination as AltGr.</p>
<p style="margin-left:22%; margin-top: 1em">Some programs,
however, chief among them Microsoft’s very own Office,
do not treat Ctrl+LeftAlt as AltGr, so that Ctrl+LeftAlt
combinations can be used in command shortcuts even when a
key has an AltGr character binding.</p>
<p style="margin-left:22%; margin-top: 1em">By default,
mintty follows Office’s approach, because a number of
terminal programs make use of Ctrl+Alt shortcuts. The
"standard" Windows behaviour can be restored by
ticking the checkbox here.</p>
<p style="margin-left:22%; margin-top: 1em">The setting
makes no difference for keys without AltGr key bindings
(e.g. any key on the standard US layout).</p>
<p style="margin-left:11%;"><b>Copy and Paste shortcuts</b>
(ClipShortcuts=yes)</p>
<p style="margin-left:22%;">Checkbox for enabling the
clipboard shortcuts <b>Ctrl+Ins</b> for copying and
<b>Shift+Ins</b> for pasting.</p>
<p style="margin-left:11%;"><b>Menu and Full Screen
shortcuts</b> (WindowShortcuts=yes)</p>
<p style="margin-left:22%;">Checkbox for enabling the
<b>Alt+Space</b> and <b>Alt+Enter</b> shortcuts for showing
the window menu and toggling full screen mode.</p>
<p style="margin-left:11%;"><b>Switch window shortcuts</b>
(SwitchShortcuts=yes)</p>
<p style="margin-left:22%;">Checkbox for enabling the
<b>Ctrl+Tab</b> and <b>Ctrl+Shift+Tab</b> shortcuts for
switching between mintty windows.</p>
<p style="margin-left:11%;"><b>Zoom shortcuts</b>
(ZoomShortcuts=yes)</p>
<p style="margin-left:22%;">Checkbox for enabling the font
zooming shortcuts <b>Ctrl+plus/minus/zero</b>.</p>
<p style="margin-left:11%;"><b>Alt+Fn shortcuts</b>
(AltFnShortcuts=yes)</p>
<p style="margin-left:22%;">Checkbox for enabling the use
of combinations of Alt and functions keys as shortcuts, for
example <b>Alt+F4</b> for closing the window or
<b>Alt+F11</b> fortoggling full screen mode. Disable to have
<b>Alt+Fn</b> combinations sent to applications instead.</p>
<p style="margin-left:11%;"><b>Ctrl+Shift+letter
shortcuts</b> (CtrlShiftShortcuts=no)</p>
<p style="margin-left:22%;">Checkbox for enabling
alternative clipboard and window command shortcuts using
<b>Ctrl+Shift+letter</b> combinations such as
<b>Ctrl+Shift+V</b> for paste or <b>Ctrl+Shift+N</b> for
starting a new session.</p>
<p style="margin-left:22%; margin-top: 1em">These can
replace the <b>Ctrl/Shift+Ins</b> and <b>Alt+Fn</b>
shortcuts, whereby they show up in menus only if the
corresponding default shortcuts are disabled.</p>
<p style="margin-left:22%; margin-top: 1em">See the
shortcuts section above for the list of shortcuts controlled
by this option. When it is disabled, Ctrl+Shift+letter
combinations are sent to applications as C1 control
characters instead.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Mouse</b>
<br>
Settings controlling mouse support. <b><br>
Copy on select</b> (CopyOnSelect=yes)</p>
<p style="margin-left:22%;">If enabled, the region selected
with the mouse is copied to the clipboard as soon as the
mouse button is released, thus emulating X Window
behaviour.</p>
<p style="margin-left:11%;"><b>Copy as rich text</b>
(CopyAsRTF=yes)</p>
<p style="margin-left:22%;">If this option is enabled,
which it is by default, text is copied to the clipboard in
rich text format (RTF) in addition to plain text format. RTF
preserves colours and styles when pasting text into
applications that support it, e.g. word processors.</p>
<p style="margin-left:11%;"><b>Clicks place command line
cursor</b> (ClicksPlaceCursor=no)</p>
<p style="margin-left:22%;">If enabled, the command line
cursor can be placed by pressing the left mouse button. This
works by sending the number of cursor keycodes needed to get
to the destination.</p>
<p style="margin-left:11%;">(MiddleClickAction=paste)</p>
<p style="margin-left:22%;">Action to take when the middle
mouse button is pressed.</p>
<p style="margin-left:22%; margin-top: 1em">−
<b>Paste</b>: Paste the clipboard contents. <br>
− <b>Extend</b>: Extend the selected region. <br>
− <b>Enter</b>: Simulate <b>Enter</b>/<b>Return</b>
key. <br>
− <b>Void</b>: Do nothing.</p>
<p style="margin-left:11%;"><b>Right click action</b>
(RightClickAction=menu)</p>
<p style="margin-left:22%;">Action to take when the right
mouse button is pressed.</p>
<p style="margin-left:22%; margin-top: 1em">−
<b>Paste</b>: Paste the clipboard contents. <br>
− <b>Extend</b>: Extend the selected region. <br>
− <b>Enter</b>: Simulate <b>Enter</b>/<b>Return</b>
key. <br>
− <b>Menu</b>: Show the context menu.</p>
<p style="margin-left:22%; margin-top: 1em">If this is set
to <b>Paste</b>, the middle button extends the selected
region instead of pasting the clipboard. If it is set to
<b>Extend</b>, a left click with <b>Shift</b> pressed pastes
the clipboard instead of extending the selection.</p>
<p style="margin-left:11%;"><b>Default click target</b>
(ClicksTargetApp=yes)</p>
<p style="margin-left:22%;">This applies to application
mouse mode, i.e. when the application activates xterm-style
mouse reporting. In that mode, mouse clicks can be sent
either to the application to process as it sees fit, or to
the window for the usual actions such as select and
paste.</p>
<p style="margin-left:22%; margin-top: 1em">−
<b>Window</b> <br>
− <b>Application</b></p>
<p style="margin-left:11%;"><b>Modifier key for overriding
default</b> (ClickTargetMod=shift)</p>
<p style="margin-left:22%;">The modifier key selected here
can be used to override the click target in application
mouse mode. With the default settings, clicks are sent to
the application and Shift needs to be held to trigger window
actions instead.</p>
<p style="margin-left:22%; margin-top: 1em">The <b>Off</b>
setting disables overriding.</p>
<p style="margin-left:22%; margin-top: 1em">−
<b>Shift</b> <br>
− <b>Ctrl</b> <br>
− <b>Alt</b> <br>
− <b>Off</b></p>
<p style="margin-left:11%;">(HideMouse=on)</p>
<p style="margin-left:22%;">By default, mintty
automatically hides the cross-hair mouse cursor when
keyboard input is being entered. Setting this option =false
keeps the cursor.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Window</b>
<br>
Window properties. <b><br>
Columns</b> (Columns=80)</p>
<p style="margin-left:22%;">Default width of the window, in
character cells.</p>
<p style="margin-left:11%;"><b>Rows</b> (Rows=24)</p>
<p style="margin-left:22%;">Default height of the window,
in character cells.</p>
<p style="margin-left:11%;">(RowSpacing=0)</p>
<p style="margin-left:22%;">Additional row padding;
RowSpacing=-1 works nicely with the Consolas fonts.</p>
<p style="margin-left:11%;">(ColSpacing=0)</p>
<p style="margin-left:22%;">Additional column padding;
ColSpacing=1 can avoid boldened glyphs being clipped.</p>
<p style="margin-left:11%;"><b>Current size</b></p>
<p style="margin-left:22%;">Pressing this button sets the
default width and height to the window’s current
size.</p>
<p style="margin-left:11%;"><b>Scrollback lines</b>
(ScrollbackLines=10000)</p>
<p style="margin-left:22%;">The maximum number of lines to
keep in the scrollback buffer.</p>
<p style="margin-left:11%;"><b>Scrollbar</b>
(Scrollbar=right)</p>
<p style="margin-left:22%;">The scrollbar can be shown on
either side of the window or just hidden. By default, it is
shown on the right-hand side.</p>
<p style="margin-left:22%; margin-top: 1em">−
<b>Left</b> <br>
− <b>None</b> <br>
− <b>Right</b></p>
<p style="margin-left:11%;"><b>Modifier for scrolling</b>
(ScrollMod=shift)</p>
<p style="margin-left:22%;">The modifier key that needs to
be pressed together with the arrow up/down, PgUp/PgDn, or
Home/End keys to access the scrollback buffer. The default
is <b>Shift</b>. The <b>Off</b> setting disables scrolling
with keyboard shortcuts.</p>
<p style="margin-left:22%; margin-top: 1em">−
<b>Shift</b> <br>
− <b>Ctrl</b> <br>
− <b>Alt</b> <br>
− <b>Off</b></p>
<p style="margin-left:11%;"><b>PgUp and PgDn scroll without
modifier</b> (PgUpDnScroll=no)</p>
<p style="margin-left:22%;">If this is enabled, the
scrollback buffer can be accessed by just pressing PgUp or
PgDn, without the ’modifier for scrolling’
selected above. If the modifier is pressed anyway, plain
PgUp/PgDn keycodes are sent to the application. This option
does not affect the arrow keys or Home/End keys.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Terminal</b>
<br>
Terminal emulation settings. <b><br>
Type</b> (Term=xterm)</p>
<p style="margin-left:22%;">The terminal type. This
determines the setting of the TERM environment variable at
mintty startup. Choices available from the dropdown list are
<b>xterm</b>, <b>xterm-256color</b>, <b>xterm-vt220</b>,
<b>vt220</b>, and <b>vt100</b>.</p>
<p style="margin-left:22%; margin-top: 1em">If the setting
contains "vt220", xterm VT220-style function key
mode is enabled instead of the default PC-style function key
mode. (This can otherwise be set with the DECSET 1061
control sequence.)</p>
<p style="margin-left:22%; margin-top: 1em">Apart from
that, this setting has no effect on mintty’s terminal
emulation, i.e. all the features are always available.
However, the TERM setting does tell applications what
features they can use.</p>
<p style="margin-left:22%; margin-top: 1em">The
<b>xterm-256color</b> setting enables 256-color mode in some
applications, but may not be recognised at all by others,
which is why plain <b>xterm</b> is the default.</p>
<p style="margin-left:11%;"><b>Answerback</b>
(Answerback=)</p>
<p style="margin-left:22%; margin-top: 1em">The answerback
string is sent in response to the <b>^E</b> (ENQ) character.
By default, this is empty.</p>
<table width="100%" border="0" rules="none" frame="void"
cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="6%">
<p><b>Bell</b></p></td>
<td width="5%"></td>