Hi Bruce
After reading your reply in this thread, I spent some time
comparing a few sample topics in each of the .doc, .chm, .hlp,
and .rtf (an older version of the .rtf which you uploaded)
to assess what might be required.

Bruce wrote:
> This is tricky as there are actually three sources
> which I maintain manually:  the .doc, the .rtf,
> and a set of html files for the chm.
> You would need to go through all three and make the
> changes in each.

Ah, there is more to it than I thought. Not too much though.

> The html files comprise a separate file per topic,
> with obscure names assigned by a mechanized converter,
> so you need a text search program if you are looking
> for specific text to change to keep in parallel with the rtf.

Not a problem: UltraEdit has "Find in files".

> You also need to use simple HTML tags like <br>
> to keep the formatting right.

I'm not experienced with html. However that just means that I
should be less ambitious, limiting myself to correcting typos,
etc, not attempting any reformatting or rearrangements.
By limiting the scope of my corrections, and by editing the
.html files in a plain text editor rather than in some fancy
wysiwyg html processor, I'm confident I can do it without
damaging the html code.

Similarly in the .doc: I shouldn't attempt to rationalize the
formatting, such as the usage of Styles; only fix typos in
the text.

Anyway, I didn't intend any rewriting;
unlike in the PPdb
the result should still be in your style, not mine.

Thus I will be able to keep my small corrections consistent
between all three -- .rtf, .doc and .html.

> Would you want to do this triple editing with work version being HTML.

Yes
______________________________________________________

Actually, it looks like the .rtf (source for .hlp)
is the Primary document, from which the .doc
and the .html's (source for .chm) are derived.

I assume Help is primary (meaning: where there are
differences, Help is correct) because a few topics in .hlp
are missing from the .doc and/or from the .chm.
For example "New for this release" in .chm refers you
to .hlp.
___________________________________________________

By the way, the newest topic "Maintaining Configuration
using Text Files" is listed in the Contents of .hlp
but not in the Contents of .chm (the topic does exist
in .chm though, if you search for it).
___________________________________________________

By the way, there's a weird phenomenon in the latest .hlp
in versions 3.8.14 and 3.8.15.
In "Maintaining Configuration using Text Files",
the first paragraph after the heading "File Format For Text
Configuration of Hot Keys" doesn't soft-wrap. You have to
use the horizontal scroll bar to read it.

It's the same with the third paragraph after the heading
"File Format For Text Configuration of Command Lists"
starting "The properties section should come first in ..."

That's very strange -- in most document types, word wrap
is not something which can be turned on/off for individual
paragraphs, only toggled for how the document as a whole
is viewed. Without seeing the current .rtf source, I can't
guess what has caused that.

As far as I was aware, the only kind of .rtf source para
which will not wrap in the resulting .hlp product is a table.
(That can be seen if you resize the Help window too narrow for
a table, such as the table of keywords in "Resource Usage Displays").
___________________________________________________

Hearing that you must maintain three sources
and add new matter to each of them individually
makes me think you are very generous to provide
a .chm and a .doc as well as .hlp.

Making my nit-picking corrections identically to all three
will be much less work for me than your work in creating them
so the offer is still on.
__________________________________________________

What version of MS Word are you using?
I have OfficeXP here.
I ask that because I suspect simply Opening and then Saving
in a different version from yours (even with no edits)
probably changes a .doc and even an .rtf file.
RTF specs changed between 98 and 2000.

I assume you edit and save the .rtf from MS Word.
(Atlantis, etc, produce a slightly different .rtf file)

If you use Word from OfficeXP or 2000, I assume you don't have
the setting in Options|Save "Disable features introduced after"
checked.
__________________________________________________

Alan M





------------------------ Yahoo! Groups Sponsor --------------------~--> 
Yahoo! Domains - Claim yours for only $14.70
http://us.click.yahoo.com/Z1wmxD/DREIAA/yQLSAA/JV_rlB/TM
--------------------------------------------------------------------~-> 

 
Yahoo! Groups Links

<*> To visit your group on the web, go to:
     http://groups.yahoo.com/group/power-pro/

<*> To unsubscribe from this group, send an email to:
     [EMAIL PROTECTED]

<*> Your use of Yahoo! Groups is subject to:
     http://docs.yahoo.com/info/terms/
 

Reply via email to