Re: Problem with Help system in Eclipse 3.3.1.1 [message #471460] |
Sun, 20 January 2008 05:06 |
Eclipse User |
|
|
|
Originally posted by: nospam_kowalskilee.gmail.com
Anand Narasimhan wrote:
> Hi,
>
> I am seeing a strange problem in the help system in 3.3.1.1. In our RCP
> application, we have online help. If I click on a topic in the contents
> window, the help for the wrong topic is shown. For example if I have the
> following topics
>
> Main Topic
> - Sub Topic 1
> - Sub Topic 2
> - Sub Topic 3
> - Sub Topic 4
>
> If I click on Sub Topic 1, I see a document with just a title that says
> "What's New"
>
> If I click on Sub Topic 3, I see the contents for Sub Topic 1
> If I click on Sub Topic 4, I see the contents for Sub Topic 2
>
> and so on.
>
> The same help plug-ins seems to work fine in 3.2 and 3.4.
> Is there a bug in 3.3 in the help system that would cause this problem?
>
> Thanks
> Anand
>
I'm adding the eclipse.platform.ua newsgroup to this thread, as that
newsgroup covers the help system.
Anand, can you provide here the portion of your toc.xml file that has
the contents that is related to the "Main Topic" and "Sub Topics" that
are showing this behavior?
I'm not aware of any bug in 3.3 that would cause this particular
problem. Do you have a document with a title that is "What's New"? Did
the toc.xml file get changed somehow without shutting down and
restarting the application? Are you starting up with the the osgi
parameter -clean to refresh the Eclipse configuration state between
startups/shutdowns?
--Lee Anne
|
|
|
Re: Problem with Help system in Eclipse 3.3.1.1 [message #471462 is a reply to message #471460] |
Sun, 20 January 2008 18:53 |
Anand Narasimhan Messages: 104 Registered: July 2009 |
Senior Member |
|
|
Hi Lee Anne,
Thanks for the reply. The documentation plugins are written by another
team. I am trying to debug for them. I am still trying to understand the
problem myself.
Here is the information you wanted.
There are two plugins where the contents are distributed. The base
plugins defines primary TOC like this.
<?xml version="1.0"?>
<plugin
name = "%pluginName"
id = "com.cisco.nm.cmp.client.doc.base"
version = "1.0.0"
provider-name="%providerName">
<!-- ============================================== -->
<!-- Define the main book -->
<!-- ============================================== -->
<extension point="org.eclipse.help.toc">
<toc file="book.xml" primary="true" />
</extension>
<!-- =============================================== -->
<!-- Link the sections into the book -->
<!-- =============================================== -->
<extension point="org.eclipse.help.toc">
<toc file="book-isdk.xml" />
<toc file="book-vsdk.xml" />
</extension>
</plugin>
The book.xml has the following:
<toc label="Cisco Active Network Abstraction (ANA) Help" topic="book.html">
<!-- *************************** -->
<!-- What's New -->
<topic label="What's New">
<anchor id="Base-new" />
<anchor id="anchor-new" />
</topic>
<!-- *************************** -->
<!-- Overview -->
<topic label="Overview">
<anchor id="Base-over" />
<anchor id="anchor-over" />
</topic>
<!-- *************************** -->
<!-- Getting Started -->
<topic label="Getting Started">
<anchor id="Base-getstart" />
<anchor id="anchor-getstart" />
</topic>
<!-- *************************** -->
<!-- Device and Network Management -->
<topic label="Device and Network Management">
<anchor id="Base-devmgmt" />
<anchor id="anchor-devmgmt" />
</topic>
<!-- *************************** -->
<!-- Configuration Management -->
<topic label="Configuration Management">
<anchor id="Base-config" />
<anchor id="anchor-config" />
</topic>
</toc>
They don't have the "What's new" and "Getting Started" contents yet.
According to the documentation team, if a topic listed in the book.xml
is not installed, eclipse 3.2 or 3.4, would ignore those, but in 3.3 it
seems work differently.
In this case, since "What's new" is not installed, clicking on
"Overview" seems to be looking for "What's New" topic.
Thanks
Anand
Lee Anne wrote:
> Anand Narasimhan wrote:
>> Hi,
>>
>> I am seeing a strange problem in the help system in 3.3.1.1. In our
>> RCP application, we have online help. If I click on a topic in the
>> contents window, the help for the wrong topic is shown. For example if
>> I have the following topics
>>
>> Main Topic
>> - Sub Topic 1
>> - Sub Topic 2
>> - Sub Topic 3
>> - Sub Topic 4
>>
>> If I click on Sub Topic 1, I see a document with just a title that
>> says "What's New"
>>
>> If I click on Sub Topic 3, I see the contents for Sub Topic 1
>> If I click on Sub Topic 4, I see the contents for Sub Topic 2
>>
>> and so on.
>>
>> The same help plug-ins seems to work fine in 3.2 and 3.4.
>> Is there a bug in 3.3 in the help system that would cause this problem?
>>
>> Thanks
>> Anand
>>
>
> I'm adding the eclipse.platform.ua newsgroup to this thread, as that
> newsgroup covers the help system.
>
> Anand, can you provide here the portion of your toc.xml file that has
> the contents that is related to the "Main Topic" and "Sub Topics" that
> are showing this behavior?
>
> I'm not aware of any bug in 3.3 that would cause this particular
> problem. Do you have a document with a title that is "What's New"? Did
> the toc.xml file get changed somehow without shutting down and
> restarting the application? Are you starting up with the the osgi
> parameter -clean to refresh the Eclipse configuration state between
> startups/shutdowns?
>
> --Lee Anne
--
____________________________________________________________ _____________________
Anand Narasimhan
anandn@cisco.com
|
|
|
|
|
|
|
|
|
|
Re: Problem with Help system in Eclipse 3.3.1.1 [message #606955 is a reply to message #471460] |
Sun, 20 January 2008 18:53 |
Anand Narasimhan Messages: 104 Registered: July 2009 |
Senior Member |
|
|
Hi Lee Anne,
Thanks for the reply. The documentation plugins are written by another
team. I am trying to debug for them. I am still trying to understand the
problem myself.
Here is the information you wanted.
There are two plugins where the contents are distributed. The base
plugins defines primary TOC like this.
<?xml version="1.0"?>
<plugin
name = "%pluginName"
id = "com.cisco.nm.cmp.client.doc.base"
version = "1.0.0"
provider-name="%providerName">
<!-- ============================================== -->
<!-- Define the main book -->
<!-- ============================================== -->
<extension point="org.eclipse.help.toc">
<toc file="book.xml" primary="true" />
</extension>
<!-- =============================================== -->
<!-- Link the sections into the book -->
<!-- =============================================== -->
<extension point="org.eclipse.help.toc">
<toc file="book-isdk.xml" />
<toc file="book-vsdk.xml" />
</extension>
</plugin>
The book.xml has the following:
<toc label="Cisco Active Network Abstraction (ANA) Help" topic="book.html">
<!-- *************************** -->
<!-- What's New -->
<topic label="What's New">
<anchor id="Base-new" />
<anchor id="anchor-new" />
</topic>
<!-- *************************** -->
<!-- Overview -->
<topic label="Overview">
<anchor id="Base-over" />
<anchor id="anchor-over" />
</topic>
<!-- *************************** -->
<!-- Getting Started -->
<topic label="Getting Started">
<anchor id="Base-getstart" />
<anchor id="anchor-getstart" />
</topic>
<!-- *************************** -->
<!-- Device and Network Management -->
<topic label="Device and Network Management">
<anchor id="Base-devmgmt" />
<anchor id="anchor-devmgmt" />
</topic>
<!-- *************************** -->
<!-- Configuration Management -->
<topic label="Configuration Management">
<anchor id="Base-config" />
<anchor id="anchor-config" />
</topic>
</toc>
They don't have the "What's new" and "Getting Started" contents yet.
According to the documentation team, if a topic listed in the book.xml
is not installed, eclipse 3.2 or 3.4, would ignore those, but in 3.3 it
seems work differently.
In this case, since "What's new" is not installed, clicking on
"Overview" seems to be looking for "What's New" topic.
Thanks
Anand
Lee Anne wrote:
> Anand Narasimhan wrote:
>> Hi,
>>
>> I am seeing a strange problem in the help system in 3.3.1.1. In our
>> RCP application, we have online help. If I click on a topic in the
>> contents window, the help for the wrong topic is shown. For example if
>> I have the following topics
>>
>> Main Topic
>> - Sub Topic 1
>> - Sub Topic 2
>> - Sub Topic 3
>> - Sub Topic 4
>>
>> If I click on Sub Topic 1, I see a document with just a title that
>> says "What's New"
>>
>> If I click on Sub Topic 3, I see the contents for Sub Topic 1
>> If I click on Sub Topic 4, I see the contents for Sub Topic 2
>>
>> and so on.
>>
>> The same help plug-ins seems to work fine in 3.2 and 3.4.
>> Is there a bug in 3.3 in the help system that would cause this problem?
>>
>> Thanks
>> Anand
>>
>
> I'm adding the eclipse.platform.ua newsgroup to this thread, as that
> newsgroup covers the help system.
>
> Anand, can you provide here the portion of your toc.xml file that has
> the contents that is related to the "Main Topic" and "Sub Topics" that
> are showing this behavior?
>
> I'm not aware of any bug in 3.3 that would cause this particular
> problem. Do you have a document with a title that is "What's New"? Did
> the toc.xml file get changed somehow without shutting down and
> restarting the application? Are you starting up with the the osgi
> parameter -clean to refresh the Eclipse configuration state between
> startups/shutdowns?
>
> --Lee Anne
--
____________________________________________________________ _____________________
Anand Narasimhan
anandn@cisco.com
|
|
|
|
|
|
|
|
|
|
Powered by
FUDForum. Page generated in 0.06790 seconds