[news.eclipse.platform] Re: Help Files Offline

[Lee Anne <nospam_kowalskilee@xxxxxxxxx>]

Hi Nic,

I'm trying to understand what steps you are taking that are not giving 
you the results that you expect.

From this part that you wrote:
> I opened the indexed_docs file and found all the references to help
> being made to a Texas Instrument site:
> /com.ti.ccstudio.mainhelp.doc/html/...  This correlates with what I see
> in the bottom left hand side of the IDE Window when I put the mouse
> pointer on the Dynamic Help section I want to go into, eg. Navigation
> Aids, C/C++ Menubar, etc.

It sounds to me that you initially have the Help View open. The Help 
View is the tab view that loads in the right-most side of the main 
workbench window. The tab is usually labeled "Help  View". You can also 
open that view by going to the Help menu, and selecting "Dynamic Help" 
choice on the Help menu.

Are you able to open that Help View by going to the main Help menu and 
selecting the "Dynamic Help" choice on the Help menu?

If you are able to open that Help View by selecting Dynamic Help on the 
Help menu, then the local Online Help system is working.
(Please note that there is a difference between the choice Dynamic Help 
that's within the Help menu and the section labeled "Dynamic Help" that 
resides in the content of the Help View when it is loaded in the 
right-most side).

You go on to say:
> all the references to help
> being made to a Texas Instrument site:
> /com.ti.ccstudio.mainhelp.doc/html/...

That is *not* a "site". The com.ti.ccstudio.mainhelp.doc is an Eclipse 
*plug-in* format. It is most likely a jar file named 
"com.ti.ccstudio.mainhelp.doc". If you look into your eclipse/plugins/ 
directory, you will likely see that jar file. TI provided that Eclipse 
doc plug-in archive file to supply their TI help documentation into the 
help system. That is local help.

You wrote:
> This correlates with what I see
> in the bottom left hand side of the IDE Window when I put the mouse
> pointer on the Dynamic Help section I want to go into, eg. Navigation
> Aids, C/C++ Menubar, etc.

The fact that you wrote that you see this Dynamic Help section and can 
put your mouse pointers on it indicates that the local Help View content 
is working for you. If it wasn't, you would not be able to see any of 
those items.

What happens (in detail please) when you click on the link "Navigation 
Aids"? What precisely happens?

If you go to the Help menu and select Help Contents, what happens then? 
In detail please.

Your original posting about going to the eclipse.org site can happen 
when one of the links within that Dynamic Help section is a link to 
content at eclipse.org. The Dynamic Help section is created on-the-fly 
by Eclipse sending a phrase (usually the name of the editor or view that 
your cursor is parked in) to perform a search in multiple places: local 
help plug-in archive files, eclipse.org, and Google. When results are 
returned, Eclipse displays them as links in that Dynamic Help section. 
If you don't have any connection to the outer Internet, then any links 
that are results from the wider search won't work for you. However, 
links to the local help should work.

A final suggestion to investigate what local help documentation you have 
is that you look at the jar files that are in your eclipse/plugins 
directory and look for ones that have "doc" in any part of their names. 
Do you find any? If so, can you list them here?

--Lee Anne

Nic Bleeker wrote:
> Hi Denis & Lee Anne
>
> I appreciate you responding to my call for help.
>
> I went searching for what you term the local 'host' file, or any 
> reference to it, within the Texas Instrument CCE crafted Eclipse 
> platform.  I have been unsuccessful in my search.  I am not sure where 
> to look. After re-reading your comment I went searching thru the Windows 
> OS sw and Admin tools for a reference of this kind but without success.
>
> In the CCE directory in C:\Program Files, I found an Eclipse Directory. 
> In this I found ..\configuration\org.eclipse.help.base\index\en_us and 
> here are several files (1kB), an indexed_docs file (83kB) and a _rd.cfs 
> file (1,019kB). What would the contents of the _rd.cfs file be about 
> (not readable)?
>
> I opened the indexed_docs file and found all the references to help 
> being made to a Texas Instrument site: 
> /com.ti.ccstudio.mainhelp.doc/html/...  This correlates with what I see 
> in the bottom left hand side of the IDE Window when I put the mouse 
> pointer on the Dynamic Help section I want to go into, eg. Navigation 
> Aids, C/C++ Menubar, etc.
>
> When I go to the Welcome section and the mouse pointer is on eg. First 
> Steps or Tutorials, then a "No Entry" symbol appears next to the pointer 
> and nothing appears in the bottom left hand corner.
>
> Back to the IDE regarding what you said Lee Anne: 1) Windows -> 
> Preferences  LHS Help -> Help Server. Fields for Host Name & Server Port 
> are empty.
> 2) Windows -> Preferences  LHS General -> Welcome . I find the basic 
> structure of the initial HELP scenario defined, i.e. Home, Overview, 
> First Steps, Tutorials, etc. In little sub- windows references to 
> eclipse files or web pages are made in the form of e.g. org.eclipse.jdt 
> & org.eclipse.pde. What are these references?
>
> Does this mean that TI has changed the scenario & I must refer the 
> problem to them? Or are you still able to help me with part of the 
> problem that is still within your scope?
>
> Look forward to hearing further from you.