NewView
=======

Das NewView-Projekt wird von NetLabs TRAC gehostet.:
http://trac.netlabs.org/newview

Fehlerberichte knnen ber den Link 'Neues Ticket' auf der obigen Website einreichen.
Fhren Sie bitte vorher eine Suche in den bereits vorhandenen Tickets durch,
um zu sehen, ob jemand anderes Ihr Problem bereits gemeldet hat.

Copyright (C) 2004-2005 Aaron Lawrence
und (C) 2006-2019 Ronald Brill
mit zustzlichen Beitrgen (C) 2019-2023 Alexander Taylor

NewView ist ein kostenfreier Ersatz fr das ursprngliche OS/2-Online-Hilfesystem.

Die wichtigsten Verbesserungen sind:

- Neue Benutzeroberflche (geteiltes Fenster)
- Auswhlen und Kopieren direkt aus dem Fenster
- Einfach zu nutzende globale Suche ber alle Dateien
- Erinnert sich an Gre und Position
- Liste der zuletzt verwendeten Dateien
- Anzeige mit reibungslosem Bildlauf
- Aktuelles Thema immer inhaltlich hervorgehoben
- Kann in der Hostorie sowohl vorwrts als auch rckwrts gehen
- Optionen fr Schriftarten, Farben und mehr
- Hilfedateien mit Anmerkungen versehen
- Untersttzt Lesezeichen
- Vollstndig grenvernderbar
- Automatische Web-, FTP- und E-Mail-Links (verwendet Standard-WPS-Browser)
- Dateien zum ffnen ablegen
- Zustzliche Dateien ffnen
- Automatische Sprachauswahl
- Automatische Indexerstellung
- Erweiterter Dateidialog mit Hilfedatei-Titeln

Eine Versionsgeschichte knnen Sie der Datei `changes.txt` entnehmen.


Installation (ZIP-Archiv)
-------------------------

Wenn Sie die ZIP-Distribution von NewView heruntergeladen haben,
empfehlen wir Ihnen, die mitgelieferte `install.exe` zu verwenden.

Das Installationsprogramm bietet Ihnen die Mglichkeit, NewView als
eigenstndige Anwendung zu installieren oder das bisherige
Hilfe-Anzeige-Programm zu ersetzen.
Entscheiden Sie sich, das bisherige Programm nicht zu ersetzen, haben Sie
zu jedem Zeitpunkt die Mglichkeit, NewView mit Hilfedateien zu verknpfen;
Beachten Sie jedoch, da dies NICHT dazu fhrt, dass NewView fr viele der
Hilfesymbole verwendet wird, die von verschiedenen Anwendungen
installiert werden, da es sich dabei oft um Programmobjekte handelt,
die direkt auf `View.exe` verweisen.

Falls NewView bereits auf dem System existiert, und Sie
ein Upgrade durchfhren, installieren Sie dieses einfach ber die
bestehende Version. berprfen Sie jedoch die Datei `changes.txt`,
um zu sehen, ob es speziellen Anmerkungen zu der neuen Version gibt.

eComStation v1.1 wurde mit einer Version von NewView ausgeliefert
Dies betraf nur der Betrachter. NewView ersetzte nicht den IBM-Betrachter.
Das eCS-Wartungswerkzeug aktualisiert dies nicht, aber die Installation
von NewView ist intelligent genug, um die eCS-Kopie von NewView
korrekt zu aktualisieren.

Ein Neustart wird fr einen vollstndigen Ersatz erforderlich sein,
auch bei einem Upgrade.

Wenn Sie sich entschieden haben, das originale IBM-Hilfe-Anzeigeprogramm
zu ersetzen, haben Sie immer noch Zugriff auf dieses:
Verwenden Sie `IBMVIEW < Dateiname >`.

Informationen zur manuellen Installation finden Sie weiter unten
im Abschnitt *Technisch*.


Installation (WPI-Paket)
------------------------

NewView ist nun als WPI (WarpIN)-Archiv verfgbar. ffnen Sie die WPI-Datei
in der Workplace Shell, um die Installation bzw. Aktualisierung zu starten.


Deinstallation
--------------

Wenn Sie mittels WarpIN installiert haben, verwenden Sie die WarpIN-GUI,
um die Pakete NewView\Core, NewView\Help und NewView\ReadMe zu deinstallieren.

Falls die Installation per ZIP-Datei vorgenommen haben, gibt es kein
automatisches Deinstallationsprogramm. In diesem Fall mssen Sie die
Backup-Dateien (.bak, wenn Sie die `install.exe` verwendet haben) in die
Original-Dateinamen kopieren; Sie mssen des weiteren unlock/replmod
verwenden, um `HelpMgr.dll` zu ndern oder zu einer Eingabeaufforderung
zu booten. Insbesondere mu `x:\os2\dll\helpmgr.dll`, `x:\os2\view.exe`
und `x:\os2\viewdoc.exe` wiederhergestellt werden.



Probleme
--------

Falls Sie einen Absturz oder ein anderes Problem melden mchten, dann seien Sie
bitte so genau wie mglich, welche Dateien verwendet wurden,
was Sie getan haben, in welcher Reihenfolge, usw.
Schlieen Sie BITTE die `newview.log` mit ein, falls diese existiert.
Die Protokolldatei befindet sich ENTWEDER - im selben Verzeichnis
wie NewView selbst - oder in dem durch die Umgebungsvariable LOGFILES
festgelegten Verzeichnis (typisch unter eCS oder ArcaOS).

Es kann auch hilfreich sein, NewView mit dem Parameter /profile (undokumentiert)
laufen zu lassen und die so erzeugte Datei `newview.prf` zu senden.
Besonders wenn es keine `newview.log` Datei gibt!

- Problem mit systemmodalen und "always on top"-Anwendungen

  Wenn die Hilfe aus einer Anwendung geffnet wird, die system-modal ist,
  oder diese "immer im Vordergrund" (WS_TOPMOST) angezeigt wird, ist die
  Wahrscheinlichkeit hoch, da NewView hinter dem Anwendungsfenster
  "eingeklemmt" wird. Mgliche Lsungen hierfr werden derzeit untersucht.

- Text in der Zwischenablage wird abgeschnitten

  Beim Kopieren grerer Textmengen (in der Regel mehrere Zeilen) in die
  Zwischenablage kann es vorkommen, da dem kopierten Text die letzten
  Zeichen/Zeilen der Auswahl fehlen. Die Ursache wird noch untersucht.

- Ungewhnlich groer minimierter Symbolbereich

  Wenn die WPS so konfiguriert ist, da die Symbole auf dem Desktop
  minimiert werden, fhrt der Versuch, NewView zu verschieben, whrend es
  minimiert ist dazu, da das Symbol einen 200x200 Pixel groen Rahmen
  um sich herum erhlt. Dies ist ein rein kosmetisches Problem.

- Installation wird nicht ausgefhrt

  `renmodul.dll` mu zugnglich sein. Normalerweise sollte das funktionieren,
  wenn Sie install aus dem gleichen Verzeichnis ausfhren und `.` sich im
  libpath befindet.

- F1 bringt die Anwendung zum Absturz (bei vollstndiger Installation)

  Obwohl es noch immer mglich ist, da dies ein Problem in NewView ist,
  eigentlich der Ersatz `helpmgr.dll`, gab/gibt es ein Problem mit der
  XWorkPlace Widgets-Bibliothek, insbesondere rbutton.dll oder rgauge.dll.
  Das Deaktivieren des XCenter wird das Problem vermeiden.
  Bislang ist ungeklrt, ob eine Korrektur mglich ist.

- Warnung bei doppelten Dateien

  Die Installation warnt Sie, wenn die NewView-Programme oder Hilfedateien
  auf Ihrem System doppelt vorhanden sind. Wenn Sie wissen, da die Duplikate
  in Ordnung sind (z.B. da Sie den PATH dafr eingerichtet haben), knnen Sie
  die Warnung ignorieren. Grundlegend knnten die Ursachen sein:

    - Sie haben bereits in ein anderes Verzeichnis installiert.
    - Sie fhren eine eigenstndige Installation unter eCS 1.1 durch.
      Dieses Problem sollte nicht bei einer vollstndigen Installation
      auftreten. In diesem Fall wird das Installationsprogramm die Dateien
      in eCS aktualisieren.

  Sie knnen diese Duplikate entweder lschen oder nach Belieben
  berinstallieren.

- ViewHelp hngt auf unbestimmte Zeit

  Wenn Sie die alte `viewhelp.exe` verwenden, z.B. die TCP/IP-Hilfesymbole,
  dann werden Sie mglicherweise feststellen, da viewhelp hngt, nachdem Sie
  das Hilfefenster geschlossen haben. Das liegt daran, da es Funktionen von
  helpmgr verwendet, die NewView nicht untersttzt. Es scheint jedoch selbst keine
  ntzlichen Funktionen zu bieten, daher:
  Abhilfe: Kopieren Sie `view.exe` ber `viewhelp.exe`.

- IBM-Serviceprogramm (`service.exe`) funktioniert nicht

  Dies wurde in Version 2.13.4 behoben.

- Schriftart der Anwendung ndern

  Wenn Sie die Schriftart der Anwendung ndern, entweder ber
  Extras - Optionen - Schriften, oder indem Sie eine Schriftart auf
  das Hauptfenster ziehen, mssen Sie das System neu starten, bevor alle
  Teile der Anwendung die neue Schriftart verwenden. Beachten Sie,
  wenn Sie Schriftarten auf das rechte Fenster fallen lassen, in dem
  die Hilfethemen angezeigt werden, ndert sich dadurch auch die
  Themenschriftart, die von der Anwendungsschriftart getrennt ist.
  Halten Sie die Umschalttaste gedrckt, whrend Sie die Schriftart ziehen
  und ablegen, um die Schriftart in eine mit fester Breite zu ndern.

- Schriften und Farben nicht immer konsistent

  Einige Hilfedateien geben ihre eigenen Schriftarten und/oder Farben an.
  In diesem Fall werden die von Ihnen gewhlten Standardeinstellungen entweder
  teilweise oder vollstndig ignoriert.

- IBM BookManager Reader funktioniert nicht

  Da hat IBM das Rad einmal mehr neu erfunden: Es ist unbekannt, wie der
  IBM Book Manager den helpmgr verwendet. Folglich wird es nicht untersttzt.

- Dialogfeld zur Druckereinrichtung sieht seltsam aus

  Der Druckerdialog hat einen weien Hintergrund und die Versionsnummer wird
  als ??? angezeigt. Ich habe keine Ahnung, worauf dies zurckzufhren ist.
  Das Problem ist untersucht worden. Bitte melden Sie dieses Problem nicht,
  es sei denn, Sie haben einen konkreten Vorschlag.
  Es scheint nicht zu verhindern, da alles ordnungsgem funktioniert.
  Folglich hat dieses Problem eine sehr niedrige Prioritt.

- Dialogfeld zur Druckereinrichtung funktioniert nicht

  Einige Dialoge zur Druckereinrichtung funktionieren nicht, jedoch wei der
  Autor der Anwendung nicht warum das der Fall ist: Die OS/2-Druck-API ist
  nicht sonderlich gut konzipiert, so da es sehr schwierig ist,
  mit ihr zu arbeiten.

- Nachdem die Hilfe vollstndig ersetzt wurde, funktioniert das OS/2-Tutorial
  nicht mehr.

  Es ist unwahrscheinlich, da dies in naher Zukunft behoben werden kann,
  da es nicht Teil der jngsten OS/2-Distributionen ist und das Tutorial
  zahlreiche obskure Funktionen verwendet.

- Die Symbole Master Help Index und Online Info Overview - Glossar
  im Assistenzzentrum funktionieren nicht.

  Es ist unwahrscheinlich, da diese jemals vollstndig behoben werden,
  aber sie bringen den Desktop nicht mehr zum Absturz.
  Ich persnlich halte die globale Suche fr viel ntzlicher:
  Tools - Alle Hilfedateien durchsuchen

- Die EPM-Hilfe kann Probleme bergen.

  Dies wurde in NewView 2.7 oder hher behoben, da `View.exe` jetzt
  ein Stub ist, der wie das Original sofort beendet wird.
  Hinweis: Wenn Sie NewView eigenstndig installieren, es aber fr epmhelp
  verwenden mchten, mssen Sie die EPM-.NDX-Dateien aktualisieren, die den
  Namen des auszufhrenden Hilfsprogramms enthalten.

- Notizen sind nicht vollstndig vorhersehbar.

  Notizen befinden sich mglicherweise nicht an der richtigen Stelle,
  wenn Such-Highlights angezeigt werden oder die Hilfedatei aktualisiert wird.
  Sie scheinen zwar immer noch ntzlich zu sein, und das Problem ist ziemlich
  schwierig zu beheben, daher werde ich sie wahrscheinlich so belassen,
  wie sie sind.

- Konflikt mit Styler/2 (SmartWindows):

  Dies ist in Styler/2 1.6.5.1 oder hher bereits behoben.
  Fr ltere Versionen gilt:
  Wenn Sie das Steuerelement "Maximierte Fenster" verwenden, dann werden auch
  die Themenfenster von NewView maximiert, und sind mglicherweise zu gro,
  um sie anzuzeigen. Abhilfe: Fgen Sie `view.exe` und/oder `newview.exe`
  zur "Ausnahmen"-Liste in den Styler/2-Einstellungen hinzu.

- Es ist ggf. nicht mglich, Dateien mit Leerzeichen im Namen vom Desktop aus
  zu ffnen:

  Stellen Sie sicher, da das Programmobjekt fr NewView ENTWEDER:
  Leere Parameter hat, ODER im Parameterfeld steht "%*". (mit Anfhrungs-
  zeichen) NICHT nur %* ohne Anfhrungszeichen.

- Alter Betrachter nicht ausfhrbar

  Es wird empfohlen, die vollstndige Installation zu verwenden, die den alten
  IBM-Hilfebetrachter ersetzt. Dies nicht zu tun, knnte bewirken,
  da "die Dinge durcheinander geraten". Um den alten Betrachter zum Laufen
  zu bringen knnen Sie folgendes versuchen:

    1. Nehmen Sie eine Kopie der originalen IBM-Ansicht (z.B. aus einem Backup)
       und kopieren Sie diese nach `x:\os2\ibmview.exe` (x: = Startlaufwerk).
    2. Laden Sie eine Kopie von Renmodul von Hobbes herunter, und legen Sie
       diese an beliebiger Stelle in ein Verzeichnis, das mittels PATH-Variable
       referenziert wird..
    3. ndern Sie das Verzeichnis zu `x:\os2` (x: = Systemlaufwerk).
    4. Geben Sie an einer OS/2-Befehlszeile das Folgende ohne Anfhrungszeichen
       ein: `renmodul /i ibmview.exe helpmgr ibmhmhmgr`

  (Danke an Bertie Kemp)


Lizenz
------

Ab V1.27.9 ist NewView Open-Source-Software unter der GNU Public License (GPL).
Die Details hierzu entnehmen Sie bitte der der GPL.txt:

This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place - Suite 330, Boston, MA  02111-1307, USA.

Notiz des bersetzers:
Nach Rechtslage mssen bersetzungen an Lizenzbedingungen durch Fachanwlte
berprft und abgenommen werden. Da dies nicht erfolgen kann, mu der obige
Ausschnitt der GPL in der Originalsprache verbleiben.

Wenn Sie mich ermutigen mchten, NewView weiter zu entwickeln, dann knnen Sie
mir ber PayPal (http://www.paypal.com) o.. eine Spende zukommen lassen!


Untersttzung fr Mehrsprachigkeit
----------------------------------

NewView kann jetzt verschiedene Sprachen fr seine Benutzeroberflche
und (ab Version 2.14) sprachspezifische Hilfedateien laden.

NewView sucht nach einer Datei mit dem Namen 'newview_XXX.lng, wobei XXX
auf der Umgebungsvariablen LANG basiert. Zum Beispiel wird auf US-Systemen
LANG=EN_US nach newview_en_us.lng gesucht. Wenn diese Datei nicht
auffindbar ist, versucht NewView nach dem grten Teil der LANG-Variablen
zu suchen, z.B. nach newview_de.lng. Wenn diese Datei ebenso nicht gefunden
werden kann, ist die Standardeinstellung US-Englisch. Dies ist Bestandteil
der .EXE; Sie mssen neu starten, um die Sprache zu ndern).

Normalerweise sind die bersetzungen nicht fr eine bestimmte Region eines
Landes gedacht, sondern die Dateien, die mit NewView geliefert werden,
sind landesspezifisch, und heien dann (zum Beispiel) newview_es.lng,
und nicht newview_es_es.lng.

Sie knnen die Standardsprache mit dem Parameter /lang:<xx> bergehen,
wobei XX die alternative Sprachangabe ist.

- Wo die Sprachdateien zu finden sind

  Die Sprachdateien werden in dieser Reihenfolge geladen:
    - %OSDIR%\lang  (ArcaOS and eCS 1.1+)
    - %ULSPATH%
    - Anwendungsverzeichnis

- Eine eigene bersetzung erstellen

  Sie knnen ganz einfach eine bersetzungsdatei fr NewView erstellen.
  Verwenden Sie hierfr Zubehr - Debug - Speichern/Update Sprache,
  um eine neue .lng-Datei zu erstellen. Diese .lng-Datei enthlt alle
  Textelemente, die die Anwendung verwendet. bersetzen und speichern Sie
  nun den Text.

  Sie knnen die .lng-Datei beliebig benennen. Wichtig ist lediglich die
  Befolgung einiger Regeln, wie nachfolgend beschrieben:

  Wenn Sie dem Autor eine bersetzungen senden, wird er sie in der
  folgenden Version einbinden.
  Um Zeitverschwendung auszuschlieen, fragen Sie den Autor, ob die Zielsprache
  sich bereits durch eine andere Person in bersetzung befindet.

  Hinweise:

  `~` (Tilde) im Text bedeutet, da der folgende Buchstabe unterstrichen
  dargestellt wird. Er gilt somit als Tastenkombination. Mglicherweise sehen
  Sie auch `&` (Und-Zeichen). Dies hat den selben Effekt, funktioniert aber
  nicht ganz so gut. Falls Ihnen ein &-Zeichen auffllt, benachrichtigen Sie
  bitte den Autor.

  `\t` A1 im Text bezeichnet ein Tabulatorzeichen und wird verwendet,
  um einen Menpunkt von seinem "Beschleuniger" oder seiner Tastenkombination
  zu trennen. Sie knnen jedoch den Beschleuniger z.B. F3 fr Beenden
  auf diese Weise (oder mit anderen Mitteln) NICHT ndern.
  Bitte lassen Sie den Teil nach \t so, wie er ist.

- Eine bestehende bersetzung bearbeiten

  Wenn Ihnen bereits eine solche Datei vorliegt, die einige Aktualisierungen
  bentigt, etwa fr eine neue Version, speichern Sie diese einfach wieder in
  dieselbe Datei. Die neuen Elemente, die bersetzt werden mssen,
  werden hinzugefgt, und nicht mehr bentigte Elemente werden entfernt.

  Nicht bentigte Elemente werden am Ende der Datei fr Sie zur berprfung
  belassen; Entfernen Sie diese danach, um Platz zu sparen. Beachten Sie auch,
  da Elemente manchmal umbenannt werden knnen. In diesem Fall mssen Sie den
  vorherigen Wert auf den neuen Namen kopieren. (Entschuldigung!)

  Neue Stellen, die bersetzt werden mssen, werden mit *** markiert.

  Hinweis: Leider werden alle Kommentare usw. in der Datei beim Speichern
  verworfen.


Mehrsprachige Hilfedateien
--------------------------

Mit hnlicher Logik kann NewView eine sprachspezifische Version seiner eigenen
Hilfedatei laden. Es sucht nach NewView_XX.hlp, wobei XX wie bei den .lng-
Dateien oben von LANG abgeleitet ist.

Als Ausgangspunkt knnen Sie die mitgelieferte Datei NewView.ipf verwenden.
Beachten Sie, da der Autor diese NICHT als Quelle verwendet! Diese Datei wird
von VyperHelp generiert. Sie wird nicht installiert, sondern ist nur in der
Zip-Datei enthalten.


Danksagung an die bersetzer
----------------------------

Vielen Dank an die folgenden Personen, die bersetzungen eingereicht bzw.
aktualisiert haben:

Schwedisch - Simon Gronlund
Deutsch - Christian Hennecke, Chris Hellwig, Mathias Riler
Russisch - Yuri Prokushev
Spanisch - David Mediavilla Ezquibela, Alfredo Fernandez Diaz
Franzsisch - Guillaume Gay
Koreanisch - Tomoarai (Kazuhiko Tani), KO Myung-Hun
Japanisch - Tomoarai
Tschechisch - Michal Pohorelsky
Niederlndisch - Jacques van Leeuwen, Kris Steenhaut
Esperanto - Jonathan Moylan
Finnisch - Tapani Raikkonen
Italienisch - Alberto Gabrielli, Gabriele Gamba

Der Autor hofft, niemanden vergessen zu haben. : )



NewView untersttzen
--------------------

Wenn Sie NewView hilfreich finden, lassen Sie es den Autor bitte wissen:
aaronl at consultant dot com.

Andere Methoden mitzuwirken:
- bersetzen Sie NewView oder die Hilfedatei in Ihre Sprache.
- Blackstar-Geschenk-Gutschein (http://www.blackstar.co.uk/circle/gift_voucher)
- Amazon.com-Geschenk-Gutschein
- Eine Spende via PayPal http://www.paypal.com

... oder andere Methoden, ehrlich!


Danksagungen
------------

Bei diesem Projekt handelt es sich um eine kontinuierliche Anstrengung ber
mehrere Jahre hinweg. Viele Menschen haben dabei geholfen.
Einige haben mir Geld gespendet (bisher etwa 600 US-Dollar), um mich beim Kauf
dieses Porsche zu untersttzen:

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.

Auerdem:

All diese Menschen haben mich ermutigt, haben Hinweise gegeben,
und die Anwendung immer wieder getestet.


Harald Pollack fr DLL-Umbenennungs-Quellcode.

Alessandro Cantatore fr seine besondere Hilfe ViewStub zum Laufen zu kriegen.
Er hat auerdem Code fr mich verfat. :)

IBM-Ingeneure:
- Aaron Reed fr seine Hilfe bei der Inbetriebnahme des Hilfe-Managers,
  insbesondere bei der 16/32-Bit-Kodierung.
- Scott Garfinkle, ebenfalls fr technische Hilfe bei helpmgr.
- Michael Kaply (Warpzilla). GROSSEN Dank!
- Und all die anderen Ingenieure, denen wir einen ziemlich guten Kernel
  und Desktop zu verdanken haben!

Christian Hennecke wies auf Probleme mit der Mehrsprachigkeit hin, so da diese
nun vollstndig funktioniert.

Andreas Schnellbacher und Henk Kelder fr Informationen zur Zuordnung von
Dateien.

Michal Necasek, Kendall Bennett und der Rest des Open Watcom Teams fr
Watcom C/C++. Michal war uerst hilfreich bei der Beantwortung meiner dummen
Fragen und hat viel Arbeit geleistet, um meine 16-Bit-Probleme zu klren.
Auch die Videotreiber sind groartig! --> http://www.scitechsoft.com
Helfen Sie Michal mit OpenWatcom unter OS/2. http://www.openwatcom.org

Mark Vollmer dafr, da er auf WM_QUERYHELPINFO/WM_SETHELPINFO hingewiesen
und dadurch SmartSuite zum Laufen gebracht hat...

Hakan Gadler fr sein Beharren auf die Tests.

Nicky Morrow fr viele konstruktive Vorschlge zur Benutzerschnittstelle.

Keith Oswald, fr die Installationsvorschlge und Beitrge.
So jedenfalls... sieht aus, als htte ich ein Installationsprogramm
geschrieben, aber es ist nicht WarpIn :).

An alle in der Newsgruppe comp.os.os2.programmer.misc, die meinen langatmigen
Fragen zugehrt haben!

Die eCS Developers Group fr viele interessante Diskussionen.

Serenity Systems International (SSI): Kim Cheung und Bob St. John dafr,
da sie es dort probiert haben, wo IBM schon vor Jahren aufgegeben hat,
und da sie einigen verrckten Leuten gegenber sehr tolerant waren.
http://www.ecomstation.com

John Bijnens, Eine positive Rezension im OS/2 E-zine, die mich zum Weitermachen
ermutigt hat! http://www.os2ezine.com

Cristiano Guadagnino, Autor von WarpHelp - Ich hoffe, ich habe Sie nicht
verrgert, indem ich mein eigenes Ding gemacht habe. Ich wollte, da die Dinge
ins Rollen kommen. Danke fr die Inspiration anzufangen!

Peter Fitzsimmons, fr den ursprnglichen INF-Bitmap-Dekomprimierungscode
(LZW), der in Inf2HTML verwendet wird. Vielen Dank, Peter! Ich habe es
geschafft, ihn zu portieren, ohne ihn vollstndig zu verstehen... :-)

Ulrich Moeller, Autor von Inf2HTML
  http://www.xworkplace.org/projects.html
Und NATRLICH! XWorkplace/eWorkPlace und so weiter. Welch Legende!

Carl Hauser. Der Originalautor von INF01.DOC, der Beschreibung des
INF-Binrformats. Ich frage mich, was Sie in diesen Tagen machen Carl ;)
Endlich haben wir es geschafft!

Marcus Groeber, Zustzliche Informationen zu INF2A.TXT hinzugefgt

Peter Childs, Weitere Aktualisierungen zu INF03.TXT

Speedsoft http://www.speedsoft-online.de
Die Macher von Sibyl, dem exzellenten Delphi-Klon fr OS/2, Linux und Win32
Viel Glck Leute! Es scheint, da sie jetzt an Musiksoftware arbeiten.

Mat Kramer http://www.vyperhelp.com/
Autor von VyperHelp - Vielen Dank fr die Vorschlge zu
Rich-Text-Steuerelementen, sowie fr ein praktisches Hilfe-Autorentool.

Erik Hueslmann, Autor von Sibyl HelperThread-Komponenten und Verwalter
des Archivs der Sibyl-Mailingliste http://www.sibyl-archive.org/

IBM... Manchmal waren sie unbertrefflich!

Joachim Benjamins (Mensys Niederlande) - fr den Bugtracker.
Gute Arbeit, Kumpel!

"Elwood" Komponist von "Unknown Phuture" (unk.xm) - Dieser Song rockt!

"Mr Stewe" Komponist von "Static Universe" (pb_static.xm) - Sie sollten ins
Musik-Geschft einsteigen!

30 Seconds To Mars - Was fr ein unglaubliches Debtalbum, ich liebe es.
Ununterbrochen gespielt @ v2.  "You know enough to know the way...".
Ein Jahr spter: Hrm, jetzt kann ich es nicht mehr hren! LOL.


--------------------------------------------------
TECHNISCHE INFORMATIONEN
--------------------------------------------------

Manuelle Installation
---------------------

Fr die Variante mit eigenstndiger Installation knnen Sie die Dateien
(hauptschlich `NewView.exe`) einfach in ein Verzeichnis entpacken.
Dieses Verzeichnis kann sich auch im PATH (Systemvariable) befinden,
wenn gewnscht.

Die vollstndige Installation von Hand erfordert viele Schritte, und erfordert
weitere Hilfsprogramme zur Manipulation von EXE/DLL-Dateien.
Alle folgenden Verfahren werden im Installationsprogramm durchgefhrt.
Der Autor bevorzugt und empfiehlt die Verwendung des Installationsprogramms.
Sollten sich dabei Probleme ergeben, bitte diese melden. Versuchen Sie nicht
mit eigenen Methoden zu adaptieren.

### A. View.exe ersetzen

1. Begeben Sie sich nach C:\OS2
2. Kopieren Sie die vorhandene View.exe nach ibmView.exe
   Dadurch wird ein Backup erstellt. Benennen Sie View.exe NICHT um!
   Andernfalls erkennt OS/2 die nderung, und veranlasst, da Hilfedateien
   ab sofort die ibmView.exe verwenden!
3. Nun die neue Datei ViewStub.exe nach C:\OS2\View.exe kopieren
4. Kopieren Sie die neue Datei NewView.exe in ein Verzeichnis,
   das in der Systemvariable PATH enthalten ist.
5. Kopieren Sie die neue Datei newview.dll an die gleiche Stelle wie die
   Newview.exe, oder in ein Verzeichnis, das in der Systemvariable LIBPATH
   enthalten ist.

Nun werden alle Ihre vorhandenen Hilfedatei-Icons NewView nutzen.

Hinweis: Das ndern von Dateiverknpfungen fr die Datei-Extensionen
.inf- oder .hlp bewirkt mglicherweise nicht vollstndig den Ersatz
von View.exe, da viele Hilfedatei-Icons eigentlich Programmobjekte
fr `View.exe` sind.

### B. HelpMgr.dll ersetzen

1. Die Datei ersetzen
   Das Ersetzen der HelpMgr.dll ist schwieriger, da diese durchgehend von der
   WorkPlace Shell (WPS)-Arbeitsoberflche verwendet wird. Gehen Sie so vor:
    - Das System an eine Eingabeaufforderung starten; oder
    - ein Programm wie Unlock oder Replmod zum Entsperren der DLL verwenden
   Sichern Sie die alte DLL, indem Sie sie auf einen anderen Dateinamen
   kopieren, wie z.B. `helpmgr.bak`.

2. Abhngigkeit von altem helpmgr
   Sie mssen AUCH eine Kopie der alten `helpmgr.dll` anlegen,
   genannt `ibmhmgr.dll`.
   Diese mu auch intern umbenannt werden, z.B. mit DLLRNAME oder RENMODUL
   (Gibt es auf Hobbes - ebenfalls vom NewView-Autor).

### C. Das vorherige View wiederherstellen

Sobald helpmgr.dll durch die neue Version ersetzt wurde, wird das originale
View nicht mehr funktionieren, da es von dem originalen helpmgr abhngig ist.

1. Verwenden Sie Anwendungen wie DLLRNAME oder RENMODUL, um die HELPMGR-
   Referenzen in Ihrer Kopie der alten Ansicht in IBMHMGR umzubenennen.
2. Verwenden Sie die Anwendung, um die HELPMGR-Referenzen in viewdoc.exe
   in IBMHMGR umzubenennen.
   Wahrscheinlich sollten Sie vorher ein Backup von viewdoc.exe erstellen.

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

  dllrname "mag dies nicht". Der Autor empfiehlt, einen binren Editor
  zu verwenden. Der Grund hierfr liegt mglicherweise darin, da die Datei
  bereits umbenannt ist. Mglicherweise funktioniert Renmodul besser.

    dllrname viewdoc.exe helpmgr=ibmhmgr

  Beachten Sie, da es keine einfache Mglichkeit gibt, Zugang zum originalen
  helpmgr fr Online-Hilfe zu erhalten. Es wird viel mhsame Arbeit durch den
  Autor im neuen helpmgr erfordern, dynamisch zu entscheiden,
  ob Funktionen weitergegeben werden. In vielen Fllen ist es technisch sogar
  unmglich, da die Anwendung nur bekannte Entitten abfangen kann.


Fr Entwickler
--------------

Aaron verweist ursprnglich auf Hobbes. Die neueste Quelle ist ber
Subversion (SVN) von NewView TRAC verfgbar:
http://trac.netlabs.org/newview

Die Anwendung wurde mit zwei Werkzeugen geschrieben:

- Die GUI-Anwendung wird mit Speedsoft Sibyl, einem Object-Pascal-System
  hnlich Delphi, erstellt. Dessen offizielle Webseite war unter
  http://www.speedsoft-online.de erreichbar, ist aber mittlerweile nicht mehr
  erreichbar. Sie kann wahrscheinlich immer noch aus zweiter Hand oder aus
  verschiedenen Quellen gefunden werden...

- Die neue HelpMgr.dll ist mit Open Watcom C++ geschrieben:
  http://openwatcom.org

Laden Sie die Quelle herunter, um weitere Designinformationen zu erhalten.


Kurze Zusammenfassung von allem
-------------------------------

Dies kann ntzlich sein, wenn Sie manuelle Installationen
oder Deinstallationen durchfhren mchten.

Dateien im ZIP-Archiv:

- NewView.exe ist die Hauptanwendung zum Anzeigen von Hilfedateien.
- ViewStub.exe aktiviert entweder ein vorhandenes NewView-Fenster, oder startet
  eine neue Instanz von NewView, sofern kein bestehendes Fenster mit den
  angegebenen Dateien geffnet ist.
  (Umgesetzt mit einer Liste im gemeinsamen Speicher).
- HelpMgr.dll ist die DLL, die zum Zugriff auf die Hilfe geladen wird.
  Sie startet NewView bei Bedarf.

Im Standalone-Modus werden diese Dateien unverndert in das
Installationsverzeichnis kopiert. Helpmgr ist dann natrlich nicht enthalten,
da es dafr keine Verwendung gibt).

Folgendes nderungen werden vorgenommen:

- ViewStub ersetzt View.exe
- HelpMgr.dll ersetzt die HelpMgr.dll
- NewView installiert sich als NewView.exe
  und hat eine gleichwertige Funktion wie die ViewDoc.exe.
  Diese residiert dann entweder in x:\os2 (OS/2)
  oder x:\ecs\bin (eCS 1.1+)
  Hinweis: In Versionen vor 2.7, ersetzt NewView.exe die View.exe.
- Newview.dll bietet Untersttzungsfunktionen fr newview.exe.
  (C wg. Geschwindigkeit)
- Die alte helpmgr.dll wurde umbenannt zu ibmhmgr.dll
- Die neue helpmgr.dll benutzt ibmhmgr.dll um unbekannte Funktionen
  zu implementieren
- Die alte view.exe wird kopiert zum Namen ibmview.exe
  und abgendert, damit sie ibmhmgr.dll referenziert.
- ViewDoc.exe ist gesichert und abgendert, damit sie ibmhmgr.dll referenziert.


-- Ende --
