X-Git-Url: https://mograsim.net/gitweb/?a=blobdiff_plain;f=docs%2Fdevelopment_environment.md;h=50d8b4fecc0a109da07c71b2c9c946e25585cc2c;hb=d66f2f193cf939604faefd02e4b6581dfc786e1c;hp=041c6a210682f84a843d45c085da2d1ef9451d8c;hpb=f72e7f0706149d0413e7c607b861022ea7480cc1;p=Mograsim.git
diff --git a/docs/development_environment.md b/docs/development_environment.md
index 041c6a21..50d8b4fe 100644
--- a/docs/development_environment.md
+++ b/docs/development_environment.md
@@ -1,6 +1,6 @@
# Mograsim Development Environment
-_Mograsim Development Documentation Version 0.3 --- 2019-09-27_
+_Mograsim Development Documentation Version 0.4 --- 2019-10-17_
A short guide to the Mograsim Maven Tycho configuration and Maven Tycho in general,
as well as some information on Eclipse Plugin Development and OSGi.
@@ -44,11 +44,6 @@ Roughly, an OSGi bundle has:
definition used for the build and the same that maven is run with ( -> check the
Run Configuration)
-## Eclipse Plugins
-
-- Short explanation of the different names and terms used in Eclipse Plugin Dev,
- and short introduction to the different mechanisms used.
-
## Mograsim Structure
The tree of Mograsim projects:
@@ -154,20 +149,21 @@ A short guide to the [Maven goals (Maven Lifecycle)](https://maven.apache.org/gu
- I recommend running `clean verify` or `verify`, this will do everything up to and
including the testing.
-Please note that Tycho 1.5.0 is not released yet, and thus requires a workaround.
-More information can be found under [Maven Core Extension Problems](#mceps).
-
## Challenges
Not everything is as simple as it seems at first glance.
-### Maven Core Extension Problems
+### Maven Core Extension Problems
+
+Context: Tycho 1.5.0 was not released, and thus required a workaround.
+This Problem may appear again, maybe with a different core extension, so this section
+explains the problem, how to diagnose it and a fairly good workaround.
The Tycho extra `tycho-pomless` is a Maven core extension allows for simpler structure
and less redundancy. Maven core extensions must be available at [the central maven repository](http://repo.maven.apache.org/maven2/)
(or already in the local repository), you cannot specify an alternative remote repository
in `.mvn/extensions.xml`. If a core extension cannot be resolved, you will get currently
-(Maven 3.6.2) only a warning like
+(Maven 3.6.1) only a warning like
> [WARNING] The POM for org.eclipse.tycho.extras:tycho-pomless:jar:1.5.0-SNAPSHOT is missing, no dependency information available
@@ -222,7 +218,7 @@ in it need to be build, too. But not only that, they need to use the same config
for the build, which is problematic if you do not have control over them. The solution
only exists with Tycho 1.5.0 (currently only as snapshot), where deep folder structures
are automatically scanned and poms get gnereated; not every folder requires an aggregator
-pom. This however requires (at the moment) certain naming conventions (see section
+pom. This however **requires** (at the moment) certain naming conventions (see section
on Tycho itself).
In our case, [SWTHelper](https://github.com/Haspamelodica/SWTHelper) is a git submodule