helpdeco_readme.txt

8/12/2019 helpdeco_readme.txt

1/6

HELPDECO - Utility-Programm zum Zerlegen von Windows HilfedateienHELPDECO - utility program to dissect Windows help files

HELPDECO zerlegt HLP-Hilfedateien von Windows 3.0, 3.1, 3.11 und '95 undviele MVB-Dateien des Multimedia-Viewers in alle fr den jeweiligenHilfecompiler HC30, HC31, HCP, HCW, HCRTF, WMVC, MMVC oder MVC zumerneuten Zusammenbau erforderlichen Dateien. Dazu gehren:HPJ - die Projektdatei, als Parameter fr den Hilfecompiler anzugebenMVP - die Multimediaprojektdatei, als Parameter fr den MM-CompilerRTF - die Textdatei mit dem gesamten Hilfetext und allen FunotenPH - die Phrasen-Datei (wie sie auch vom Hilfecompiler erzeugt wird)ICO - ein eventuell der Hilfedatei zugeordnetes IconBMP/WMF/SHG/MRB - alle Bilder in Dateien mit passendem FormatBaggage - alle als Baggage in der Hilfedatei enthaltenen Dateien

HELPDECO dissects HLP help files of Windows 3.0, 3.1, 3.11, and '95 andmany MVB multi media viewer titles into all files required for a rebuildusing the appropriate help compiler HC30, HC31, HCP, HCW, HCRTF, WMVC,MMVC or MVC:HPJ - help project file, use as parameter when calling help compilerMVP - multi media project file, parameter for multi media help compilerRTF - text file containing whole content of help file and all footnotesPH - phrases file (same as produced by help compiler)ICO - icon of help file if embedded

BMP/WMF/SHG/MRB - embedded pictures in appropriate formatBaggage - all baggage files contained in help file

HELPDECO wird von der MS-DOS Kommandozeile aus mit dem Namen der zubearbeitenden Datei, eventuell dem Namen einer internen Datei undeventuellen Optionen aufgerufen. HELPDECO luft von der Kommandozeilevon Windows 95 oder Windows NT als 32-bit Applikation zur Bearbeitunggrerer Hilfedateien.Call HELPDECO from MS-DOS command line. Supply name of help file to use,optional name of internal file, and options if appropriate.HELPDECO runs from Windows 95 or Windows NT command line as 32-bitapplication to handle larger help files.

HELPDECOZeigt BenutzungshinweiseDisplays usage

HELPDECO helpfilenameZerlegt die Hilfedatei in alle zum erneuten Zusammenbau bentigten Dateien.Diese Dateien werden im aktuellen (mglichst leeren) Verzeichnis abgelegt.Existierende Dateien werden ohne Rckfrage berschrieben wenn die Option /yangegeben wird.Decompiles help file into all sources needed for a rebuild. All files arecreated in current directory (should be empty). Existing files will beoverwritten without asking if option /y was specified.

Hinter dem Kommando knnen durch Leerzeichen abgesetzte Optionen angebenwerden:Options may be appended to the command, separated using blanks, as follows:

/mkann verwendet werden, um das Durchsuchen von macros nach Topicnamen zuverhindern, wenn dabei Probleme auftreten. Hilfecompiler wird Warnung 4131melden.May be used to stop parsing macros for topic names. Help compiler will emitWarning 4131.


2/6

/bkann verwendet werden, um das Auflsen von Browse-Sequenzen zu verhindern,wenn dabei Probleme auftreten. Hilfequelltextdatei enthlt dann keine +Funoten.May be used to stop resolving browse sequences. Help source file thancontains no + footnotes.

/gSchaltet das zeitintensive Raten von Kontextnamen aus. Anzuwenden wennHELPDECO 'no context ids found' meldet oder man nicht an lesbarenKontextnamen interessiert ist. Die Funktionsweise von HELPDECO wird dadurchnicht beeintrchtigt.Zum Raten versucht HELPDECO aus Kapitelberschriften und Schlsselwrtendie Kontextnamen zu rekonstruieren, was bei einigen Hilfedateien sehr gut,bei anderen gar nicht funktioniert, je nach Hilfedateierstellungswerkzeugoder Arbeitsmethode des Hilfeautors.Turns off time consuming guessing of context names. Applicable whenHELPDECO reports 'no context ids found' or when you are not interested inlegible context ids. This doesn't affect functionality.During guessing HELPDECO tries to reconstruct context ids from topic titlesand keywords. This may produce good results on some help files and no resultat all on others, depending on autoring tool used or working method of helpauthor.

/iWenn man sehen mchte, welche Kontextnamen HELPDECO errt...If you want to see which context ids are guessed by HELPDECO...

/hprefixHELPDECO versucht aus Kapitelberschriften und Schlsselwrtern Kontextnamenzu erraten, wobei auch idh_ oder helpid_ vorangestellt werden.Wenn die Hilfedatei mit anderen bekannten Prefixen erstellt wurde, kanndie Tabelle durch die Option /h prefix erweitert werden.HELPDECO tries to guess context ids from topic titles and keywords, possiblyprefixed by idh_ or helpid_. If the help file was created using otherprefixes, they may be added to the table using the /h prefix option.

/a [annotationfilename.ANN]Fgt zustzlich alle Anmerkungen aus der angegebenen Anmerkungsdatei alsAnmerkungen des Benutzers ANN in die RTF-Datei ein. Fehlt der annotation-filename, verwendet HELPDECO helpfilename.ANN dafr.Adds all annotations from annotationfile as annotations of user ANN intoRTF file. Default annotationfilename is helpfilename.ANN.

/s nZerteilt die Ausgabe alle n Seiten in eine eigene RTF Datei, z.B. zerlegt HELPDECO helpdemo /s 100die Datei helpdemo.hlp und erzeugt RTF-Dateien mit den Namen helpdem1.rtf,helpdem2.rtf,.. die jeweils hchstens 100 Seiten enthalten.

Splits output every n pages into a separate RTF file. For example HELPDECO helpdemo /s 100decompiles helpdeco.hlp and creates different RTF files helpdem1.rtf,helpdem2.rtf,.. each containing no more than 100 topics.

HELPDECO helpfilename /rErzeugt aus der Hilfedatei eine RTF-Datei, die von WinWord geladen dasselbeAussehen hat wie die von WinHelp angezeigten Hilfeseiten. Damit kann eineHilfedatei komplett gedruckt oder weiterverarbeitet werden. ZustzlichOption /n angeben, wenn an Kapitelgrenzen kein Seitenwechsel stattfinden soll.


3/6

Converts help file into RTF file of same appearance if loaded into WinWordas if displayed by WinHelp. To print or work with complete content. Specifyadditional option /n, if no page breaks should separate topics.

HELPDECO helpfilename /cErzeugt aus der Hilfedatei eine *.CNT-Datei fr WinHlp32, die alle Kapitelmit berschriften in der Reihenfolge enthlt, in der sie in der Hilfedateiauftreten. Die Datei mu dann mit HCW 4.00 oder einem Texteditor in einehierarchische Struktur berarbeitet werden.Generates a *.CNT file used by WinHlp32, containing all chapters that havetitles assigned in the order they appear in the helpfile. This file shouldthen be edited using HCW 4.00 or any text editor into a hierarchical order.

HELPDECO helpfilename /eZeigt alle Referenzen auf externe Hilfedateien.Lists all references to external help files.

HELPDECO helpfilename /e /fZeigt alle Referenzen auf externe Hilfedateien und die Titel der Topics indenen sie auftraten.Lists all references to external help files and titles of topics thatcontained these references.

HELPDECO helpfilename /p

Prft Referenzen auf externe Hilfedateien. Die referenzierten Hilfedateienmssen fr HELPDECO zugreifbar sein. Dieser Aufruf erzeugt keine neuenDateien und modifiziert keine existierenden. Fehler werden auf stdout (denBildschirm) geschrieben.Checks references to external help files. Referenced help file need to beavailable to HELPDECO. This call doesn't produce any new files and doesn'tmodify existing files. Errors are reported to stdout (screen).

HELPDECO helpfilename /dZeigt das interne Inhaltsverzeichnis der Hilfedatei. Es kann auch eine*.MVB,*.M??,*.ANN,*.CAC,*.AUX Datei anstelle der *.HLP-Datei angegebenwerden.Displays internal directory of help file. You may supply a *.MVB,*.M??,

*.ANN,*.CAC,*.AUX file instead of a *.HLP file.

HELPDECO helpfilename /xZeigt das interne Inhaltsverzeichnis als HexDumpDisplays hex dump of internal directory

HELPDECO helpfilename "internalfilename"Zeigt die genannte interne Datei in einem passenden Format an, soweit dieinterne Datei anzeigbar ist, sonst als HexDump. Sie knnen die Ausgabe ineine Datei umleiten durch anhngen von >outfile.Displays internal file in appropriate format if known, else hex dump. Youmay redirect output into a file using >outfile.

HELPDECO helpfilename "internalfilename" /xZeigt die genannte interne Datei als HexDumpDisplays hex dump of internal file

HELPDECO helpfilename "internalfilename" /x /t offsetZeigt die genannte interne Datei als HexDump beginnend bei Positionoffset, der als Dezimalzahl oder mit vorangestelltem 0x als Hexadezimal-zahl akzeptiert wird.Displays hex dump of internal file starting at offset, which may bespecified in decimal or preceeded with 0x in hex.


4/6

HELPDECO helpfilename "internalfilename" filenameExportiert die genannte interne Datei in filenameExports internal file into filename

*.ANN, *.CAC, *.AUXDiese Dateien sind auch wie Hilfedateien formatiert, HELPDECO kann aber nurverwendet werden, um ihr Inhaltsverzeichnis anzuzeigen oder um einzelneDateien anzuzeigen und zu exportieren.These files are formatted like helpfiles, but HELPDECO can only be used todisplay their internal directory or display or export internal files.

HELPDECO wurde erstellt von / was written byManfred Winterhoff, Geschw.-Scholl-Ring 17, 38444 Wolfsburg, GermanyCIS 100326,2776

Wenn Sie weitere Fragen, Probleme (oder Antworten!) haben, knnen Siedurch eine EMail an [email protected] mit mir in Kontakt treten.If you have more questions, problems (or answers!), please feel free tosend me an EMail to [email protected]

HELPDECO basiert auf HELPDUMP von Pete Davis verffentlicht in:HELPDECO is based upon HELPDUMP from Pete Davis published in:The Windows Help File Format, Dr. Dobbs Journal, Sep/Oct 1993

Thanks to Holger Haase, who did a lot of work on picture file formats.And thanks to Jrgen Mller for pointing out 32-bit differences.Thanks to Bent Lynggaard for the information on help file free listsand his contribution on context id guessing.

HELPFILE.TXT enthlt eine Beschreibung des Windows Hilfedateiformatswie HELPDECO es versteht und weiterer Dateiformate wie MRB/SHG.See HELPFILE.TXT for a description of the Windows help file formatas parsed by HELPDECO and related file formats like MRB/SHG.

Die neueste Version von HELPDECO befindet sich stets in:The newest public version of HELPDECO is always available at:CompuServe: Dr. Dobbs Journal DDJFOR Undocumented Corner HELPDCxx.ZIP

InterNet: ftp://gmutant.wrlc.org/pub/winhelp

HELPDECO ist Freeware. Der Einsatz erfolgt auf eigene Gefahr. KeinProgrammteil darf kommerziell verwendet werden. Fr das Kopieren drfenkeine Gebhren verlangt werden (Sharewarehandel Finger weg).HELPDECO is freeware. Use at your own risk. No part of the program may beused commercially. No fees may be charged on distributing the program(shareware distributors keep off).

Die Verwendung von Inhalten zerlegter Hilfedateien kann eine Verletzungdes Urheberrechtes bedeuten.The use of parts of decompiled help files may constitute a violation ofcopyright law.

Version 2.1:macros may contain rtf meta charactersWin95 topic names may contain (nearly) all characters0x8000 in SWin->Maximize allowedForeHelp creates PhrIndex/PhrImage _and_ _empty_ Phrases fileHCRTF complained about > footnotes before # footnotesmacro parsing changed again

Version 2.0:


5/6

Guess context ids from titles and keywords based on idea of Bent LynggaardRecompiled 16 bit EXE without register calling convention. BC++ 3.1 bug.Doesn't print last (stray) topic of HC30 help filesCan list entry points into this help file (option /l)

Version 1.9: faster & better than ever...changed TopicPos, TopicOffset, Keyword maintenancechanged unhash to 40 bit integer arithmeticfixed keyword footnotes [Bent Lynggaard]no [ALIAS] in MVP filesno hidden text in option /r RTF filessome changes in font and stylesheet handlingcorrects rounding error of HC31 on negative valueshandles non-underlined topic jumps

Version 1.8: used some spare days to clean up the to-do list...better tracking of TopicOffset during decompilationlists and checks references to external files, shows referencing topicscan add annotations from .ANN file to decompiled .RTF filefixed bug in handling of pictures containing JumpId-macro hotspotschanged parsing of macros (3rd attempt to guess what Microsoft did)fixed bug in popup/jump to external file / secondary windowfixed bug in > footnote / |VIOLA internal file handlingfixed bug in keyword assignment

now removes LZ77 compression from exported SHGs/MRBsrecreates Win 95 (HCW 4.00) [MACROS] section from internal |Rose file32 bit version availablehandles LANGUAGE, [CHARTAB] and [GROUP] section of media view files

Version 1.7removed unneccessary output statement

Version 1.6 can now check references to external help files plus:duplicate macro names preceeding picture hotspot info skippeddoes not write Win95 commands to multi-media help project fileschanged unhash to circumvent Microsoft-C++ float rounding errorhandles keywords defined inside topic text

Version 1.5fixed static on buffer of TopicName function (affected HC30 files)

Version 1.4 fixes some bugs reported by different users:buffer overflow in expanding LZ77&RunLen (byPacked 3) images fixedembedded images {bmxwd} larger than 32k supportedextract topic names from jump into external file if no file specifiedhandles more phrases on HCRTF generated (Win95) help filesWindows 3.1 (HC31) |Phrases always Zeck compressedLinkData2 buffer enlarged 1 byte to store trailing NUL character

Version 1.3

parses examples of {bmc} etc. statements contained in help text correctlycan now generate a *.CNT content file for Windows 95 / WinHlp32Microsoft C: ctype macros (isalnum/isprint) don't work with signed char

Version 1.2 fixes some severe bugs introduced in version 1.1 and:tells you which help compiler to usecollects multiple keyword footnotes into single lineshandles \r\n in COPYRIGHTconverts SPC-macro (but only in [CONFIG] section)does not generate duplicate MAP-statements if possible


6/6

{button} and {mci,mci_left,mci_right} commands supported[BITMAP]-section in HCRTF help files irritated transparent bitmaps

Version 1.1 now supports more features of Win95/HCRTF 4.00/WinHlp32:Supports LCID, CHARSET, AUTO-SIZE HEIGHT, CNT, INDEX_SEPARATORSAdditional Win95 Macros (to extract original topic names)[CONFIG:n] of Win95 supported (internal file |CFn)Secondary windows with > footnote supported (internal file |VIOLA)Transparent bitmaps supported (bmct,bmlt,bmrt)Expanded internal limits as HCRTF allows larger itemsNow does RunLen compressed device dependend bitmapsBugs in handling of metafiles removedBug in placement of pack(1) removedParsing of macros changed (is it really better now ?)

Documents

helpdeco_readme.txt