Bug 224733 - Provide Help Index Editor (a la Table of Contents Editor and Context Help Editor)
Summary: Provide Help Index Editor (a la Table of Contents Editor and Context Help Edi...
Status: CLOSED WONTFIX
Alias: None
Product: PDE
Classification: Eclipse Project
Component: UI (show other bugs)
Version: 3.4   Edit
Hardware: PC Windows XP
: P3 enhancement (vote)
Target Milestone: ---   Edit
Assignee: PDE-UI-Inbox CLA
QA Contact:
URL:
Whiteboard: stalebug
Keywords: bugday
Depends on:
Blocks:
 
Reported: 2008-03-28 17:05 EDT by Lee Anne Kowalski CLA
Modified: 2019-09-09 02:31 EDT (History)
9 users (show)

See Also:


Attachments
A -very- basic EMF based help index editor (237.12 KB, application/octet-stream)
2008-10-25 13:44 EDT, Benjamin Cabé CLA
no flags Details
Sample file (8.76 KB, text/plain)
2008-10-25 13:48 EDT, Benjamin Cabé CLA
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
Description Lee Anne Kowalski CLA 2008-03-28 17:05:39 EDT
For after Eclipse 3.4:

The Help Table of Contents and Context Help Editors make it very easy to create the files and adhere to the toc and contexts DTDs for the help system.

It would be nice to have a Help Index Editor to create files that adhere to the index.xml DTD for the help system keyword index.

Someone I met at EclipseCon 2008 was telling me about all of the trouble he was having creating the keyword index files manually and thought a visual editor would be a big benefit.

--Lee Anne
Comment 1 Chris Aniszczyk CLA 2008-03-28 17:11:15 EDT
thanks for the suggestion Lee Anne
Comment 2 Lee Anne Kowalski CLA 2008-10-24 16:26:24 EDT
Hi,

Is there any current outlook on this for 3.4?

I'm giving a talk next week that includes creating everything you need for a doc plug-in (e.g., toc.xml, index.xml, contexts.xml, plugin.xml, and manifest.mf). I can show easily how to create these in the PDE *except* for index.xml. It sure would be nice to be able to include creating index.xml in that story. :-)

--Lee Anne
Comment 3 Lee Anne Kowalski CLA 2008-10-24 16:26:57 EDT
Ooops, sorry, I meant 3.5!
Comment 4 Curtis Windatt CLA 2008-10-24 16:49:38 EDT
This is not currently part of the PDE 3.5 plan.  It would be nice to round out our UA editors, but no one has committed to working on it.  Contributions are always welcome :)
Comment 5 Chris Aniszczyk CLA 2008-10-24 17:00:21 EDT
BTW, if we do this.

I would like to experiment with an EMF approach. I want to test the waters of how PDE will look with more EMF integration in the future.
Comment 6 Benjamin Cabé CLA 2008-10-25 06:36:36 EDT
> I would like to experiment with an EMF approach. I want to test the waters of
> how PDE will look with more EMF integration in the future.

You took the words right out of my mouth, Chris. I will try to investigate a bit during this week-end!
Comment 7 Benjamin Cabé CLA 2008-10-25 13:44:39 EDT
Created attachment 116134 [details]
A -very- basic EMF based help index editor
Comment 8 Benjamin Cabé CLA 2008-10-25 13:48:51 EDT
Created attachment 116135 [details]
Sample file

A the moment it is necessary to have an input file like the one attached, because I didn't yet find how to tell EMF to ignore namespaces.

The only difference between before and now is :
<?xml version="1.0" encoding="UTF-8"?>
<index:index xmlns:index="http://www.eclipse.org/pde/ua/index/1.0">
<!-- ... -->
</index:index>

instead of 

<?xml version="1.0" encoding="UTF-8"?>
<index>
<!-- ... -->
</index>
Comment 9 Benjamin Cabé CLA 2008-10-25 13:54:56 EDT
Some of the cool things that come with this approach :
- JFace databinding + EMF databinding = joy
- Undo/redo works out of the box because of the EMF commands
- ... so does the Drag&Drop
- Dirty state of the editor automatically linked to the state of the EMF command stacks (open the editor, do something, undo it => the editor is *not* dirty)
- Forms messagemanager can be bound to the status of the databinding context (not yet shown in this early prototype)
- EMF.Edit allows fine tuning on how we want to display our model in a tree, how we want the labelproviders to look like and to react to model changes, which actions we want to enable on which contextual menu, etc...)
- Implementing an Outline is very easy and can be done with a generic approach

... and, here are probably many others benefits! :)
Comment 10 Benjamin Cabé CLA 2008-10-26 16:02:30 EDT
As you will notice, there is not "source page" yet in this editor, but it shouldn't be much difficult to have one.
However, we have to try to keep the dependencies low, because we  may not want adding the full EMF (and TMF[1], perhaps..?) stack (even if it's not that huge) to PDE, thus SDK...

[1] http://www.eclipse.org/modeling/tmf/
Comment 11 Curtis Windatt CLA 2008-10-27 10:52:34 EDT
(In reply to comment #10)
> However, we have to try to keep the dependencies low, because we  may not want
> adding the full EMF (and TMF[1], perhaps..?) stack (even if it's not that huge)
> to PDE, thus SDK...

What is the plan for the editor?  The SDK can't depend on EMF (at least in the 3.5 timeframe) and EMF requires Java 5.0 which is also a problem for the SDK.  Is there are a separate project where we could make this available?

Comment 12 Chris Aniszczyk CLA 2008-10-27 10:58:43 EDT
PDE Incubator work.

In the e4 timeframe, we will most likely have EMF in the SDK so we can take advantage of it. This should serve as an experiment to see what gains we get from  using EMF. A lot of the gains are mentioned by Benjamin in comment #9... our UI code could be simplified quite a bit.
Comment 13 Benjamin Cabé CLA 2008-10-27 11:04:09 EDT
Chris, once again you took the words out of my mouth! :p

For 3.5, the only thing we could experiment is more JFace databinding, but on a POJO model ...
Comment 14 Chris Aniszczyk CLA 2008-10-28 12:30:36 EDT
Benjamin, would you be willing to become a PDE Incubator committer so you and I can continue this work in an open-source fashion and adhere to the Eclipse rules?

If so, I'll create a place for this in the PDE incubator and nominate you as a committer so we can experiment in using EMF within PDE editors. We can start small and than move onto something a bit more complex like DS.
Comment 15 Benjamin Cabé CLA 2008-10-29 06:17:20 EDT
Chris, that would be cool, I think it is a *very* interesting topic, and there is still a lot of work :)
Comment 16 Jacek Pospychala CLA 2008-10-29 06:41:51 EDT
oh my EMF in PDE. I was dying without emf working with pde.runtime view recently.   go ahead Ben!
Comment 17 Benjamin Cabé CLA 2008-10-29 11:02:50 EDT
Thanks Jacek! :)
Comment 18 Darin Wright CLA 2009-03-19 10:07:11 EDT
Nothing committed for 3.5 here. Removing milestone.
Comment 19 Eclipse Webmaster CLA 2019-09-06 15:31:59 EDT
This bug hasn't had any activity in quite some time. Maybe the problem got resolved, was a duplicate of something else, or became less pressing for some reason - or maybe it's still relevant but just hasn't been looked at yet.

If you have further information on the current state of the bug, please add it. The information can be, for example, that the problem still occurs, that you still want the feature, that more information is needed, or that the bug is (for whatever reason) no longer relevant.
Comment 20 Julian Honnen CLA 2019-09-09 02:31:46 EDT
Please remove the stalebug flag, if this issue is still relevant and can be reproduced on the latest release.