| 1 |
FahMon README |
|---|
| 2 |
|
|---|
| 3 |
Version @PACKAGE_VERSION@ |
|---|
| 4 |
|
|---|
| 5 |
Authors: |
|---|
| 6 |
======== |
|---|
| 7 |
François Ingelrest |
|---|
| 8 |
Andrew Schofield |
|---|
| 9 |
|
|---|
| 10 |
Copyright: |
|---|
| 11 |
========== |
|---|
| 12 |
© François Ingelrest 2003-7 |
|---|
| 13 |
© Andrew Schofield 2007-10 |
|---|
| 14 |
|
|---|
| 15 |
For further details see AUTHORS and THANKS |
|---|
| 16 |
|
|---|
| 17 |
Licence: |
|---|
| 18 |
======== |
|---|
| 19 |
FahMon is free software. Please see the file COPYING for details. |
|---|
| 20 |
|
|---|
| 21 |
About: |
|---|
| 22 |
====== |
|---|
| 23 |
FahMon is an open-source tool (GPL license) that allows you to quickly check the |
|---|
| 24 |
progress of your Folding@Home client (or clients if you have multiple ones), |
|---|
| 25 |
avoiding you having to open different files and/or to go to the Internet (for |
|---|
| 26 |
example to know how much your current work unit is worth). Other monitoring |
|---|
| 27 |
tools exist (such as Electron Microscope or FahLogStats), so if you don't like |
|---|
| 28 |
FahMon, have a look at them! |
|---|
| 29 |
|
|---|
| 30 |
FahMon is entirely coded in C++ and uses the wxWidgets library, which allows |
|---|
| 31 |
FahMon to exist both for Linux and Windows. It is designed to be really easy to |
|---|
| 32 |
use, and you should thus not encounter any major problem. |
|---|
| 33 |
|
|---|
| 34 |
For a complete version history, please see the ChangeLog file. |
|---|
| 35 |
|
|---|
| 36 |
New in this release: |
|---|
| 37 |
==================== |
|---|
| 38 |
To see what's new in this release, please read the NEWS and ChangeLog files. |
|---|
| 39 |
|
|---|
| 40 |
System requirements: |
|---|
| 41 |
==================== |
|---|
| 42 |
Windows - Any machine capable of running Windows 2000 or later. |
|---|
| 43 |
Linux - Any machine capable of running a modern X server. |
|---|
| 44 |
Broadly speaking any machine you are likely to want to run FahMon on will be |
|---|
| 45 |
sufficient. |
|---|
| 46 |
|
|---|
| 47 |
Software requirements: |
|---|
| 48 |
====================== |
|---|
| 49 |
For additional software requirements see the REQUIRES file. |
|---|
| 50 |
|
|---|
| 51 |
Installations instructions: |
|---|
| 52 |
=========================== |
|---|
| 53 |
Please see the INSTALL file. |
|---|
| 54 |
|
|---|
| 55 |
Contact details: |
|---|
| 56 |
================ |
|---|
| 57 |
Website: http://fahmon.net/ |
|---|
| 58 |
Support site: http://trac.fahmon.net/ |
|---|
| 59 |
email: andrew_s@fahmon.net |
|---|
| 60 |
|
|---|
| 61 |
Translations |
|---|
| 62 |
============ |
|---|
| 63 |
The translations provided with FahMon should work with no user intervention on |
|---|
| 64 |
both Linux and MS Windows provided they were installed correctly. |
|---|
| 65 |
|
|---|
| 66 |
Editing existing translations |
|---|
| 67 |
============================= |
|---|
| 68 |
To edit existing translations, you can open the relevant .po file in your |
|---|
| 69 |
gettext catalog editor (see REQUIRES) and start modifying the strings. On Linux, |
|---|
| 70 |
these can be found in the po directory of the installation source, on MS |
|---|
| 71 |
Windows, these can be found in the lang folder. Once you are happy with the |
|---|
| 72 |
translations you have edited, you need to install them. |
|---|
| 73 |
|
|---|
| 74 |
To install an edited translation on Linux, simply run "make update-gmo" then |
|---|
| 75 |
"make install" (as root or sudo). This will compile the translation to a binary |
|---|
| 76 |
file and install it into the relevant location. |
|---|
| 77 |
|
|---|
| 78 |
To install the edited transltaion on MS Windows, you need to get you gettext |
|---|
| 79 |
catalog editor to save a .mo file (poEdit wil do this). Save the file as |
|---|
| 80 |
fahmon.mo into the relevant folder under the "lang" folder. |
|---|
| 81 |
|
|---|
| 82 |
Restart FahMon and your new translations should appear. |
|---|
| 83 |
|
|---|
| 84 |
Creating new translations |
|---|
| 85 |
========================= |
|---|
| 86 |
Make sure you have read the REQUIRES file. |
|---|
| 87 |
|
|---|
| 88 |
Make sure you know the language code for your new translation (combine the two |
|---|
| 89 |
letter language code from ISO 639-1 with the two letter country code from ISO |
|---|
| 90 |
3166. See the existing translations for examples). |
|---|
| 91 |
|
|---|
| 92 |
On Linux, copy fahmon.pot in the po folder, to 'your_translation_name'.po and |
|---|
| 93 |
start editing. After saving your translation, open up configure.ac in the source |
|---|
| 94 |
root directory, and navigate down to "ALL_LINGUAS" and add your new translation |
|---|
| 95 |
to the list. |
|---|
| 96 |
Run ./reconf; ./configure; make update-gmo; make install to add your new |
|---|
| 97 |
translation. (This should not force a recompile of fahmon itself, unless you |
|---|
| 98 |
passed different options to configure). |
|---|
| 99 |
|
|---|
| 100 |
On Windows, make a folder under 'lang' with the name of your translation and |
|---|
| 101 |
copy fahmon.pot into it. Rename this to a .po file and start editing it. Once |
|---|
| 102 |
finished, save the .mo file as fahmon.mo and restart FahMon. |
|---|
| 103 |
|
|---|
| 104 |
Once you've created translations, please create a support ticket using trac: |
|---|
| 105 |
http://trac.fahmon.net/ and attach your new .po file. |
|---|
| 106 |
Alternatively, email the .po file to andrew_s@fahmon.net |
|---|
