Merkinnän ohje ja selvitys

Ohjeaiheessa Resurssien merkinnät kerrottiin, miten lisäosat voivat määrittää erityisiä merkintälajeja tietojen resursseihin lisäämistä varten.  Readme-työkalun esimerkki määrittää omat merkintänsä havainnollistukseksi kahdesta merkintään liittyvästä työympäristön laajennuksesta:  merkinnän ohje ja merkintöjen selvitykset.  Merkinnän määritys on readme-lisäosan manifest-merkinnöissä:

<extension id="readmemarker" point="org.eclipse.core.resources.markers" name="%ReadmeMarker.name">
	<super type="org.eclipse.core.resources.taskmarker"/>
	<super type="org.eclipse.core.resources.textmarker"/>
	<persistent value="true"/>
	<attribute name="org.eclipse.ui.examples.readmetool.id"/>
	<attribute name="org.eclipse.ui.examples.readmetool.level"/>
	<attribute name="org.eclipse.ui.examples.readmetool.department"/>
	<attribute name="org.eclipse.ui.examples.readmetool.code"/>
	<attribute name="org.eclipse.ui.examples.readmetool.language"/>
</extension>   

Työkalu määrittä merkinnän, joka periytyy ympäristön tekstimerkinnästä ja tehtävämerkinnästä.  Se määrittää myös nimetyt määritteet merkinnälle.   Merkinnän määritteet voi asettaa ja kysellä.

Koska uusi readme-merkintä on eräänlainen tekstimerkintä, se perii tekstimerkinnän määritteet.  Tekstimerkinnän määritteet sisältävät merkinnän merkin paikan.

Merkinnät voi lisätä .readme-tiedostoon readme-muokkausohjelman ponnahdusvalikon avulla.  (Ponnahdusvalikon toiminnot lisätään dynaamisesti ReadmeTextEditor.editorContextMenuAboutToShow(IMenuManager parentMenu))-metodiin.  Kun merkinnät on lisätty, ne näkyvät muokkausohjelman vasemmalla puolella ja tehtävänäkymässä.

Readme-muokkausohjelma ja readme-merkinnät vasemman reunan viivaimessa