Partially synced with the branch.
[MacVim.git] / runtime / doc / os_qnx.txt
blob3b50ace47d79affa81d4f3884199c7adce795727
1 *os_qnx.txt*    For Vim version 7.2c.  Last change: 2005 Mar 29
4                   VIM REFERENCE MANUAL    by Julian Kinraid
7                                                         *QNX* *qnx*
9 1. General                      |qnx-general|
10 2. Compiling Vim                |qnx-compiling|
11 3. Terminal support             |qnx-terminal|
12 4. Photon GUI                   |photon-gui|
13 5. Photon fonts                 |photon-fonts|
14 6. Bugs & things To Do
16 ==============================================================================
18 1. General                                              *qnx-general*
20 Vim on QNX behaves much like other unix versions. |os_unix.txt|
23 2. Compiling Vim                                        *qnx-compiling*
25 Vim can be compiled using the standard configure/make approach.  If you want to
26 compile for X11, pass the --with-x option to configure.  Otherwise, running
27 ./configure without any arguments or passing --enable-gui=photon, will compile
28 vim with the Photon gui support.  Run ./configure --help , to find out other
29 features you can enable/disable.
32 3. Terminal support                                     *qnx-terminal*
34 Vim has support for the mouse and clipboard in a pterm, if those options
35 are compiled in, which they are normally.
37 The options that affect mouse support are |'mouse'| and |'ttymouse'|.  When
38 using the mouse, only simple left and right mouse clicking/dragging is
39 supported.  If you hold down shift, ctrl, or alt while using the mouse, pterm
40 will handle the mouse itself.  It will make a selection, separate from what
41 vim's doing.
43 When the mouse is in use, you can press Alt-RightMouse to open the pterm menu.
44 To turn the mouse off in vim, set the mouse option to nothing, set mouse=
47 4. Photon GUI                                           *photon-gui*
49 To start the gui for vim, you need to run either gvim or vim -g, otherwise
50 the terminal version will run.  For more info - |gui-x11-start|
52 Supported features:
53         :browse command                                 |:browse|
54         :confirm command                                |:confirm|
55         Cursor blinking                                 |'guicursor'|
56         Menus, popup menus and menu priorities          |:menu|
57                                                         |popup-menu|
58                                                         |menu-priority|
59         Toolbar                                         |gui-toolbar|
60                                                         |'toolbar'|
61         Font selector (:set guifont=*)                  |photon-fonts|
62         Mouse focus                                     |'mousefocus'|
63         Mouse hide                                      |'mousehide'|
64         Mouse cursor shapes                             |'mouseshape'|
65         Clipboard                                       |gui-clipboard|
67 Unfinished features:
68         Various international support, such as Farsi & Hebrew support,
69         different encodings, etc.
71         This help file
73 Unsupported features:
74         Find & Replace window                           |:promptfind|
75         Tearoff menus
77         Other things which I can't think of so I can't list them
80 5. Fonts                                                *photon-fonts*
82 You set fonts in the gui with the guifont option >
83         :set guifont=Lucida\ Terminal
85 The font must be a monospace font, and any spaces in the font name must be
86 escaped with a '\'.  The default font used is PC Terminal, size 8.  Using
87 '*' as the font name will open a standard Photon font selector where you can
88 select a font.
90 Following the name, you can include optional settings to control the size and
91 style of the font, each setting separated by a ':'.  Not all fonts support the
92 various styles.
94 The options are,
95     s{size}     Set the size of the font to {size}
96     b           Bold style
97     a           Use antialiasing
98     i           Italic style
100 Examples:
102 Set the font to monospace size 10 with antialiasing >
103         :set guifont=monospace:s10:a
105 Set the font to Courier size 12, with bold and italics >
106         :set guifont=Courier:s12:b:i
108 Select a font with the requester >
109         :set guifont=*
113 6. Bugs & things To Do
115 Known problems:
116         - Vim hangs sometimes when running an external program.  Workaround:
117           put this line in your |vimrc| file: >
118                 set noguipty
120 Bugs:
121         - Still a slight problem with menu highlighting.
122         - When using phditto/phinows/etc., if you are using a font that
123           doesn't support the bold attribute, when vim attempts to draw
124           bold text it will be all messed up.
125         - The cursor can sometimes be hard to see.
126         - A number of minor problems that can fixed. :)
128 Todo:
129         - Improve multi-language support.
130         - Options for setting the fonts used in the menu and toolbar.
131         - Find & Replace dialog.
132         - The clientserver features.
133         - Maybe tearoff menus.
135         - Replace usage of fork() with spawn() when launching external
136           programs.
138  vim:tw=78:sw=4:ts=8:ts=8:ft=help:norl: