NewView
-------

Le projet NewView et hberg sur le TRAC de Netlabs :
http://trac.netlabs.org/newview


Copyright (C) 1999-2005 Aaron Lawrence
et Copyright (C) 2006-2019 Aaron Lawrence
avec des contributions supplmentaires (C) 2019-2023 Alexander Taylor

NewView est une alternative gratuite au systme d'aide en ligne de OS/2.

Les principales amliorations sont :

- Une nouvelle interface utilisateur (Visualisation partage)
- Slection et copie directes depuis la fentre
- Recherche globale (dans tous les fichiers) facile  utiliser
- Sauvegarde des taille et position
- Liste des fichiers rcemment utiliss
- Dfilement fluide
- Section en cours toujours mise en vidence dans le contenu
- Navigation en avant comme en arrire dans l'historique
- Paramtrage des polices, couleurs et plus
- Annotation des fichiers d'aide
- Signets
- Compltement redimensionnable
- Liens WWW, FTP et Ml automatiques (utilisation du navigateur dfini
  par dfaut dans le WPS)
- Dpose de fichiers pour les ouvrir
- Ouverture de fichiers supplmentaires
- Slection automatique de la langue
- Cration automatique de l'index
- Bote de dialogue amliore avec titres des fichiers d'aide

Pour un historique des versions, veuillez vous rfrer au fichier
"changes.txt".


Installation (archive ZIP))
---------------------------

Si vous avez tlcharg l'archive de distribution ZIP de NewViewJe vous
suggre d'utiliser le fichier install.exe fourni avec NewView. C

L'installateur vous propose aussi l'option d'installer NewView comme une
application autonome, ou comme remplacement de View uniquement. Avec une
installation en mode autonome vous aurez toujours l'option d'associer
NewView aux fichiers d'aide.
Vous noterez cependant que cela NE fera PAS en sorte que NewView soit
utilis pour les nombreuses icnes d'aide installes par les diverses
applications, puisqu'il s'agit le plus souvent d'objets programmes qui
font directement rfrence  "View.exe".

Pour une mise  jour du produit, installez juste cette version par-dessus
l'existant, mais vrifiez changes.txt pour voir s'il n'y aurait pas de
remarques particulires  propos de la nouvelle version.

eComStation v1.1 est dj livr avec une version de NewView (l'afficheur
en mode autonome, pas en remplacement complet). L'outil de maintenance
d'eCS (eCS Maintenance Tool) ne le met pas  jour, mais l'installateur de
NewView est suffisamment intelligent pour mettre  jour correctement la
copie de NewView dans eCS.

Un ramorage sera ncessaire pour un remplacement complet, mme lors
d'une mise  jour.

Aprs un remplacement complet, vous aurez toujours accs  l'ancien
afficheur : utilisez IBMVIEW <NomDeFichier>.

Les informations au sujet de l'installation manuelle sont donnes au
chapitre "Informations techniques" ci-dessous.


Dsinstallation (paquetage WPI))
--------------------------------

Si vous l'avez install via WarpIn, utilisez n'interface graphique de
WarpIN pour dsinstaller les paquetages NewView\Core, NewView\Help et
NewView\ReadMe.

Si vous l'avez install depuis l'&archive ZIP, il n'y a pas de
dsinstallateur. Vous devrez copier les fichiers sauvegards (.bak si
vous avez utilis 'install.exe') vers leurs noms de fichiers originaux,
vous devrez utiliser unlock/replmod pour remplacer 'HelpMgr.dll' ou
amorer le systme en ligne de commandes. Plus prcisment, vous devrez
restaurer 'x:\os2\dll\helpmgr.dll', 'x:\os2\view.exe' et
'x:\os2\viewdoc.exe'.


Problmes
---------

Si vous deviez reporter un plantage ou autre problme, soyez alors aussi
prcis que possible quant aux fichiers qui taient utiliss, sur ce que
vous faisiez, etc.. S'il est disponible, vous tes PRI(E) d'inclure le
fichier 'newview.log'. Ce fichier de rapport se trouve SOIT
 - dans le mme rpertoire que celui de NewView, OU
 - dans le dossier dfini dans la variable d'environnement LOGFILES
   (dans le cas de eCS version 1.1 eou ArcaOS).

Il pourrait aussi tre utile de lancer NewView avec l'argument /profile
(non document) et de m'envoyer le fichier newview.prf rsultant, en
particulier s'il n'y a pas de fichier 'newview.log' !

- Problme avec des applications systme modale et "toujours en
  avant-plan"

  Lorsque l'aide est ouverte depuis une application de type systme
  modale ou qui prsente la proprit "toujours en avant-plan"
  (WS_TOPMOST), NewView se retrouvera bloqu derrire la fentre de
  l'application. Des solutions possiblepour cette situation sont toujours
  en cours d'investigation.

- Le texte du presse-papiers est tronqu

  La copie d'une quantit signifiante de texte (en gnral plusieurs
  lignes) vers le presse-papiers peut rsulter en texte amput des
  derniers caractres/lignes de la slection. La cause de ceci est
  toujours en cours d'investigation.

- Espace des icones minimises de taille anormale

  Si le WPS est paramtr pour la rducion des icnes sur le  bureau,
  la tentative de dplacement de NewView alors qu'il est rduit engendrera
  une icone prenant un espace de 200x200 pixels autour d'elle. C'est
  purement cosmtique.

- L'installation ne se lance pas

  'renmodul.dll' doit tre accessible. Normalement cela devrait
  fonctionner si vous lancez l'installation depuis le mme rpertoire et
  que "." figure dans la variable d'environnement LIBPATH.

- F1 fait planter l'application (installation complte)

  Bien qu'il soit toujours possible que cela provienne de NewView (en
  fait, mon fichier 'helpmgr.dll' de substitution), il y a(vait) un
  problme avec la bibliothque de Widgets de XWorkPlace, plus
  spcifiquement avec 'rbutton.dll' ou 'rgauge.dll'; la dsactivation du
  XCenter vitera ce problme. Je ne sais pas si un correctif est
  disponible.

- Avertissement sur des fichiers dupliqus

  L'installateur vous avertit si des programmes ou des fichiers d'aide de
  NewView sont dupliqus sur votre systme. Si vous tes au courant de
  l'existence de tels doublons et que c'est normal (vous avez par exemple
  organis les chemins de la variable d'environnement PATH pour ne pas
  que cela pose problme), vous pouvez alors ignorer l'avertissement. Les
  raisons principales pour lesquelles vous pourriez rencontrer un tel
  problme :
  - vous avez dj install le produit dans un rpertoire diffrent,
  - vous effectuez une installation en mode autonome sur eCS v1.1. Ce
    problme ne devrait pas se produire avec une installation complte;
    dans ce cas, l'installateur mettra  jour lers fichiers dans eCS.

  Vous pouvez soit supprimer les doublons, soit installer les nouveaux
  fichiers par-dessus les anciens, comme vous voulez.

- ViewHelp reste indfiniment ouvert

  Si vous utilisez l'ancien programme 'viewhelp.exe', par exemple 
  travers   les   icnes d'aide pour TCP/IP, vous noterez alors que
  viewhelp reste ouvert aprs avoir ferm la fenetre d'aide. C'est d au
  fait qu'il utilise des fonctions de helpmgr que NewView ne prend pas en
  charge. Cependant, il ne semble pas fournir quelques fonctionnalits
  utiles au-del de lui-mme, donc, pour contourner du problme : copiez
  'view.exe' par dessus 'viewhelp.exe' et le tour est jou.

- Le programme d'application de correctifs d'IBM (service.exe) ne
  fonctionne pas

  Ceci a t corrig dans la version 2.13.4.

- Modification de la police de l'application

  Si vous modifiez la fonte de l'application, que ce soit depuis
  "Outils" / "Options..." / "Polices" ou par Glisser/Dposer d'une police
  sur la fentre principale, vous devrez alors relancer l'application
  pour que toutes ses parties utilisent la nouvelle police.
  Remarque : si vous dposez une police sur le panneau de droite dans
  lequel les sections d'aide sont affiches, cela modifie seulement la
  police de la section, diffrente de celle de l'application. Appuyez sur
  la touche Maj pendant que vous dposez la police afin de modifier la
  police  chasse fixe.

- Polices et couleurs ne sont pas toujours conformes

  Certains fichiers d'aide spcifient leurs propres polices et/ou
  couleurs, auquel cas les valeurs par dfaut que vous avez slectionnes
  sont ignores, soit partiellement, soit totalement.

- IBM BookManager Reader ne fonctionne pas

  Encore une rinvention de la roue par IBM. Je ne comprends pas comment
  il utilise helpmgr et ne peux donc pas le prendre en charge.

- La bote de dialogue des paramtres d'impression a l'air bizarre

  La bote de dialogue de l'imprimante prsente un arrire-plan blanc et
  le numro de version affiche ???. Je n'ai aucune ide de ce  quoi
  c'est d, et, oui, j'ai recherch, donc je vous prie de ne plus m'en
  parler  moins d'apporter une suggestion prcise. Cela ne semble pas
  les choses de fonctionner correctement, donc c'est plac en priorit
  extrmement basse.

- La bote de dialogue des paramtres d'impression ne fonctionne pas

  Certaines botes de dialogue de paramtres d'impression ne fonctionnent
  pas, mais je n'ai aucune ide de ce  quoi c'est d. L'API pour
  l'impression d'OS/2 n'est pas si bien dssine que a, il est donc
  assez difficile de travailler avec.

- Aprs avoir compltement remplac le systme d'aide, le tutoriel d'OS/2 ne fonctionne plus

  Il y a peu de chance pour que ce soit corrig dans un futur proche
  puisqu'il ne fait pas partie des distribution rcentes d'OS/2, et il
  utilise un tas de fonctionnalits obscures.

- Les icnes Glossaire et Index du dossier Centre d'assistance ne
  fonctionnent pas

  Il y a peu de chance pour que ce soit compltement corrig. Cependant,
  cela ne plante plus le bureau. Personnellement, je trouve que la
  recherche globale est plus utile ("Outils" / "Rechercher tous les
  fichiers d'aide").

- L'aide d'EPM a des problmes

  Cela a t corrig dans la version 2.7 de NewView et ultrieures,
  puisque 'View.exe' est  prsent un "stub" qui se ferme immdiatement,
  comme l'original.
  Remarque : si vous effectuez une installation en mode autonome de
  NewView, mais que vous voulez tout de mme l'utiliser comme aide d'epm,
  vous devrez mettre  jour les fichiers .NDX d'EPM qui contiennent le
  programme d'aide  lancer.

- Les notes ne sont pas toujours prvisibles

  Elles ne se retrouveront pas exactement  la mme position  la mise en
  vidence des mots recherchs ou lorsque le fichier d'aide est mis 
  jour. Ces notes semblent cependant toujours tre utiles et c'est un
  problme plutt difficile  corriger, je laisserai donc probablement
  tout cela en l'tat.

- Conflit avec Styler/2 (SmartWindows)

  Cela a t corrig depuis la version 1.6.5.1 de Styler/2 et
  ultrieures. Avant a : si vous utilisiez l'lment "fentres
  agrandies" ("maximised windows"), les fentres de section de NewView
  taient alors aussi agrandies et pouvaient tre ainsi trop larges pour
  la lecture. Solution de contournement : il suffisait d'ajouter
  'view.exe' et/ou 'newview.exe' dans la liste des "exceptions" des
  prfrences de Styler/2.

- Ouverture impossible de fichiers avec des noms comportant des espaces
  depuis le bureau

  Assurez-vous que l'objet programme de NewView a SOIT
  . aucun paramtre, SOIT
  . le champ des paramtres contenant "%*" (avec les guillemets) et non
    pas juste %* (sans les guillemets).

- Impossible de lancer l'ancien afficheur

  Je vous recommande d'utiliser l'installation en remplacement complet,
  mais si vous ne le faites pas et que cela fiche le bazar, pour faire en
  sorte que l'ancien view fonctionne :
   1) obtenez une copie du view original d'IBM (avec un peu de chance
      dans une sauvegarde prcdente) et copiez-le dans
      'x:\os2\ibmview.exe' (o x: est l'unit d'amorage).
   2) Tlchargez renmodul depuis Hobbes et placez-le quelquepart dans un
      des chemins figurant dans la variable PATH.
   3) Dans une fentre de ligne de commandes, placez-vous dans le
      rpertoire 'x:\os2'.
   4) Tapez la commande "renmodul /i ibmview.exe helpmgr ibmhmgr" (sans
      les guillemets).
  (par Bertie Kemp)


Licence
-------

Depuis la version 1.27.9, NewView est un logiciel Open Source distribu
sous licence publique GNU (GNU Public License ou GPL), ce qui signifie
(veuillez vous rfrer au fichier GPL.txt pour plus de dtails) :

Ce programme est gratuit; vous pouvez le redistribuer et/ou le modifier
selon les termes de la licence publique GNU telle qu'elle a t publie
par la Free Software Foundation, dans sa version 2, ou ultrieure (
votre guise).

Ce programme est distribu dans l'espoir d'tre utile, mais SANS AUCUNE
GARANTIE, sans mme la garantie implicite de COMMERCIALISATION ou
d'adquation  un BUT PARTICULIER. Veuillez vous rfrer  la licence
publique GNU pour plus de dtails.

Vous devriez avoir reu une copie de la licence publique GNU avec ce
programme. Dans le cas contraire, crivez 
  Free Software Foundation, Inc.
  59 Temple Place - Suite 330
  Boston, MA  02111-1307, USA

Si vous voulez encourager  continuer les dveloppements futurs de
NewView, vous pouvez alors utiliser PayPal (http://www.paypal.com) ou
similaire pour envoyer un don !


Support multilingue
-------------------

NewView peut charger diffrentes langues ainsi que des fichiers d'aide de
langues diffrentes (depuis la version 2.1.4) pour son interface
utilisateur.

Il recherche un fichier dans son propre dossier.
Le nom de fichier dbute par 'newview_' et porte l'extension '.lng'.
Le fichier particulier lanc est fonction de la variable
d'environnement LANG dfinie dans le systme. Par exemple sur les
systmes US, c'est LANG=EN_US et c'est donc newview__en_us.lng qui sera
recherch. S'il est introuvable, c'est la partie principale de la
variable LANG qui sera utilise pour la recherche, dans notre
exemple : newview_en.lng. Sinon, c'est l'anglais US qui est utilis par
dfaut. Cette langue est intgre dans l'excutable et vous devrez
relancer le programme pour l'obtenir.

Normalement, les traductions ne sont pas destines  une rgion
particulire, ainsi, les fichiers fournis avec NewView sont de la forme
(par exemple) newview_es.lng pour l'espagnol, et non pas
newview_es_es.lng.

Vous pouvez forcer la langue utilise en utilisant l'argument
/lang:<XX>, ou XX et la langue alternative  utiliser.

- O les fichiers de langue se trouvent-ils ?

  Les fichiers de langues sont recherchs (dans l'ordre) dans :
    - %OSDIR%\lang  (eCS 1.1 et +),
    - %ULSPATH%,
    - le rpertoire de l'application.

- Cration d'un nouveau fichier de langue

  Vous pouvez facilement crer un fichier de traduction pour NewView.
  Utilisez "Outils" / "Sauver vers fichier de langue..." pour crer un
  nouveau fichier .lng. Ce fichier .lng contiendra tous les lments de
  texte employs par le programme. Traduisez les chanes de texte (entre
  guillemets) et sauvegardez le fichier.

  Vous pouvez nommer le fichier .lng comme vous voulez, mais suivez les
  rgles donnes ci-dessus si vous voulez qu'il soit automatiquement
  charg.

  Si vous m'envoyez vos traductions, je les incluerai dans les prochaines
  versions. Pour vous conomiser du temps, demandez-moi avant de
  commencer une traduction au cas o quelqu'un en aurait dj fait une.

  Remarques :

  Un "~" (tilde) dans le texte indique que la lettre qui suit sera
  souligne et utilise comme touche de raccourci (Vous pourrez aussi
  voir "&" (et commercial) qui fait la mme chose, mais qui ne fonctionne
  pas aussi bien - veuillez m'informer si une telle chose apparait).

  Un "\t" dans le texte indique un caractre de tabulation et est utilis
  pour sparer un lment de menu de sa touche "d'acclration" ou de sa
  combinaison de touche. De toutes manires, vous NE pouvez PAS modifier
  l'acclrateur vous mme, par exemple F3 pour quitter, par telle ou telle
  touche. Veuillez donc laisser la partie aprs le "\t" telle quelle.

- Mise  jour d'un fichier de langue existant

  Si vous avez dj un fichier mais qui ncessite une mise  jour -
  peut-tre pour une nouvelle version du programme - vous n'avez alors
  qu' sauvegarder sur le MME fichier. Les nouveaux lments devant tre
  traduits seront ajouts et les lments qui ne sont plus ncessaires
  seront retirs.

  Les lments inutiles sont tout de mme laisss  la fin du fichier
  pour que vous puissiez vrifier; supprimez-les aprs l'avoir fait pour
  gagner de l'espace. Notez que certains lments peuvent tre juste
  renomms, auquel cas vous aurez  copier la valeur de l'ancien lment
  vers le nouveau (dsol ! ).

  Les nouveaux lments ncessitant une traduction seront suivis par
  "***".

  Remarque : malheureusement tous les commentaires que vous avez pu
  ajouter au fichier seront perdus lors d'une sauvegarde ou mise  jour.


Fichiers d'aide multilingues
----------------------------

Suivant la mme logique, NewView peut charger une version spcifique  la
langue de son fichier d'aide. Il recherche NewView_XX.hlp, o XX est
fonction de la variable LANG comme les fichiers .LNG ci-dessus.

Pour commencer, vous pouvez prendre le fichier NewView.ipf. Veuillez
noter que je NE l'utilise PAS comme source; ce fichier est gnr par
VyperHelp. Ce fichier n'est pas install, il est juste inclus dans un
fichier .ZIP.


Remerciements aux traducteurs
-----------------------------

Mes remerciements aux personnes suivantes qui ont transmis et mis  jour
les traductions :

Allemand - Christian Hennecke, Chris Hellwig
Coren - Tomoarai (Kazuhiko Tani), KO Myung-Hun
Espagnol - David Mediavilla Ezquibela, Alfredo Fernndez Daz
Espranto - Jonathan Moylan
Finlandais - Tapani Raikkonen
Franais - Guillaume Gay
Italien - Alberto Gabrielli, Gabriele Gamba
Japonais - Tomoarai
Nerlandais - Jacques van Leeuwen, Kris Steenhaut
Russe - Yuri Prokushev
Sudois - Simon Gronlund
Tchque - Michal Pohorelsky

J'espre n'avoir oubli personne, j'ai t quelque peu dpass par les
diverses traductions parfois.


Support de NewView
------------------

Si vous trouvez NewView utile, faites-le moi savoir en m'envoyant un Ml
 aaronl at consultant dot com.

D'autres faons de contribuer :
- traduire NewView et/ou son fichier d'aide dans votre langue,
- un bon cadeau Blackstar (http://www.blackstar.co.uk/circle/gift_voucher),
-  un bon cadeau Amazon.com,
- un don via PayPal (http://www.paypal.com),

... ou tout ce que vous voudrez !


Remerciements
-------------

Il s'agit d'un effort continu sur plusieurs annes. Beaucoup de personnes
ont prt main forte. Certaines ont donn de l'argent ( peu prs US$600
jusqu'ici) pour m'aider  me payer cette Porsche :

Henk Pol, Moby Disk, Frederick Giroux, Jerauld Prather, Keith Oswald,
Daniel Caroll, Sten Solberg, Jason Stefanovich, Alexander Newman, Andy Willis,
Richard Tennis, Gregg Young, John F Moore, Bill Richardson, Jan Magne Landsvik,
Daniela Engert, Kris Steenhaut, Pieter Kruger Jr, Timur Tabi,
Peter Gegenheimer, Gordon Snider, Doug Fitzpatrick, Simon Wright, Aidan Grey,
Julian Thomas, Philip Mann, Robert S Stan, Lionel Abrahams, Howard Harris,
Teijo Kaakinen, Lon Hoker, Mark Henigan.

et aussi :

Toutes les personnes qui m'ont encourag, qui ont test et qui ont fait
des suggestions.

Harald Pollack pour le code de renommage des DLL.

Alessandro Cantatore qui a donn normment de conseils spcifiques pour
faire fonctionner ViewStub, et a mme crit le code pour ce faire, pour
moi :).

Les ingnieurs de chez IBM :
- Aaron Reed qui m'a aid  faire fonctionner le gestionnaire d'aide, en
  particulier avec le codage en 16/32 bits.
- Scott Garfinkle, aussi pour l'aide technique  propos de helpmgr.
- Michael Kaply (Warpzilla). Mille mercis !
- Et tous les autres ingnieurs pour avoir ralis un noyau et un bureau
  plutt pas mal.

Christian Hennecke pour avoir prcis les problmes avec le support
multilingue, qui est maintenant total.

Andreas Schnellbacher et Henk Kelder pour les informations sur les
associations de fichiers.

Michal Necasek, Kendall Bennett et le reste de l'quipe Watcom C/C++.
Michal a t d'une trs grande aide en rpondant  toutes mes questions
idiotes, et mes problmes avec le 16 bits lui ont donn pas mal de
boulot. Sans oublier les fameux pilotes video
(http://www.scitechsoft.com).
Allez donc aider Michal avec OpenWatcom pour OS/2
(http://www.openwatcom.org).

Mark Vollmer pour m'avoir clair sur WM_QUERYHELPINFO/WM_SETHELPINFO et
ainsi fait en sorte que SmartSuite fonctionne...

Hakan Gadler pour sa persvrance  faire des tests.

Nicky Morrow pour toutes les remarques constructives  propos de
l'interface utilisateur.

Keith Oswald, pour les suggestions sur l'installation et ses
contributions (finalement, il semblerait que j'ai russi  faire un
installateur, mais a n'est pas WarpIn :).

Tout le monde sur le forum comp.os.os2.programmer.misc pour avoir prt
une oreille  mes grandes questions !

Le groupe de dveloppeurs eCS pour toutes ces discussions passionnantes.

Serenity Systems International (SSI) : Kim Cheung et Bob St John pour lui
avoir donn sa chance l o IBM laissa tomber quelques annes plus tt,
et pour leur tolrance envers certaines personnes
(http://www.ecomstation.com).

John Bijnens, pour son article favorable dans OS/2 E-Zine qui m'a
encourag  continuer ! (http://www.os2ezine.com)

Cristiano Guadagnino, auteur de WarpHelp - en esprant ne pas avoir
empit sur tes plates-bandes en faisant monpropre truc. Je voulais juste
que a bouge un peu. Merci pour l'inspiration donne pour l'impulsion de
dpart.

Peter Fitzsimmons, pour le code de dcompression (LZW) d'images INF
original utilis dans Inf2HTML. Merci Peter ! J'ai russi  le porter
sans avoir tout compltement compris... :-)

Ulrich Moeller, auteur de Inf2HTML
(http://www.xworkplace.org/projects.html) et - BIEN SR ! - de
XWorkplace/eWorkPlace, etc.. La Lgende !

Carl Hauser, auteur original de INF01.DOC, dcrivant le format binaire INF.
Je me demande ce que tu deviens en ce moment Carl ;). Nous en sommes
finalement arrivs l.

Marcus Groeber, qui a ajout des informations supplmentaires 
INF2A.TXT.

Peter Childs, qui a fait quelques mises  jour dans INF03.TXT.

Speedsoft (http://www.speedsoft-online.de), les auteurs de Sibyl,
l'impressionnant clone de Delphi pour OS/2, Linux et Win32 - Bonne chance
les gars. Il semblerait qu'ils travaillent sur un logiciel de musique 
prsent.

Mat Kramer (http://www.vyperhelp.com/), auteur de VyperHelp - merci pour
ces quelques suggestions sur les contrles de texte enrichi, ainsi que
pour ce trs pratique outil de cration d'aide.

Erik Hueslmann, auteur des composants HelperThread de Sibyl et mainteneur
de l'archive de la liste de publipostage sur Sibyl
(http://www.sibyl-archive.org/).

IBM... Ils ont t bons parfois.

Joachim Benjamins (Mensys Pays-Bas) - pour le Bugtracker. Joli travail,
mec !

"Elwood", compositeur de "Unknown Phuture" (unk.xm) - Cette musique bouge
plutt bien...

"Mr Stewe", compositeur de "Static Universe" (pb_static.xm) - Tu devrais
revenir sur la scne, mec !

30 Seconds To Mars - Un incroyable premier album. Je l'adore. Je me
l'coute en boucle sans cesse. "You know enough to know the way...".
Un an plus tard : Mouais??? Maintenant je ne peux plus le supporter !
Pouf-pouf.


--------------------------------------------------
INFORMATIONS TECHNIQUES
--------------------------------------------------


Installation manuelle
---------------------

Pour un usage comme application indpendante, vous pouvez tout simplement
dcompresser les fichiers (principalement 'NewView.exe') dans le
rpertoire final de votre choix. Ce rpertoire peut figurer dans la
variable d'environnement PATH si vous le dsirez.

Une installation complte manuelle se fait en plusieurs tapes et
ncessite d'autres utilitaires pour manipuler les fichiers EXE et DLL.
Toutes les procdures suivantes sont effectues par l'installateur.
Je prfrerais que vous l'utilisiez et que vous reportiez les problmes
ventuellement rencontrs, plutt que d'essayer de faire les choses
manuellement.

A. Remplacement de "View.exe"

1. Placez-vous dans X:\os2 (o X est l'unit de disque d'amorage d'OS/2)
2. Copiez "View.exe" en "ibmView.exe"
   Ceci constitue une sauvegarde. Ne *renommez* PAS "View.exe", sinon
   OS/2 dtectera les modifications et fera en sorte que les fichiers
   d'aide utilisent "ibmView.exe" !
3. Copiez "ViewStub.exe" et "View.exe"
4. Copiez "NewView.exe" quelque part dans l'un des chemins de la variable
   d'environnement PATH.

 prsent, les icnes d'aide existantes devraient faire appel  NewView.

Modifier les associations de fichiers pour les fichiers .inf et .hlp peut
ne pas suffire, parceque beaucoup d'icnes d'aide sont en ralit des
objets programme pointant sur "View.exe".

B. Remplacement de "HelpMgr.dll"

1. Remplacement du fichier
   Le remplacement de "HelpMgr.dll" est plus tordu, parcequ'il est
   toujours utilis par le shell du bureau lectronique (WorkPlace Shell
   ou WPS).
   Vous devez alors soit :
   - relancer le systme en ligne de commandes, ou
   - utiliser un outil de dverrouillage de DLL comme unlock ou replmod.
   Sauvegardez l'ancienne DLL en la copiant sous un nom de fichier
   diffrent comme "helpmgr.bak".

2. Dpendances envers l'ancien helpmgr.
   Vous devez AUSSI faire une copie de l'ancien "helpmgr.dll", appel
   "ibmhmgr.dll".
   Il doit aussi tre renomm en interne en utilisant par exemple
   DLLRNAME ou RENMODUL (maintenant sur Hobbes - grce  votre
   serviteur).

C. Faire fonctionner le programme View original

Une fois le fichier helpmgr.dll remplac par le nouveau, l'ancien
programme View ne fonctionnera plus parcequ'il repose sur l'ancien
helpmgr.

1. Utilisez un outil tel que DLLRNAME ou RENMODUL pour faire pointer les
   rfrences  HELPMGR dans la copie de l'ancien programme View vers
   IBMHMGR.
2. Utilisez le mme outil pour faire pointer les rfrences  HELPMGR
   dans viewdoc.exe vers IBMHMGR.
   Vous voudrez probablement faire une sauvegarde de viewdoc.exe avant de
   faire quoi que ce soit.

     dllrname ibmview.exe helpmgr=ibmhmgr
     dllrname ibmhmgr.dll helpmgr=ibmhmgr

   dllrname n'aime pas beaucoup faire a; j'ai utilis un diteur
   binaire. C'est peut-tre parceque le fichier a dj t renomm.
   Peut-tre que renmodul fonctionnera mieux. Je n'ai pas essay.

     dllrname viewdoc.exe helpmgr=ibmhmgr

   Remarquez qu'il n'y a pas de faon simple d'avoir accs  l'ancien
   helpmgr pour l'aide en ligne. Ce qui ncessite un travail assez
   pnible de ma part sur le nouveau helpmgr pour le dcider
   dynamiquement  faire passer les fonctions, et c'est en fait
   impossible dans beaucoup de cas parceque je peux difficilement
   intercepter ce que je ne connais pas.


 l'attention des dveloppeurs
------------------------------

J'ai dpos les sources sur Hobbes.

a a t crit en utilisant deux outils :

- L'Interface Graphique Utilisateur a t ralise en utilisant Speedsoft
  Sibyl (un systme Pascal-Objet comme Delphi)
  Le site tait "http://www.speedsoft-online.de" mais il n'existe plus.
  Si vous demandez gentiment, il se pourrait que je vous envoie ma cl
  d'enregistrement.

- La nouvelle bibliothque HelpMgr.dll a t crite en utilisant Open
  Watcom C++ http://openwatcom.org

Tlchargez les sources pour plus d'informations sur l'architecture du
projet.


Bref rsum des oprations
--------------------------

Cela peut se rvler utile si vous voulez faire une installation ou une
dinstallation manuelle.

Fichiers de l'archive ZIP :

- NewView.exe est l'application principale qui permet de visionner les
  fichiers d'aide.
- ViewStub.exe soit active une fentre existante de NewView, soit lance
  une nouvelle session de NewView s'il n'y a aucune fentre ouverte avec
  tous les fichiers spcifis (Ceci est ralis au moyen d'une liste dans
  la mmoire partage).
- HelpMgr.dll est la DLL que les applications chargent pour accder  l'aide.
  Elle lance NewView lorsque c'est ncessaire.

En installation comme application indpendante, ces fichiers sont copis
tels quels dans le rpertoire d'installation (helpmgr n'est bien
videmment pas inclus puisqu'il n'y en a pas besoin).

Lors d'une substitution :
- ViewStub remplace "View.exe".
- HelpMgr.dll remplace "HelpMgr.dll".
- NewView est install en tant que NewView.exe
  et procure les fonctions quivalentes  celles de ViewDoc.exe.
  Il est plac soit dans "x:\os2" (pour OS/2)
  soit dans "x:\ecs\bin" (pour eCS version 1.1 et ultrieures).
  Remarque : dans les versions antrieures  2.7, "NewView.exe"
  remplaait "View.exe".
- "newview.dll" propose des fonctions de support pour "newview.exe" (en C
  pour la rapidit).
- L'ancien fichier "helpmgr.dll" s'appelle  prsent "ibmhmgr.dll".
- Le nouveau fichier "helpmgr.dll" utilise  prsent "ibmhmgr.dll" pour
  implmenter quelques fonctions inconnues.
- L'ancien "view.exe" est copi en "ibmview.exe" et est modifi pour
  faire rfrence  "ibmhmgr.dll".
- "ViewDoc.exe" est sauvegard puis modifi pour faire rfrence 
  "ibmhmgr.dll".

Version franaise du 2020-07-08 par Guillaume Gay- (guillaume<point>gay<arobase>gmail<point>com)

-- fin --
