[LogoForum] RFC: Is it too early to change FMSLogo's documentation from .HLP to .CHM?
The message below is being cross-posted from LogoForum.
Date: Wed, 25 Jan 2006 06:32:06 -0000
From: "david_costanzo" <david_costanzo@xxxxxxxxx>
Subject: RFC: Is it too early to change FMSLogo's documentation from
.HLP to .CHM?
I am strongly considering changing FMSLogo's documentation from .HLP
to .CHM. Does anyone have any thoughts on this?
Why this is important:
WinHelp files are generated from RTF. FMSLogo's RTF file is difficult
to manage--it is over 700 pages long and takes *minutes* to load in
OpenOffice. Because RTF doesn't diff well, whenever I make a change,
it's hard to know exactly what change I made. I am also afraid I will
accidently break the documentation whenever I fix it.
To address this problem, I recently ported the RTF to an XML-based
format called DocBook, which can be used to generate .CHM files, RTF,
HTML, PDF, and several other formats. Unfortunately, I just found out
that the RTF produced by DocBook cannot be used to generate HLP
files (without a lot of additional development time on my part). So,
to take advantage of DocBook, I'd have to use CHM.
The more open the better. But when you mark a word and press F1 will
it still show the descrition of that word in the Manual?
Daniel
*****************************
OpenWorld Learning
http://www.openworldlearning.org
LogoForum messages are archived at:
http://groups.yahoo.com/group/LogoForum
.
Relevant Pages
- RE: [LogoForum] RFC: Is it too early to change FMSLogos documentation from .HLP to .CHM?
... As the documentation will be easier to generate, will offer more formatting possibilities I would vote for CHM. ... The important thing is that CHM is widely used format and so there is a good chance that when you will later want to upgrade the online help to some future system, there will probably be enough possibilities. ... CHM files may also be a little slower than HLP files. ... FMSLogo's RTF file is difficult to manage--it is over 700 pages long and takes *minutes* to load in OpenOffice. ...
(comp.lang.logo) - [LogoForum] RFC: Is it too early to change FMSLogos documentation from .HLP to .CHM?
... CHM files are the newer form of Windows ... CHM files have replaced .HLP files. ... enabling the support. ... FMSLogo's RTF file is difficult to manage--it is over 700 pages long and takes *minutes* to load in OpenOffice. ...
(comp.lang.logo) - Re: Where is code for F1 Help text?
... the HelpFile property belongs to the VBA project rather than the form. ... HLP is the older format, used by the WinHelp system that's vbeen ... CHM is used by the more modern HTML Help system, ... If it points to a HLP or CHM file, ...
(microsoft.public.word.vba.general) - Re: Where is code for F1 Help text?
... In Windows applications, F1 Help text is normally stored in compiled ... HLP is the older format, used by the WinHelp system that's vbeen ... CHM is used by the more modern HTML Help system, ...
(microsoft.public.word.vba.general) - HelpSmith 2.1.4
... HelpSmith is an innovative help authoring tool which you can use to ... create CHM HTML Help files, Web Help systems, and Printed Documents ... HelpSmith enables creating documentation from scratch and also lets ...
(comp.software.shareware.announce) |
|
