Kylix: what changed
Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | **Kylix**® is an [[Object Pascal]] [[Compiler|compiler]] and IDE released by Borland International for the [[Linux]] [[operating system]]. It is an attempt to provide the equivalent functionality of their [[Delphi]]® Object [[Pascal]] product for the Microsoft Windows operating system. | |
| 2 | 2 | ||
| 3 | 3 | ## Kylix 3 Open Edition | |
| 4 | 4 | ||
| 5 | 5 | Borland used to distribute a version of Kylix free for personal use that was called "Kylix 3 Open Edition", but this version unfortunately can no longer be legally distributed. | |
| 6 | 6 | ||
| 7 | 7 | **NOTE**:\ | |
| 8 | 8 | Kylix 3 is rather hard to install and get working with the latest Linux distros (this issue is only related to the Kylix IDE, not the applications created with it). | |
| 9 | 9 | ||
| 10 | 10 | It is therefore highly recommended that you rather install Free Pascal Compiler and the Lazarus IDE for any new development work. They are similar to Kylix and Delphi, but a lot more up to date than Kylix. Free Pascal and Lazarus are excellent tools and are Open Source, so they will always be available - without activation requirements. | |
| 11 | 11 | ||
| 12 | 12 | There is another cross-platform GUI toolkit you can try with Free Pascal; it is called [[fpGUI|fpGUI Toolkit]]. | |
| 13 | 13 | ||
| 14 | 14 | - Free Pascal: <https://www.freepascal.org> | |
| 15 | 15 | - Lazarus: <https://lazarus-ide.org> | |
| 16 | 16 | - fpGUI Toolkit: <https://sourceforge.net/projects/fpgui/> | |
| 17 | 17 | ||
| 18 | 18 | ## Installing Kylix Help in the Lazarus IDE | |
| 19 | 19 | ||
| 20 | 20 | For users who have a legal copy of Kylix, it is possible to add Kylix 3 context-sensitive help files to Lazarus IDE running on Linux x86. The benefit from those help files is that they are very detailed, and also contain the Object Pascal Language Reference help - most of which is applicable to FPC's Object Pascal syntax or the Lazarus LCL. Note that this uses the proprietary HyperHelp program, so is not portable to other platforms. | |
| 21 | 21 | ||
| 22 | 22 | ### Files needed from Kylix3 | |
| 23 | 23 | ||
| 24 | 24 | These are the files and directories needed from the `${HOME}/kylix/help` directory. | |
| 25 | 25 | ||
| 26 | 26 | (I suspect that the help system from the free version of Kylix may work as well. ) | |
| 27 | 27 | ||
| 28 | - | ||
| 29 | - | ||
| 30 | - | ||
| 31 | - | ||
| 32 | - | ||
| 33 | - | ||
| 34 | - | ||
| 35 | - | ||
| 36 | - | ||
| 37 | - | ||
| 38 | - | ||
| 39 | - | ||
| 40 | - | ||
| 41 | - | ||
| 42 | - | ||
| 43 | - | ||
| 44 | - | ||
| 28 | + | ```text | |
| 29 | + | bin/ k3clx.hlp k3dbd.cnt k3.hlp | |
| 30 | + | foo k3.cnt k3dbd.fts k3indy.cnt | |
| 31 | + | foo~ k3copts.cnt k3dbd.hlp k3indy.fts | |
| 32 | + | hhintro.txt k3copts.fts k3dbx.cnt k3indy.hlp | |
| 33 | + | hoh.cnt k3copts.hlp k3dbx.fts k3iota.cnt | |
| 34 | + | hoh.fts k3crtl.cnt k3dbx.hlp k3iota.fts | |
| 35 | + | hoh.hlp k3crtl.fts k3derrs.cnt k3iota.hlp | |
| 36 | + | hyperhelp.sh* k3crtl.hlp k3derrs.fts k3new.cnt | |
| 37 | + | k3.als k3ctools.cnt k3derrs.hlp k3new.fts | |
| 38 | + | k3cerrs.cnt k3ctools.fts k3dlr.cnt k3new.hlp | |
| 39 | + | k3cerrs.fts k3ctools.hlp k3dlr.fts k3prog.cnt | |
| 40 | + | k3cerrs.hlp k3cw.cnt k3dlr.hlp k3prog.fts | |
| 41 | + | k3clr.cnt k3cw.fts k3dopts.cnt k3prog.hlp | |
| 42 | + | k3clr.fts k3cw.hlp k3dopts.fts lib/ | |
| 43 | + | k3clr.hlp k3dap.cnt k3dopts.hlp | |
| 44 | + | k3clx.cnt k3dap.fts k3.ftg | |
| 45 | + | k3clx.fts k3dap.hlp k3.fts | |
| 46 | + | ``` | |
| 45 | 47 | ||
| 46 | 48 | Most of the above files may not pertain to Lazarus, such as the k3c* files which relate to C++, but they are harmless to keep around. | |
| 47 | 49 | ||
| 48 | 50 | The bare minimum files needed for the context help are these: | |
| 49 | 51 | ||
| 50 | - | ||
| 51 | - | ||
| 52 | + | ```text | |
| 53 | + | bin/ k3.als k3clx.fts k3.cnt k3.fts lib/ | |
| 54 | + | hyperhelp.sh* k3clx.cnt k3clx.hlp k3.ftg k3.hlp | |
| 55 | + | ``` | |
| 52 | 56 | ||
| 53 | 57 | ### The hyperhelp.sh script | |
| 54 | 58 | ||
| 55 | 59 | We do need to dress up the default help script provided with Kylix so that it will work as a standalone application under X. Note that the last line of the script sets some missing rendering parameters. Also note the -geometry which positions the window and sets its size. | |
| 56 | 60 | ||
| 57 | 61 | ``` bash | |
| 58 | 62 | #!/bin/bash | |
| 59 | 63 | HHHOME="${HOME}/Lazarus/DelphiHelp" | |
| 60 | 64 | XPPATH="${HHHOME}/xprinter" | |
| 61 | 65 | LANG=en_US | |
| 62 | 66 | LC_ALL=en_US | |
| 63 | 67 | locale=${LC_ALL:-${LC_CTYPE:-${LANG:-"C" | |
| 64 | 68 | LD_LIBRARY_PATH+="lib/locale/"${locale}":lib:" | |
| 65 | 69 | XAPPLRESDIR="app-defaults" | |
| 66 | 70 | NLSPATH="lib/locale/%L/%N.cat" | |
| 67 | 71 | export XPPATH HHHOME LANG LC_ALL LD_LIBRARY_PATH XAPPLRESDIR NLSPATH | |
| 68 | 72 | cd $HHHOME | |
| 69 | 73 | bin/hyperhelp k3clx.hlp -m AL\($1,3,,main\)\ | |
| 70 | 74 | -s 0 -d 32159 -display :0.0 -geometry 600x500+100+100 -w | |
| 71 | 75 | ``` | |
| 72 | 76 | ||
| 73 | 77 | ### My directory tree | |
| 74 | 78 | ||
| 75 | 79 | This is where I have placed the Kylix Help file directory. It is under my installation of Lazarus in the user home directory. The hyperhelp.sh script refers to these locations. | |
| 76 | 80 | ||
| 77 | 81 | /home/tom/Lazarus/DelphiHelp/ | |
| 78 | 82 | |-- bin | |
| 79 | 83 | `-- lib | |
| 80 | 84 | `-- locale | |
| 81 | 85 | |-- de_DE | |
| 82 | 86 | |-- fr_FR | |
| 83 | 87 | |-- ja_JP.SJIS | |
| 84 | 88 | |-- ja_JP.eucJP | |
| 85 | 89 | `-- ja_JP.eucjp | |
| 86 | 90 | ||
| 87 | 91 | ### Custom Tool setup in IDE | |
| 88 | 92 | ||
| 89 | 93 | Finally, set up the new custom tool within Lazarus from the menu 'Tools\|Configure custom tools\|Add'. Replace '/home/tom/' with your user home directory path. This has to be an absolute path to the hyperhelp.sh script. | |
| 90 | 94 | ||
| 91 | 95 |  | |
| 92 | 96 | ||
| 93 | 97 | ### In summary | |
| 94 | 98 | ||
| 95 | 99 | Just place your cursor in the edit window on the word you want to find help for and press `Ctrl`+`F1`. The Kylix help will then open up the context sensitive help page for that keyword. | |
| 96 | 100 | ||
| 97 | 101 | --- | |
| 98 | 102 | *From the Free Pascal wiki, page "Kylix", as it stood on 2021-01-26 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |