Mercurial > vim
annotate runtime/doc/os_haiku.txt @ 32029:23e8d0371e35 v9.0.1346
patch 9.0.1346: Starlark files are not recognized
Commit: https://github.com/vim/vim/commit/ca06b30073de22dc120b532e90fbee2a10ef9772
Author: Amaan Qureshi <amaanq12@gmail.com>
Date: Thu Feb 23 15:38:49 2023 +0000
patch 9.0.1346: Starlark files are not recognized
Problem: Starlark files are not recognized.
Solution: Add patterns for Starlark files. (Amaan Qureshi, closes https://github.com/vim/vim/issues/12049)
| author | Bram Moolenaar <Bram@vim.org> |
|---|---|
| date | Thu, 23 Feb 2023 16:45:03 +0100 |
| parents | a7801222c9c5 |
| children | 4635e43f2c6f |
| rev | line source |
|---|---|
| 29314 | 1 *os_haiku.txt* For Vim version 9.0. Last change: 2020 May 13 |
| 19526 | 2 |
| 3 | |
| 4 VIM REFERENCE MANUAL by Bram Moolenaar | |
| 5 | |
| 6 | |
| 7 *Haiku* | |
| 8 This file contains the particularities for the Haiku version of Vim. For | |
| 9 matters not discussed in this file, Vim behaves very much like the Unix | |
| 10 |os_unix.txt| version. | |
| 11 | |
| 12 Haiku is an open-source operating system inspired by BeOS, that specifically | |
| 13 targets personal computing. | |
| 14 | |
| 15 1. General |haiku-general| | |
| 16 2. Compiling Vim |haiku-compiling| | |
| 17 3. The Haiku GUI |haiku-gui| | |
| 18 4. The $VIM directory |haiku-vimdir| | |
| 19721 | 19 5. The $USER_SETTINGS_DIR |
| 19526 | 20 directory |haiku-user-settings-dir| |
| 21 6. Drag & Drop |haiku-dragndrop| | |
| 22 7. Single Launch vs. Multiple | |
| 23 Launch |haiku-launch| | |
| 24 8. Fonts |haiku-fonts| | |
| 25 9. The meta key modifier |haiku-meta| | |
| 26 10. Mouse key mappings |haiku-mouse| | |
| 27 11. Color names |haiku-colors| | |
| 20241 | 28 12. GUI Toolbar Images |haiku-toolbar-images| |
| 29 13. Credits |haiku-support-credits| | |
| 30 14. Bugs & to-do |haiku-bugs| | |
| 19526 | 31 |
| 32 | |
| 33 1. General *haiku-general* | |
| 34 | |
| 35 The default syntax highlighting mostly works with different foreground colors | |
| 36 to highlight items. This works best if you set your Terminal window to a | |
| 37 darkish background and light letters. Some middle-grey background (for | |
| 38 instance (r,g,b)=(168,168,168)) with black letters also works nicely. | |
| 39 | |
| 40 | |
| 41 2. Compiling Vim *haiku-compiling* | |
| 42 | |
| 43 Vim can be compiled using the standard configure/make approach. Running | |
| 44 ./configure without any arguments or passing --enable-gui=haiku, will compile | |
| 45 vim with the Haiku GUI support. Run ./configure --help , to find out other | |
| 46 features you can enable/disable. | |
| 47 | |
| 19721 | 48 Haiku uses "ncurses6" as its terminal library, therefore you need to have |
| 49 "ncurses6_devel" package installed from HaikuDepot in order to configure | |
| 30875 | 50 the Haiku build. Just append "--with-tlib=ncurses" to ./configure command. |
| 19721 | 51 |
| 19526 | 52 Now you should use "make" to compile Vim, then "make install" to install it. |
| 19721 | 53 For seamless integration into Haiku, the GUI-less vim binary should be |
|
20223
57a69af99e48
patch 8.2.0667: cannot install Haiku version from source
Bram Moolenaar <Bram@vim.org>
parents:
19968
diff
changeset
|
54 additionally installed over the GUI version. Typical build commands are: |
| 19526 | 55 |
| 56 ./configure --prefix=`finddir B_SYSTEM_NONPACKAGED_DIRECTORY` \ | |
| 57 --datarootdir=`finddir B_SYSTEM_NONPACKAGED_DATA_DIRECTORY` \ | |
| 58 --mandir=`finddir B_SYSTEM_NONPACKAGED_DIRECTORY`/documentation/man \ | |
| 31028 | 59 --with-tlib=ncurses |
| 19526 | 60 make clean |
| 61 make install | |
| 62 | |
| 63 ./configure --prefix=`finddir B_SYSTEM_NONPACKAGED_DIRECTORY` \ | |
| 64 --datarootdir=`finddir B_SYSTEM_NONPACKAGED_DATA_DIRECTORY` \ | |
| 65 --mandir=`finddir B_SYSTEM_NONPACKAGED_DIRECTORY`/documentation/man \ | |
| 30875 | 66 --with-tlib=ncurses \ |
| 19526 | 67 --disable-gui |
| 68 make clean | |
| 69 make install | |
| 70 | |
| 71 | |
| 72 3. The Haiku GUI *haiku-gui* | |
| 73 | |
| 74 Normally Vim starts with the GUI if you start it as gvim or vim -g. The vim | |
| 75 version with GUI tries to determine if it was started from the Tracker instead | |
|
20223
57a69af99e48
patch 8.2.0667: cannot install Haiku version from source
Bram Moolenaar <Bram@vim.org>
parents:
19968
diff
changeset
|
76 of the Terminal, and if so, uses the GUI anyway. However, the current detection |
| 19526 | 77 scheme is fooled if you use the command "vim - </dev/null". |
| 78 | |
| 79 Stuff that does not work yet: | |
| 80 | |
|
20223
57a69af99e48
patch 8.2.0667: cannot install Haiku version from source
Bram Moolenaar <Bram@vim.org>
parents:
19968
diff
changeset
|
81 - Mouse up events are not generated when outside the window. You can notice |
|
57a69af99e48
patch 8.2.0667: cannot install Haiku version from source
Bram Moolenaar <Bram@vim.org>
parents:
19968
diff
changeset
|
82 this when selecting text and moving the cursor outside the window, then |
|
57a69af99e48
patch 8.2.0667: cannot install Haiku version from source
Bram Moolenaar <Bram@vim.org>
parents:
19968
diff
changeset
|
83 letting go of the mouse button. Another way is when you drag the scrollbar |
|
57a69af99e48
patch 8.2.0667: cannot install Haiku version from source
Bram Moolenaar <Bram@vim.org>
parents:
19968
diff
changeset
|
84 and do the same thing. Because Vim still thinks you are still playing with |
|
57a69af99e48
patch 8.2.0667: cannot install Haiku version from source
Bram Moolenaar <Bram@vim.org>
parents:
19968
diff
changeset
|
85 the scrollbar it won't change it itself. There is a workaround which kicks |
|
57a69af99e48
patch 8.2.0667: cannot install Haiku version from source
Bram Moolenaar <Bram@vim.org>
parents:
19968
diff
changeset
|
86 in when the window is activated or deactivated (so it works best with focus- |
|
57a69af99e48
patch 8.2.0667: cannot install Haiku version from source
Bram Moolenaar <Bram@vim.org>
parents:
19968
diff
changeset
|
87 follows-mouse turned on). |
| 19813 | 88 - The cursor does not flash. |
| 19526 | 89 |
| 90 | |
| 91 4. The $VIM directory *haiku-vimdir* | |
| 92 | |
| 19968 | 93 $VIM is the symbolic name for the place where Vim's support files are stored. |
|
20223
57a69af99e48
patch 8.2.0667: cannot install Haiku version from source
Bram Moolenaar <Bram@vim.org>
parents:
19968
diff
changeset
|
94 The default value for $VIM is set at compile time and can be determined with: |
| 19526 | 95 |
| 96 :version | |
| 97 | |
| 31200 | 98 The normal value is /boot/system/data/vim for Haikuports version, |
| 19721 | 99 /boot/system/non-packaged/data/vim for manual builds. If you don't like it |
| 100 you can set the VIM environment variable to override this, or set 'helpfile' | |
| 101 in your .vimrc: > | |
| 19526 | 102 |
| 103 :if version >= 500 | |
| 104 : set helpfile=~/vim/runtime/doc/help.txt | |
| 105 : syntax on | |
| 106 :endif | |
| 107 | |
| 108 | |
| 109 5. The $USER_SETTINGS_DIR directory *haiku-user-settings-dir* | |
| 110 | |
| 111 $USER_SETTINGS_DIR is the symbolic name for the place where Haiku | |
| 112 configuration and settings files are stored. | |
| 113 | |
| 114 The normal value is /boot/home/config/settings. | |
| 115 | |
| 116 | |
| 117 6. Drag & Drop *haiku-dragndrop* | |
| 118 | |
| 119 You can drop files and directories on either the Vim icon (starts a new Vim | |
| 120 session, unless you use the File Types application to set Vim to be "Single | |
| 121 Launch") or on the Vim window (starts editing the files). Dropping a folder | |
|
20223
57a69af99e48
patch 8.2.0667: cannot install Haiku version from source
Bram Moolenaar <Bram@vim.org>
parents:
19968
diff
changeset
|
122 sets Vim's current working directory |:cd| |:pwd|. If you drop files or |
| 19526 | 123 folders with either SHIFT key pressed, Vim changes directory to the folder |
| 124 that contains the first item dropped. When starting Vim, there is no need to | |
| 125 press shift: Vim behaves as if you do. | |
| 126 | |
| 127 Files dropped set the current argument list. |argument-list| | |
| 128 | |
| 129 | |
| 130 7. Single Launch vs. Multiple Launch *haiku-launch* | |
| 131 | |
| 132 As distributed Vim's Application Flags (as seen in the FileTypes preference) | |
| 133 are set to Multiple Launch. If you prefer, you can set them to Single Launch | |
| 134 instead. Attempts to start a second copy of Vim will cause the first Vim to | |
| 135 open the files instead. This works from the Tracker but also from the command | |
| 136 line. In the latter case, non-file (option) arguments are not supported. | |
| 137 Another drawback of the Single Launch is silent ignore of "Open With ..." | |
| 138 requests by vim instance that running as non-GUI application even GUI support | |
| 139 was compiled in. Vim instance running with GUI has no such problems. | |
| 140 | |
| 141 NB: Only the GUI version has a BApplication (and hence Application Flags). | |
| 142 This section does not apply to the GUI-less version, should you compile one. | |
| 143 | |
| 144 | |
| 145 8. Fonts *haiku-fonts* | |
| 146 | |
| 147 Set fonts with > | |
| 148 | |
| 149 :set guifont=DejaVu_Sans_Mono/Book/12 | |
| 150 | |
| 151 where the first part is the font family, the second part the style, and the | |
| 152 third part the size. You can use underscores instead of spaces in family and | |
| 153 style. | |
| 154 | |
| 155 Best results are obtained with monospaced fonts. Vim attempts to use all | |
| 156 fonts in B_FIXED_SPACING mode but apparently this does not work for | |
| 157 proportional fonts (despite what the BeBook says). | |
| 158 | |
| 159 To verify which encodings are supported by the current font give the > | |
| 160 | |
| 161 :digraphs | |
| 162 | |
| 163 command, which lists a bunch of characters with their ISO Latin 1 encoding. | |
| 164 If, for instance, there are "box" characters among them, or the last character | |
| 165 isn't a dotted-y, then for this font the encoding does not work. | |
| 166 | |
| 167 If the font you specify is unavailable, you get the system fixed font. | |
| 168 | |
|
20223
57a69af99e48
patch 8.2.0667: cannot install Haiku version from source
Bram Moolenaar <Bram@vim.org>
parents:
19968
diff
changeset
|
169 GUI Font Selection Dialog is available at giving the: |
| 19526 | 170 |
| 171 :set guifont=* | |
| 172 | |
| 173 command. | |
| 174 | |
| 175 | |
| 176 9. The meta key modifier *haiku-meta* | |
| 177 | |
| 178 The META key modifier is obtained by the left or right OPTION keys. This is | |
| 179 because the ALT (aka COMMAND) keys are not passed to applications. | |
| 180 | |
| 181 | |
| 182 10. Mouse key mappings *haiku-mouse* | |
| 183 | |
| 184 Vim calls the various mouse buttons LeftMouse, MiddleMouse and RightMouse. If | |
| 185 you use the default Mouse preference settings these names indeed correspond to | |
| 186 reality. Vim uses this mapping: | |
| 187 | |
| 188 Button 1 -> LeftMouse, | |
| 189 Button 2 -> RightMouse, | |
| 190 Button 3 -> MiddleMouse. | |
| 191 | |
| 192 If your mouse has fewer than 3 buttons you can provide your own mapping from | |
| 193 mouse clicks with modifier(s) to other mouse buttons. See the file | |
| 194 $VIM/macros/swapmous.vim for an example. |gui-mouse-mapping| | |
| 195 | |
| 196 | |
| 197 11. Color names *haiku-colors* | |
| 198 | |
|
26057
92c424550367
patch 8.2.3562: cannot add color names
Bram Moolenaar <Bram@vim.org>
parents:
20552
diff
changeset
|
199 Vim has a number of color names built-in. Additional names can be defined in |
|
92c424550367
patch 8.2.3562: cannot add color names
Bram Moolenaar <Bram@vim.org>
parents:
20552
diff
changeset
|
200 |v:colornames|. See |:colorscheme| for details. |
| 19526 | 201 |
| 202 | |
| 203 12. GUI Toolbar Images *haiku-toolbar-images* | |
| 204 | |
| 205 Alternative set of toolbar images should be the PNG image of any height you | |
| 206 like. Image width is calculated to contain at least 32 buttons in one-row | |
| 207 cells. | |
| 208 The image should be stored under the name $VIRUNTIME/bitmaps/builtin-tools.png | |
| 209 More info about the buttons assignment are at |builtin-tools|. | |
| 210 | |
| 211 | |
| 212 13. Credits *haiku-support-credits* | |
| 213 | |
| 214 Haiku port is based on work done for BeOS version by many people | |
| 215 - BeBox GUI support Copyright 1998 by Olaf Seibert; | |
| 216 - Ported to R4 by Richard Offer <richard@whitequeen.com> Jul 99; | |
| 217 - Those who contributed, not listed above but not forgotten; | |
| 218 - Haiku support by Siarzhuk Zharski <imker@gmx.li> Apr-Mai 2009. | |
| 219 | |
| 220 All the changes and patches released under vim-license. | |
| 221 | |
| 222 Thank you, all! | |
| 223 | |
| 224 | |
| 20241 | 225 14. Bugs & to-do *haiku-bugs* |
| 31200 | 226 |
| 19813 | 227 The port is under development now and far away from the perfect state. For bug |
| 228 reports, patches and wishes, please use the Vim mailing list or Vim Github | |
| 229 repository. | |
| 31200 | 230 |
| 19813 | 231 Mailing list: https://www.vim.org/maillist.php |
| 232 Vim Github repository: https://github.com/vim/vim | |
| 19526 | 233 |
| 234 | |
| 235 vim:tw=78:ts=8:ft=help:norl: |