home *** CD-ROM | disk | FTP | other *** search
/ PC World 2002 September / PCWorld_2002-09_cd.bin / Software / Vyzkuste / helpdeco / HELPDECO.TXT < prev    next >
Encoding:
Text File  |  1997-01-27  |  14.8 KB  |  315 lines
  1. HELPDECO - Utility-Programm zum Zerlegen von Windows Hilfedateien
  2. HELPDECO - utility program to dissect Windows help files
  3.  
  4. HELPDECO zerlegt HLP-Hilfedateien von Windows 3.0, 3.1, 3.11 und '95 und
  5. viele MVB-Dateien des Multimedia-Viewers in alle für den jeweiligen
  6. Hilfecompiler HC30, HC31, HCP, HCW, HCRTF, WMVC, MMVC oder MVC zum
  7. erneuten Zusammenbau erforderlichen Dateien. Dazu gehören:
  8. HPJ - die Projektdatei, als Parameter für den Hilfecompiler anzugeben
  9. MVP - die Multimediaprojektdatei, als Parameter für den MM-Compiler
  10. RTF - die Textdatei mit dem gesamten Hilfetext und allen Fußnoten
  11. PH  - die Phrasen-Datei (wie sie auch vom Hilfecompiler erzeugt wird)
  12. ICO - ein eventuell der Hilfedatei zugeordnetes Icon
  13. BMP/WMF/SHG/MRB - alle Bilder in Dateien mit passendem Format
  14. Baggage - alle als Baggage in der Hilfedatei enthaltenen Dateien
  15.  
  16. HELPDECO dissects HLP help files of Windows 3.0, 3.1, 3.11, and '95 and
  17. many MVB multi media viewer titles into all files required for a rebuild
  18. using the appropriate help compiler HC30, HC31, HCP, HCW, HCRTF, WMVC,
  19. MMVC or MVC:
  20. HPJ - help project file, use as parameter when calling help compiler
  21. MVP - multi media project file, parameter for multi media help compiler
  22. RTF - text file containing whole content of help file and all footnotes
  23. PH  - phrases file (same as produced by help compiler)
  24. ICO - icon of help file if embedded
  25. BMP/WMF/SHG/MRB - embedded pictures in appropriate format
  26. Baggage - all baggage files contained in help file
  27.  
  28. HELPDECO wird von der MS-DOS Kommandozeile aus mit dem Namen der zu
  29. bearbeitenden Datei, eventuell dem Namen einer internen Datei und
  30. eventuellen Optionen aufgerufen. HELPDECO läuft von der Kommandozeile
  31. von Windows 95 oder Windows NT als 32-bit Applikation zur Bearbeitung
  32. größerer Hilfedateien.
  33. Call HELPDECO from MS-DOS command line. Supply name of help file to use,
  34. optional name of internal file, and options if appropriate.
  35. HELPDECO runs from Windows 95 or Windows NT command line as 32-bit
  36. application to handle larger help files.
  37.  
  38. HELPDECO
  39. Zeigt Benutzungshinweise
  40. Displays usage
  41.  
  42. HELPDECO helpfilename
  43. Zerlegt die Hilfedatei in alle zum erneuten Zusammenbau benötigten Dateien.
  44. Diese Dateien werden im aktuellen (möglichst leeren) Verzeichnis abgelegt.
  45. Existierende Dateien werden ohne Rückfrage überschrieben wenn die Option /y
  46. angegeben wird.
  47. Decompiles help file into all sources needed for a rebuild. All files are
  48. created in current directory (should be empty). Existing files will be
  49. overwritten without asking if option /y was specified.
  50.  
  51. Hinter dem Kommando können durch Leerzeichen abgesetzte Optionen angeben
  52. werden:
  53. Options may be appended to the command, separated using blanks, as follows:
  54.  
  55. /m
  56. kann verwendet werden, um das Durchsuchen von macros nach Topicnamen zu
  57. verhindern, wenn dabei Probleme auftreten. Hilfecompiler wird Warnung 4131
  58. melden.
  59. May be used to stop parsing macros for topic names. Help compiler will emit
  60. Warning 4131.
  61.  
  62. /b
  63. kann verwendet werden, um das Auflösen von Browse-Sequenzen zu verhindern,
  64. wenn dabei Probleme auftreten. Hilfequelltextdatei enthält dann keine +
  65. Fußnoten.
  66. May be used to stop resolving browse sequences. Help source file than
  67. contains no + footnotes.
  68.  
  69. /g
  70. Schaltet das zeitintensive Raten von Kontextnamen aus. Anzuwenden wenn
  71. HELPDECO 'no context ids found' meldet oder man nicht an lesbaren
  72. Kontextnamen interessiert ist. Die Funktionsweise von HELPDECO wird dadurch
  73. nicht beeinträchtigt.
  74. Zum Raten versucht HELPDECO aus Kapitelüberschriften und Schlüsselwörten
  75. die Kontextnamen zu rekonstruieren, was bei einigen Hilfedateien sehr gut,
  76. bei anderen gar nicht funktioniert, je nach Hilfedateierstellungswerkzeug
  77. oder Arbeitsmethode des Hilfeautors.
  78. Turns off time consuming guessing of context names. Applicable when
  79. HELPDECO reports 'no context ids found' or when you are not interested in
  80. legible context ids. This doesn't affect functionality.
  81. During guessing HELPDECO tries to reconstruct context ids from topic titles
  82. and keywords. This may produce good results on some help files and no result
  83. at all on others, depending on autoring tool used or working method of help
  84. author.
  85.  
  86. /i
  87. Wenn man sehen möchte, welche Kontextnamen HELPDECO errät...
  88. If you want to see which context ids are guessed by HELPDECO...
  89.  
  90. /hprefix
  91. HELPDECO versucht aus Kapitelüberschriften und Schlüsselwörtern Kontextnamen
  92. zu erraten, wobei auch idh_ oder helpid_ vorangestellt werden.
  93. Wenn die Hilfedatei mit anderen bekannten Prefixen erstellt wurde, kann
  94. die Tabelle durch die Option /h prefix erweitert werden.
  95. HELPDECO tries to guess context ids from topic titles and keywords, possibly
  96. prefixed by idh_ or helpid_. If the help file was created using other
  97. prefixes, they may be added to the table using the /h prefix option.
  98.  
  99. /a [annotationfilename.ANN]
  100. Fügt zusätzlich alle Anmerkungen aus der angegebenen Anmerkungsdatei als
  101. Anmerkungen des Benutzers ANN in die RTF-Datei ein. Fehlt der annotation-
  102. filename, verwendet HELPDECO helpfilename.ANN dafür.
  103. Adds all annotations from annotationfile as annotations of user ANN into
  104. RTF file. Default annotationfilename is helpfilename.ANN.
  105.  
  106. /s n
  107. Zerteilt die Ausgabe alle n Seiten in eine eigene RTF Datei, z.B. zerlegt
  108.   HELPDECO helpdemo /s 100
  109. die Datei helpdemo.hlp und erzeugt RTF-Dateien mit den Namen helpdem1.rtf,
  110. helpdem2.rtf,.. die jeweils höchstens 100 Seiten enthalten.
  111. Splits output every n pages into a separate RTF file. For example
  112.   HELPDECO helpdemo /s 100
  113. decompiles helpdeco.hlp and creates different RTF files helpdem1.rtf,
  114. helpdem2.rtf,.. each containing no more than 100 topics.
  115.  
  116. HELPDECO helpfilename /r
  117. Erzeugt aus der Hilfedatei eine RTF-Datei, die von WinWord geladen dasselbe
  118. Aussehen hat wie die von WinHelp angezeigten Hilfeseiten. Damit kann eine
  119. Hilfedatei komplett gedruckt oder weiterverarbeitet werden. Zusätzlich
  120. Option /n angeben, wenn an Kapitelgrenzen kein Seitenwechsel stattfinden soll.
  121. Converts help file into RTF file of same appearance if loaded into WinWord
  122. as if displayed by WinHelp. To print or work with complete content. Specify
  123. additional option /n, if no page breaks should separate topics.
  124.  
  125. HELPDECO helpfilename /c
  126. Erzeugt aus der Hilfedatei eine *.CNT-Datei für WinHlp32, die alle Kapitel
  127. mit Überschriften in der Reihenfolge enthält, in der sie in der Hilfedatei
  128. auftreten. Die Datei muß dann mit HCW 4.00 oder einem Texteditor in eine
  129. hierarchische Struktur überarbeitet werden.
  130. Generates a *.CNT file used by WinHlp32, containing all chapters that have
  131. titles assigned in the order they appear in the helpfile. This file should
  132. then be edited using HCW 4.00 or any text editor into a hierarchical order.
  133.  
  134. HELPDECO helpfilename /e
  135. Zeigt alle Referenzen auf externe Hilfedateien.
  136. Lists all references to external help files.
  137.  
  138. HELPDECO helpfilename /e /f
  139. Zeigt alle Referenzen auf externe Hilfedateien und die Titel der Topics in
  140. denen sie auftraten.
  141. Lists all references to external help files and titles of topics that
  142. contained these references.
  143.  
  144. HELPDECO helpfilename /p
  145. Prüft Referenzen auf externe Hilfedateien. Die referenzierten Hilfedateien
  146. müssen für HELPDECO zugreifbar sein. Dieser Aufruf erzeugt keine neuen
  147. Dateien und modifiziert keine existierenden. Fehler werden auf stdout (den
  148. Bildschirm) geschrieben.
  149. Checks references to external help files. Referenced help file need to be
  150. available to HELPDECO. This call doesn't produce any new files and doesn't
  151. modify existing files. Errors are reported to stdout (screen).
  152.  
  153. HELPDECO helpfilename /d
  154. Zeigt das interne Inhaltsverzeichnis der Hilfedatei. Es kann auch eine
  155. *.MVB,*.M??,*.ANN,*.CAC,*.AUX Datei anstelle der *.HLP-Datei angegeben
  156. werden.
  157. Displays internal directory of help file. You may supply a *.MVB,*.M??,
  158. *.ANN,*.CAC,*.AUX file instead of a *.HLP file.
  159.  
  160. HELPDECO helpfilename /x
  161. Zeigt das interne Inhaltsverzeichnis als HexDump
  162. Displays hex dump of internal directory
  163.  
  164. HELPDECO helpfilename "internalfilename"
  165. Zeigt die genannte interne Datei in einem passenden Format an, soweit die
  166. interne Datei anzeigbar ist, sonst als HexDump. Sie können die Ausgabe in
  167. eine Datei umleiten durch anhängen von >outfile.
  168. Displays internal file in appropriate format if known, else hex dump. You
  169. may redirect output into a file using >outfile.
  170.  
  171. HELPDECO helpfilename "internalfilename" /x
  172. Zeigt die genannte interne Datei als HexDump
  173. Displays hex dump of internal file
  174.  
  175. HELPDECO helpfilename "internalfilename" /x /t offset
  176. Zeigt die genannte interne Datei als HexDump beginnend bei Position
  177. offset, der als Dezimalzahl oder mit vorangestelltem 0x als Hexadezimal-
  178. zahl akzeptiert wird.
  179. Displays hex dump of internal file starting at offset, which may be
  180. specified in decimal or preceeded with 0x in hex.
  181.  
  182. HELPDECO helpfilename "internalfilename" filename
  183. Exportiert die genannte interne Datei in filename
  184. Exports internal file into filename
  185.  
  186. *.ANN, *.CAC, *.AUX
  187. Diese Dateien sind auch wie Hilfedateien formatiert, HELPDECO kann aber nur
  188. verwendet werden, um ihr Inhaltsverzeichnis anzuzeigen oder um einzelne
  189. Dateien anzuzeigen und zu exportieren.
  190. These files are formatted like helpfiles, but HELPDECO can only be used to
  191. display their internal directory or display or export internal files.
  192.  
  193. HELPDECO wurde erstellt von / was written by
  194. Manfred Winterhoff, Geschw.-Scholl-Ring 17, 38444 Wolfsburg, Germany
  195. CIS 100326,2776
  196.  
  197. Wenn Sie weitere Fragen, Probleme (oder Antworten!) haben, können Sie
  198. durch eine EMail an 100326.2776@compuserve.com mit mir in Kontakt treten.
  199. If you have more questions, problems (or answers!), please feel free to
  200. send me an EMail to 100326.2776@compuserve.com
  201.  
  202. HELPDECO basiert auf HELPDUMP von Pete Davis veröffentlicht in:
  203. HELPDECO is based upon HELPDUMP from Pete Davis published in:
  204. The Windows Help File Format, Dr. Dobbs Journal, Sep/Oct 1993
  205. Thanks to Holger Haase, who did a lot of work on picture file formats.
  206. And thanks to Jürgen Müller for pointing out 32-bit differences.
  207. Thanks to Bent Lynggaard for the information on help file free lists
  208. and his contribution on context id guessing.
  209.  
  210. HELPFILE.TXT enthält eine Beschreibung des Windows Hilfedateiformats
  211. wie HELPDECO es versteht und weiterer Dateiformate wie MRB/SHG.
  212. See HELPFILE.TXT for a description of the Windows help file format
  213. as parsed by HELPDECO and related file formats like MRB/SHG.
  214.  
  215. Die neueste Version von HELPDECO befindet sich stets in:
  216. The newest public version of HELPDECO is always available at:
  217. CompuServe: Dr. Dobbs Journal DDJFOR Undocumented Corner HELPDCxx.ZIP
  218. InterNet: ftp://gmutant.wrlc.org/pub/winhelp
  219.  
  220. HELPDECO ist Freeware. Der Einsatz erfolgt auf eigene Gefahr. Kein
  221. Programmteil darf kommerziell verwendet werden. Für das Kopieren dürfen
  222. keine Gebühren verlangt werden (Sharewarehandel Finger weg).
  223. HELPDECO is freeware. Use at your own risk. No part of the program may be
  224. used commercially. No fees may be charged on distributing the program
  225. (shareware distributors keep off).
  226.  
  227. Die Verwendung von Inhalten zerlegter Hilfedateien kann eine Verletzung
  228. des Urheberrechtes bedeuten.
  229. The use of parts of decompiled help files may constitute a violation of
  230. copyright law.
  231.  
  232. Version 2.1:
  233. macros may contain rtf meta characters
  234. Win95 topic names may contain (nearly) all characters
  235. 0x8000 in SWin->Maximize allowed
  236. ForeHelp creates PhrIndex/PhrImage _and_ _empty_ Phrases file
  237. HCRTF complained about > footnotes before # footnotes
  238. macro parsing changed again
  239.  
  240. Version 2.0:
  241. Guess context ids from titles and keywords based on idea of Bent Lynggaard
  242. Recompiled 16 bit EXE without register calling convention. BC++ 3.1 bug.
  243. Doesn't print last (stray) topic of HC30 help files
  244. Can list entry points into this help file (option /l)
  245.  
  246. Version 1.9: faster & better than ever...
  247. changed TopicPos, TopicOffset, Keyword maintenance
  248. changed unhash to 40 bit integer arithmetic
  249. fixed keyword footnotes [Bent Lynggaard]
  250. no [ALIAS] in MVP files
  251. no hidden text in option /r RTF files
  252. some changes in font and stylesheet handling
  253. corrects rounding error of HC31 on negative values
  254. handles non-underlined topic jumps
  255.  
  256. Version 1.8: used some spare days to clean up the to-do list...
  257. better tracking of TopicOffset during decompilation
  258. lists and checks references to external files, shows referencing topics
  259. can add annotations from .ANN file to decompiled .RTF file
  260. fixed bug in handling of pictures containing JumpId-macro hotspots
  261. changed parsing of macros (3rd attempt to guess what Microsoft did)
  262. fixed bug in popup/jump to external file / secondary window
  263. fixed bug in > footnote / |VIOLA internal file handling
  264. fixed bug in keyword assignment
  265. now removes LZ77 compression from exported SHGs/MRBs
  266. recreates Win 95 (HCW 4.00) [MACROS] section from internal |Rose file
  267. 32 bit version available
  268. handles LANGUAGE, [CHARTAB] and [GROUP] section of media view files
  269.  
  270. Version 1.7
  271. removed unneccessary output statement
  272.  
  273. Version 1.6 can now check references to external help files plus:
  274. duplicate macro names preceeding picture hotspot info skipped
  275. does not write Win95 commands to multi-media help project files
  276. changed unhash to circumvent Microsoft-C++ float rounding error
  277. handles keywords defined inside topic text
  278.  
  279. Version 1.5
  280. fixed static on buffer of TopicName function (affected HC30 files)
  281.  
  282. Version 1.4 fixes some bugs reported by different users:
  283. buffer overflow in expanding LZ77&RunLen (byPacked 3) images fixed
  284. embedded images {bmxwd} larger than 32k supported
  285. extract topic names from jump into external file if no file specified
  286. handles more phrases on HCRTF generated (Win95) help files
  287. Windows 3.1 (HC31) |Phrases always Zeck compressed
  288. LinkData2 buffer enlarged 1 byte to store trailing NUL character
  289.  
  290. Version 1.3
  291. parses examples of {bmc} etc. statements contained in help text correctly
  292. can now generate a *.CNT content file for Windows 95 / WinHlp32
  293. Microsoft C: ctype macros (isalnum/isprint) don't work with signed char
  294.  
  295. Version 1.2 fixes some severe bugs introduced in version 1.1 and:
  296. tells you which help compiler to use
  297. collects multiple keyword footnotes into single lines
  298. handles \r\n in COPYRIGHT
  299. converts SPC-macro (but only in [CONFIG] section)
  300. does not generate duplicate MAP-statements if possible
  301. {button} and {mci,mci_left,mci_right} commands supported
  302. [BITMAP]-section in HCRTF help files irritated transparent bitmaps
  303.  
  304. Version 1.1 now supports more features of Win95/HCRTF 4.00/WinHlp32:
  305. Supports LCID, CHARSET, AUTO-SIZE HEIGHT, CNT, INDEX_SEPARATORS
  306. Additional Win95 Macros (to extract original topic names)
  307. [CONFIG:n] of Win95 supported (internal file |CFn)
  308. Secondary windows with > footnote supported (internal file |VIOLA)
  309. Transparent bitmaps supported (bmct,bmlt,bmrt)
  310. Expanded internal limits as HCRTF allows larger items
  311. Now does RunLen compressed device dependend bitmaps
  312. Bugs in handling of metafiles removed
  313. Bug in placement of pack(1) removed
  314. Parsing of macros changed (is it really better now ?)
  315.