Sign in Join
Wiki copytemporary

Kylix: what changed

Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.

Title: Kylix

OldNewLine
1+\
2+\
3+**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.
4+
5+## Kylix 3 Open Edition
6+
7+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.
8+
9+**NOTE**:\
10+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).
11+
12+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.
13+
14+There is another cross-platform GUI toolkit you can try with Free Pascal; it is called [[fpGUI|fpGUI Toolkit]].
15+
16+- Free Pascal: <https://www.freepascal.org>
17+- Lazarus: <https://lazarus-ide.org>
18+- fpGUI Toolkit: <https://sourceforge.net/projects/fpgui/>
19+
20+## Installing Kylix Help in the Lazarus IDE
21+
22+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.
23+
24+### Files needed from Kylix3
25+
26+These are the files and directories needed from the `${HOME}/kylix/help` directory.
27+
28+(I suspect that the help system from the free version of Kylix may work as well. )
29+
30+` bin/           k3clx.hlp     k3dbd.cnt    k3.hlp`\
31+` foo            k3.cnt        k3dbd.fts    k3indy.cnt`\
32+` foo~           k3copts.cnt   k3dbd.hlp    k3indy.fts`\
33+` hhintro.txt    k3copts.fts   k3dbx.cnt    k3indy.hlp`\
34+` hoh.cnt        k3copts.hlp   k3dbx.fts    k3iota.cnt`\
35+` hoh.fts        k3crtl.cnt    k3dbx.hlp    k3iota.fts`\
36+` hoh.hlp        k3crtl.fts    k3derrs.cnt  k3iota.hlp`\
37+` hyperhelp.sh*  k3crtl.hlp    k3derrs.fts  k3new.cnt`\
38+` k3.als         k3ctools.cnt  k3derrs.hlp  k3new.fts`\
39+` k3cerrs.cnt    k3ctools.fts  k3dlr.cnt    k3new.hlp`\
40+` k3cerrs.fts    k3ctools.hlp  k3dlr.fts    k3prog.cnt`\
41+` k3cerrs.hlp    k3cw.cnt      k3dlr.hlp    k3prog.fts`\
42+` k3clr.cnt      k3cw.fts      k3dopts.cnt  k3prog.hlp`\
43+` k3clr.fts      k3cw.hlp      k3dopts.fts  lib/`\
44+` k3clr.hlp      k3dap.cnt     k3dopts.hlp`\
45+` k3clx.cnt      k3dap.fts     k3.ftg`\
46+` k3clx.fts      k3dap.hlp     k3.fts`
47+
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.
49+
50+The bare minimum files needed for the context help are these:
51+
52+`bin/           k3.als     k3clx.fts  k3.cnt  k3.fts  lib/`\
53+`hyperhelp.sh*  k3clx.cnt  k3clx.hlp  k3.ftg  k3.hlp`
54+
55+### The hyperhelp.sh script
56+
57+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.
58+
59+``` bash
60+#!/bin/bash
61+HHHOME="${HOME}/Lazarus/DelphiHelp"
62+XPPATH="${HHHOME}/xprinter"
63+LANG=en_US
64+LC_ALL=en_US
65+locale=${LC_ALL:-${LC_CTYPE:-${LANG:-"C"
66+LD_LIBRARY_PATH+="lib/locale/"${locale}":lib:"
67+XAPPLRESDIR="app-defaults"
68+NLSPATH="lib/locale/%L/%N.cat"
69+export XPPATH HHHOME LANG LC_ALL LD_LIBRARY_PATH XAPPLRESDIR NLSPATH
70+cd $HHHOME
71+bin/hyperhelp k3clx.hlp -m AL\($1,3,,main\)\
72+ -s 0 -d 32159 -display :0.0 -geometry 600x500+100+100 -w
73+```
74+
75+### My directory tree
76+
77+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.
78+
79+ /home/tom/Lazarus/DelphiHelp/
80+ |-- bin
81+ `-- lib
82+ `-- locale
83+ |-- de_DE
84+ |-- fr_FR
85+ |-- ja_JP.SJIS
86+ |-- ja_JP.eucJP
87+ `-- ja_JP.eucjp
88+
89+### Custom Tool setup in IDE
90+
91+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.
92+
93+<figure>
94+<img src="edittool.png" title="edittool.png" />
95+<figcaption>edittool.png</figcaption>
96+</figure>
97+
98+### In summary
99+
100+Just place your cursor in the edit window on the word you want to find help for and press <span class="kbd">Ctrl</span>+<span class="kbd">F1</span>. The Kylix help will then open up the context sensitive help page for that keyword.
101+
102+---
103+*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).*

Back to history