BubblePad V 1.08 (c) Chris Wohlgemuth 1997-2011
-----------------------------------------------

Contenu
-------
0. Licence

1. Introduction

2. Installation

2b. Chanes de paramtrage

3. Dsinstallation

4. Utilisation

5. Compilation

6. Historique

7. Problmes connus

8. Auteur

9. Traductions

-----------------------------------------

0. Licence
----------
Cette distribution est fournie "telle quelle" sous 
licence de type BSD. 
Veuillez consulter le fichier 'License' pour plus 
d'informations. 


1. Introduction
---------------
Bienvenue sur BubblePad V 1.07, est une classe de 
remplacement pour le tableau de bord d'OS/2 Warp 3 et Warp 4. 
Cette nouvelle classe fournit des bulles d'aide pour tous les 
boutons du tableau de bord. Avec cette fonction il est alors 
possible de distinguer sur le tableau de bord chacun des 40 
dossiers du qui prsentent tous les mmes icnes. Vous ne 
cliquerez plus jamais sur le mauvais bouton. 
De plus, la classe permet de rduire sa taille du tableau de 
bord en rduisant la distance entre les boutons ainsi que la 
taille des bordures. 

NOUVEAU avec la V1.02 : 
La nouveaut de cette version est l'option permettant de 
retirer les boutons de tiroirs. Des paramtrages individuels 
pour des tableaux de bord diffrents sont maintenant 
possibles. Plus de clignotement  l'ouverture des tiroirs. 
L'tat des tiroirs est sauvegard  l'arrt du systme. 
Rouverture au lancement du systme. 

NOUVEAU avec la V1.03 : 
Voir le fichier Historique. 

(La V1.04 n'a jamais t distribue au grand public)

NOUVEAU avec les V1.05 et suprieures :
Voir le fichier Historique. 

Une aide en ligne complte est fournie, mais je ne pense pas 
que vous en ayez rellement besoin. 
Toutes les fonctionnalits sont slectionnables; 

La distribution contient les versions allemande, anglaise et 
franaise de la DLL et du fichier d'aide. Vous pouvez traduire 
le fichier de ressource et les chanes de texte du fichier 
'inst.cpp' et le compiler. 
Si vous me faites parvenir les traduction, je les rassemblerai 
et mes compilerai dans une nouvelle distribution. 

Vous pouvez trouver BubblePad sur ces pages WWW : 

   http://svn.netlabs.org/bubblepad


2. Installation
---------------
Dcompressez les fichiers dans un dossier de votre choix,
mais assurez-vous de conserver la structure des rpertoires ! 

La distribution contient les fichiers suivants : 

G:\svn-sources\bubblepad\trunk\bubblepad_v108.txt
G:\svn-sources\bubblepad\trunk\FILE_ID.DIZ               courte description du programme
G:\svn-sources\bubblepad\trunk\install.CMD               script d'installation
G:\svn-sources\bubblepad\trunk\LisezMoi                  ce que vous tes en train de faire
G:\svn-sources\bubblepad\trunk\README                    fichier LiserMoi en anglais
G:\svn-sources\bubblepad\trunk\uninstall.CMD             script de dsinstallation
G:\svn-sources\bubblepad\trunk\bin\lpreplace.exe         Utilitaire pour remplacer WPLaunchPad
G:\svn-sources\bubblepad\trunk\Deutsch\bubblepd.dll
G:\svn-sources\bubblepad\trunk\Deutsch\bubblepd.hlp         
G:\svn-sources\bubblepad\trunk\Docs\CHANGES              Historique des versions en anglais
G:\svn-sources\bubblepad\trunk\Docs\Historique           Historique des versions en franais
G:\svn-sources\bubblepad\trunk\Docs\License
G:\svn-sources\bubblepad\trunk\English\bubblepd.dll
G:\svn-sources\bubblepad\trunk\English\bubblepd.hlp
G:\svn-sources\bubblepad\trunk\Francais\bubblepd.dll
G:\svn-sources\bubblepad\trunk\Francais\bubblepd.hlp
G:\svn-sources\bubblepad\trunk\Nederlands\bubblepd.dll
G:\svn-sources\bubblepad\trunk\Nederlands\bubblepd.hlp
G:\svn-sources\bubblepad\trunk\SOURCE\c
G:\svn-sources\bubblepad\trunk\SOURCE\hlp
G:\svn-sources\bubblepad\trunk\SOURCE\idl
G:\svn-sources\bubblepad\trunk\SOURCE\include
G:\svn-sources\bubblepad\trunk\SOURCE\obj
G:\svn-sources\bubblepad\trunk\SOURCE\BUBBLEPD.ICO
G:\svn-sources\bubblepad\trunk\SOURCE\DEUTSCH.RC
G:\svn-sources\bubblepad\trunk\SOURCE\ENGLISH.RC
G:\svn-sources\bubblepad\trunk\SOURCE\FRENCH.RC
G:\svn-sources\bubblepad\trunk\SOURCE\makefile
G:\svn-sources\bubblepad\trunk\SOURCE\nederlands.RC
G:\svn-sources\bubblepad\trunk\SOURCE\swedish.rc
G:\svn-sources\bubblepad\trunk\SOURCE\template.ICO
G:\svn-sources\bubblepad\trunk\SOURCE\c\bubblepd.c
G:\svn-sources\bubblepad\trunk\SOURCE\c\BUBBLEPD.DEF
G:\svn-sources\bubblepad\trunk\SOURCE\c\lpreplace.cpp
G:\svn-sources\bubblepad\trunk\SOURCE\c\makefile
G:\svn-sources\bubblepad\trunk\SOURCE\c\misc_funcs.c
G:\svn-sources\bubblepad\trunk\SOURCE\hlp\bubblepddeutsch.ipf
G:\svn-sources\bubblepad\trunk\SOURCE\hlp\bubblepdenglish.ipf
G:\svn-sources\bubblepad\trunk\SOURCE\hlp\bubblepdfrench.ipf
G:\svn-sources\bubblepad\trunk\SOURCE\hlp\bubblepdnederlands.ipf
G:\svn-sources\bubblepad\trunk\SOURCE\hlp\bubblepdswedish.ipf
G:\svn-sources\bubblepad\trunk\SOURCE\idl\bubblepd.idl
G:\svn-sources\bubblepad\trunk\SOURCE\include\bubblepadres.h
G:\svn-sources\bubblepad\trunk\SOURCE\include\defines.h
G:\svn-sources\bubblepad\trunk\Svenska\bubblepd.dll
G:\svn-sources\bubblepad\trunk\Svenska\bubblepd.hlp


AVANT TOUTE CHOSE, EFFECTUEZ UNE COPIE DE SAUVEGARDE DE VOS 
FICHIERS INI !!! 
Je ne pense pas que cela soit rellement ncessaire, mais lors
de l'installation le programme enregistre des nouvelles classes WPS 
et c'est toujours une bonne ide de conserver une sauvegarde des 
fichiers INI si quelque chose tourne mal. Vous le savez bien : Murphy 
ne se repose jamais... 

Si vous avec une version prcdente de BubblePad installe, 
dsinstallez-la en premier lieu puis relancez le bureau lectronique. 

Dplacez le rpertoire avec le contenu de l'archive vers l'emplacement 
adquat. Aprs l'installation, ce rpertoire NE pourra PLUS tre dplac 
puisque le bureau lectronique verrouille la DLL de classe de BubblePad. 
Lancez le script d'installation 'install.cmd'. 
Aprs l'enregistrement de la nouvelle classe et le remplacement de la 
classe originale de tableau de bord, vous devez relancer le bureau 
lectronique de manire  ce que les modifications prennent effet. 

Si vous voulez effectuer une installation personnalise, vous pouvez 
utiliser REXX avec des chanes de paramtrage pour les fonctionnalits de 
BubblePad. Veuillez vous rfrer  la section 2b pour plus 
d'informations  propos des chanes de paramtrage prises en charge. 


2b. Chanes de paramtrage
--------------------------
Avec la version 1.03, les chanes de paramtrage sont prises en charge 
pour les fonctionnalits de BubblePad afin de permettre l'installation 
automatique en utilisant REXX. 

Les chanes de paramtrage suivantes sont proposes : 

LPNODRAWERS=1

   Cache les boutons de tiroirs. Non cachs par dfaut. 

LPSMALL=0

   Dsactive le redimensionnement du tableau de bord. 
   Avec cette option LPNODRAWERS n'a pas d'effet. 
   Si omise, l'option est ACTIVE par dfaut. 

LPDISTANCE=4-18                  

   Choix de la distance entre les boutons sur le tableau de bord. 
   La valeur par dfaut est 4. 

LPREOPENDRAWERS=1

   Pour dfinir si les tiroirs sont rouverts au prochain 
   lancement du systme. L'option est dsactive par dfaut. 

LPACTIONBUTTONS=1+2+4+8
       
   Activation de chaque bouton d'action. La valeur de la cl est 
   calcule en ajoutant les valeurs des boutons d'action : 

   Arrt.............: 1
   Verrouillage......: 2
   Liste de fentres.: 4
   Recherche.........: 8

   Exemple :
            Si vous voulez activer les boutons de verrouillage 
            et de recherche, utilisez LPACTIONBUTTONS=10 
            (la cl est dcimale !). 

   Tous les boutons d'action sont activs par dfaut. 

LPBUBBLE=0

   Dsactivation des bulles d'aide. L'option est active par dfaut. 

LPDELAY=0-9999

   Dlai d'affichage pour la fentre d'aide. Choisir une valeur entre 
   0 et 9999ms. La valeur par dfaut est 250ms. 
 
LPBGCOLOR=RVB

   Choix de la couleur d'arrire-plan de la fentre d'aide. 
   La valeur est calcule de la manire suivante (Rouge, Vert et Bleu) : 

   LPBGCOLOR=65536*R+256*V+B

   Assurez-vous d'utiliser des valeurs dcimales. 
   Jaune ple par dfaut. 

LPFGCOLOR=RVB

   Choix de la couleur du texte pour la fentre d'aide. 
   La valeur est calcule de la manire suivante (Rouge, Vert et Bleu) : 

   LPFGCOLOR=65536*R+256*V+B

   Be sure to use a decimal value. 
   Noir par dfaut. 


Voici un exemple d'utilisation de chanes de paramtrage : 

------------------------------------------------
/* rexx - cration de BubblePad */

call RxFuncAdd 'SysCreateObject','RexxUtil', 'SysCreateObject'

IF SYSCreateObject("WPLnchCW","Setup-Test","<WP_DESKTOP>","LPACTIONBUTTONS=8;LPNODRAWERS=1;LPREOPENDRAWERS=1","replace") THEN
   Say 'OK. Votre nouveau tableau de bord a t cr. '
------------------------------------------------

Cet exemple cre un nouveau BubblePad avec uniquement le bouton de 
recherche. Les boutons de tiroirs sont cachs et les tiroirs sont 
rouvert au prochain lancement du systme. 
Ce script fonctionne mme si vous n'avez pas remplac la classe 
WPLaunchPad par celle de BubblePad WPLnchCW. Si le remplacement 
est effectu, vous pouvez utiliser WPLaunchPad comme nom de classe. 


3. Dsinstallation
------------------
Lancez le script de dsinstallation (uninstall.CMD). 
Le script rtablit WPLaunchPad et dsenregistre la classe. 
Vous devez ramorcer le systme pour achever la dsinstallation. 


4. Utilisation
--------------
La nouvelle classe insre quatre pages dans le bloc-notes des 
paramtres. Deux pages sont ddies  la personnalisation des 
bulles d'aide. Il est possible d'y choisir les couleurs de la 
bulle et de la police, ainsi que la police elle-mme. Le dlai 
est aussi modifiable. La modification des couleurs et police 
est faite en utilisant les palettes de couleur et de police 
du dossier "Configuration du systme". Vous pouvez les ouvrir 
directement depuis le bloc-notes des paramtres en cliquant sur 
les boutons appropris. 
Sur la troisime page d'options, vous pouvez dsactiver chaque 
bouton d'action. 
Une autre page d'options vous permet de choisir si vous voulez 
rduire la taille du tableau de bord et/ou ajuster la distance 
entre les boutons. 
Vous avez une otpion pour retire les boutons de tiroirs depuis 
les versions 1.02 et suprieures. Tous les paramtres sont 
individuels pour chaque tableau de bord du systme. 

Une aide en ligne complte est fournie pour chacune des nouvelles 
pages d'option. 


5. Compilation
------------
Le code source complet est fourni dans cette distribution. Pour 
la compilation de la classe de remplacement, vous aurez besoin de 
VAC++3.08 et du Toolkit de Warp 3 (tous les deux des produits 
commerciaux d'IBM). D'autres compilateurs C peuvent fonctionner 
mais le Toolkit est tout de mme requis  cause du compilateur 
SOM. 
Vous aurez en outre besoin de GNU make et des utilitaires de fichiers 
GNU (Gnu file utilities) pour rm.exe. 
Vous aurez peut-tre aussi besoin d'un shell compatible unix tel que 
ash.exe, ksh.exe ou bash. 

Il est suppos ici que le compilateur est correctement install. 

1. CD dans le rpertoire des sources, 
4. lancez 'make' - l'utilitaire Gnu make - et c'est tout. 

Lancez 'make clean' dans le rpertoire source pour supprimer tous les 
fichiers temporaires. 


6. Historique
-------------
Voir le fichier 'Historique'. 


7. Problmes connus
-------------------
Avec OS/2 Warp 4 (sans correctif), le WPS ne se charge parfois pas. 
Il charge le papier-peint et s'arrte avec le pointeur horloge. 
C'est le mme problme connu que pour le Warpcenter. Essayez d'appliquer 
un correctif pour rsoudre le problme du Warpcenter ou pour contourner 
ce problme, ajoutez la ligne SET RESTARTOBJECTS=NO dans votre fichier 
CONFIG.SYS. Et retirez l'occurence LAUNCHPAD de la ligne AUTOSTART. 

L'tat des tiroirs ouverts n'est sauvegard qu' l'arrt du systme. 
Les tiroirs ne sont donc pas rouverts lorsque le tableau de bord est 
ferm puis rouvert. 

L'affichage des modles sur le tableau de bord n'est pas encore parfait. 
Des clignotements peuvent se produire. 


8. Auteur
---------
(c) Chris Wohlgemuth 1997-2011

Vous pouvez trouver BubblePad sur les pages WWW suivantes : 

   http://svn.netlabs.org/bubblepad


Si vous m'envoyez vos amliorations ou traductions, je les incorporerai 
dans le prochaine distribution. 

9. Traductions
--------------
Traduction franaise ralise par Guillaume Gay <guillaume.gay@bigfoot.com>. 

