[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [Newsgroup Home]
[news.eclipse.platform.ua] Please confirm allowable link_to path structures using PLUGINS_ROOT

Hello,

Would someone on the Eclipse UA team please confirm which of the following are supposed to work when specified in the link_to attribute? And which one you would consider is a "best practice"?

Given a doc plug-in with:
pluginID = edition1_1
toc file = edition1_1.xml
anchorID in edition1_1.xml = comps

Trying to anchor into that anchorID using link_to, I see the following behaviors:

link_to="/../edition1_1/edition1_1.xml#comps       Works in Eclipse 3.4.1

link_to="/edition1_1/edition1_1.xml#comps           Works


link_to="../edition1_1/edition1_1.xml#comps Works (this is also in the help doc example in ua_help_content_nested.htm topic)


link_to="PLUGINS_ROOT/edition1_1/edition1_1.xml#comps     Works

link_to="/PLUGINS_ROOT/edition1_1/edition1_1.xml#comps     Does Not work

Now, the help topic on Content Extensions (http://help.eclipse.org/ganymede/index.jsp?topic=/org.eclipse.platform.doc.isv/guide/ua_dynamic_extensions.htm)
says that the format of the 'path" attribute is:
/pluginID/path/file.xml#elementID


So, is it a bug that link_to="/PLUGINS_ROOT/<pluginID>/<tocfile>#anchorID"
does not work?

Or is PLUGINS_ROOT not useful for contributing into an anchor?

Is the best practice to use the path attribute format? For example:
link_to="/pluginID/path/file.xml#anchorID"

Thanks in advance!
--Lee Anne