GNU ARM Eclipse Plug-in should contribute with an entry in Help -> Help Contents. This way user can easily access tutorials, explanations about available features, etc.
What I would like to see in addition is related to the supported toolchains (including Linaro Aarch64 that we use): from Settings page, tools explained (Compiler, Linker, etc.), options, default settings.
it looks like the solution is to duplicate the blog into the Eclipse help system. I wonder it is worth the effort... from my experience, the Eclipse help system was most of the times outdated or incomplete, in fact I never took it seriously.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Don't know what to say... sometimes I find it useful.
You can continue to keep the blog doc with the latest and complete info and add in the Eclipse help only general info that doesn't change much with a link to the blog.
Asking the other users may be of help in taking a decision.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
I integrated your patch, it is now available in the develop branch.
As for content, I plan to add it, but it might take some time, so if you, or your colleagues, contribute more patches, they will be highly appreciated.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Patch was attached with proposed table of contents.
New doc plug-in was created:
ilg.gnuarmeclipse.doc.user
ilg.gnuarmeclipse.doc.user-feature
Eclipse has a help system based on org.eclipse.help.toc extension point, some tutorials:
https://www.eclipse.org/articles/Article-Online%20Help%20for%202_0/help1.htm
http://www.vogella.com/tutorials/EclipseRCPHelpSystem/article.html
How to write eclipse documentation:
https://wiki.eclipse.org/Eclipse_Documentation
Most projects adopted more or less this sctructure of contents:
I believe the available documentation on the blog
http://gnuarmeclipse.livius.net/blog/documentation/
can be successfully accomodated here.
What I would like to see in addition is related to the supported toolchains (including Linaro Aarch64 that we use): from Settings page, tools explained (Compiler, Linker, etc.), options, default settings.
If writing xml and html files is too time consuming, they can be generated from Docbook files:
http://www.vogella.com/tutorials/DocBook/article.html
thank you, I'll study your patch and the links.
it looks like the solution is to duplicate the blog into the Eclipse help system. I wonder it is worth the effort... from my experience, the Eclipse help system was most of the times outdated or incomplete, in fact I never took it seriously.
Don't know what to say... sometimes I find it useful.
You can continue to keep the blog doc with the latest and complete info and add in the Eclipse help only general info that doesn't change much with a link to the blog.
Asking the other users may be of help in taking a decision.
I integrated your patch, it is now available in the develop branch.
As for content, I plan to add it, but it might take some time, so if you, or your colleagues, contribute more patches, they will be highly appreciated.