Get the ODFDOM source code from the odfdom~developer Mercurial repository. Please see below for a short introduction to using Mercurial on odftoolkit.org. There's also a more general help on how to use source control systems on odftoolkit.org. The command
-

hg clone https://odftoolkit.org/hg/odfdom~developer

will download the repository into a new directory.
-Please note that by this you'll get the latest changeset. If you for example want stable release 0.8.6, you may want to use

hg clone https://odftoolkit.org/hg/odfdom~developer -r v0.8.6

+hg clone https://odftoolkit.org/hg/odfdom~developerwill download the repository into a new directory.
+Please note that by this you'll get the latest changeset. If you for example want stable release 0.8.6, you may want to use
+hg clone https://odftoolkit.org/hg/odfdom~developer -r v0.8.6

ODFDOM Developers however always work on the latest changeset.
@@ -121,8 +122,8 @@ Now get and install Java / JDK 5 (you might use JDK 6 if you do not recontribute)
+

Start Netbeans, choose "File->Open Project.." from the Netbeans menu and select the ODFDOM directory.
As the ODFDOM source bundle comes together with Netbeans project files, ODFDOM opens as a pre-configured project.
-You still have the opportunity to work solely with [http://maven.apache.org/ Maven] directly on the command line instead having the IDE GUI comfort provided by Netbeans.

+You still have the opportunity to work solely with Maven directly on the command line instead having the IDE GUI comfort provided by Netbeans.
-

Since Netbeans 6.1 the [http://wiki.netbeans.org/MercurialVersionControl Mercurial plugin] is part of the IDE, which help you to track the changes being made and ease providing patches. Select in the menu among 'Versioning' the desired Mercurial commands.

+

Since Netbeans 6.1 the Mercurial plugin is part of the IDE, which help you to track the changes being made and ease providing patches. Select in the menu among 'Versioning' the desired Mercurial commands.

After the commitment of your changed files, you need to pull the latest updates from the server, perhaps merge them with your changes and finally push your changes to the repository using in the menu Versioning->Mercurial->Share->Push Other...
-and adding
-https://myUserName:myPassword@odftoolkit.org/hg/odfdom~developer
-

// If there are no local changes: Update
+ hg clone https://odftoolkit.org/hg/odfdom~developer [new folder name]
+ // See if there are updates
+ hg in
+ // See if you have local changes
+ hg status
+ // If there are no local changes: Update
hg pull
- hg update

@@ -221,7 +220,7 @@ To allow a customized indentation within
For instance, Svante uses a 4 whitespace indent by TABs configured within Netbeans.

Line Feed
There have been recently problems with merging sources using Mercurial when working with different platforms (windows/unix).
-For this reason, some additional [[#Get_and_Build_the_Source_Code|Mercurial configuration]] shall be used to unify the interal line feed handling.

+For this reason, some additional Mercurial configuration shall be used to unify the interal line feed handling.

Current and Future Work

Especially the convenient layer will grow on demand. As ODFDOM should be the base of many future ODF projects, a high quality is desired. Therefore automatic tests are obligatory for all new sources of the Java reference implementation.

The ODFDOM Code Generator is used to generate the core Classes for ODFDOM which are a typed mapping of the ODF elements on real Java Classes. For the future we also plan to generate ODFDOM e.g. C# ( .NET ) for other programming languages with this generator. Take a look at this page [[ODFDOM-Code-Generator|(ODFDOM Code Generator)]] to see how the generator works in general (will be updated soon). We are moving toward treating the code generator as a separate component. The repository [http://odftoolkit.org/hg/odfdom~relaxng2template] is the new home of the code generator. It may move to its own project on this site at some point.

+

The ODFDOM Code Generator is used to generate the core Classes for ODFDOM which are a typed mapping of the ODF elements on real Java Classes. For the future we also plan to generate ODFDOM e.g. C# ( .NET ) for other programming languages with this generator. Take a look at this page ODFDOM Code Generator to see how the generator works in general (will be updated soon). We are moving toward treating the code generator as a separate component. The repository http://odftoolkit.org/hg/odfdom~relaxng2template is the new home of the code generator. It may move to its own project on this site at some point.