| 1 |
Contribute to Fvwm-Crystal |
| 2 |
-------------------------- |
| 3 |
|
| 4 |
I would not have learned FVWM without FVWM-crystal. |
| 5 |
Its modular file structure made possible to concentrate |
| 6 |
only on a given task. With time, FVWM_Crystal has grow to |
| 7 |
a big project, and it is many files and many functions. |
| 8 |
In order to easily find where is a given function, you |
| 9 |
can use searchstring in the addons directory. It help me |
| 10 |
a lot even after years with FVWM-Crystal. |
| 11 |
|
| 12 |
And yes, FVWM is fun. I begun the Amiga recipe as a wink, and at |
| 13 |
the end, the Fullscreen function have been fixed and extended |
| 14 |
with the Disappear function, which make one of the best feature |
| 15 |
of the Amiga OS, its unique (?) ability to cycle trough full- |
| 16 |
screened windows and the workbench, available in all the |
| 17 |
recipes of FVWM-Crystal. |
| 18 |
|
| 19 |
You are welcomed to contribute to anything you can think about. |
| 20 |
This include but is not limited to translations, new recipes, |
| 21 |
improvement and bug fixes of existing functions, and of |
| 22 |
course new functions, new decorations, new colorsets, |
| 23 |
new pixmaps, whatever. |
| 24 |
|
| 25 |
In order to get the big picture of how Fvwm-Crystal is working, |
| 26 |
you must understand the loading order of the files. |
| 27 |
That is not that hard, the first file FVWM will read is |
| 28 |
fvwm/config |
| 29 |
|
| 30 |
This file will setup some needed environment variables, load the |
| 31 |
recipe and last, read the userconfig file. |
| 32 |
|
| 33 |
Another important file to considere is the recipe file. |
| 34 |
The order of the Includes at the beginning is important. |
| 35 |
If you are not sure, look in another recipe. |
| 36 |
|
| 37 |
In fact, the big picture is important mostly for the loading order |
| 38 |
of the files. Otherwise, searchstring is your friend. |
| 39 |
|
| 40 |
Of course, you will need to RTFM. I use the man pages from FVWM |
| 41 |
website in their stable version: |
| 42 |
http://www.fvwm.org/documentation/manpages/stable/ |
| 43 |
|
| 44 |
Use them for 3 raisons: |
| 45 |
1) they are in html |
| 46 |
2) the unstable version is outdated |
| 47 |
3) I want FVWM-Crystal to be compatible with the last released |
| 48 |
FVWM version. So use it with FVWM-Crystal even if you |
| 49 |
are using the cvs version of FVWM. |
| 50 |
|
| 51 |
To send your contrinutions, the prefered ways are the email list: |
| 52 |
https://mail.gna.org/listinfo/fvwm-crystal-users/ or an email |
| 53 |
to my sourceforge account: [email protected] |
| 54 |
|
| 55 |
Support questions should be send exclusively to the email list. |
| 56 |
By support questions, I also mean questions about the internal |
| 57 |
of FVWM_Crystal and help with developping. |
| 58 |
|
| 59 |
Have fun ! |
| 60 |
Dominique |