You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

How to become an OpenEarth developer

  • Become an OpenEarth developer. Send en email to the OpenEarth developers team (gerben.deboer at deltares dot nl) to obtain a username and password for the repository.

Get started

  • Create checkout folder and download source code
    • Create a sourcecode checkout directory on your PC (Sourcecode requires app. 1.5 GB of diskspace). For instance : f:\checkouts\OpenEarthTools\
    • In any file explorer (Total Commander recommended) rightclick (hold for 1 second) and select SVNCheckout

      If you use total commander, enable "Show overlay icons" in options to see which files were changed.

  • Enter your subversion username and password
    • Deltares users can use their Deltares login (ask the OpenEarth or McTools developers team to be added to the user list, see above).
    • External users can mail the OpenEarth developers team with a request for external username and password, see #How to become an OpenEarth developer

      If you get a question asking for the acceptance of SSL certificates select 'accept permanently'

  • In some companies/institutes your PC may be behind a proxy server. In this case tick 'Enable Proxy Server' under Settings/Network in SubVersion and add the correct proxy Server address (ask your network administrator).
  • Perform an SVN update regularly to benefit from updates by co-developers.
    • Right-mouse click on the root directory of your check-out, and choose 'SVN Update' (Fig 1).
  • Commit your updates to the repository regularly.
    • Right-mouse click on the root directory of your check-out, and choose 'SVN commit ...' (Fig 1).
    • Do not commit all your updates at once. Commit only one coherent subset at a time, and provide a concise one-line description, to make clear to co-developers what you did. You can see where commits are required where the file/dir icons display a red !-mark (as McTools directory in Fig 1), rather then a green v-mark (as OpenEarthData directory in Fig 1). Note: these handy icons only show up after enabling "Show overlay icons", see above.
    • Do not commit functions that are partly finished, only commit working stuff, because OpenEarthTools should always consists of work stuff.
  • Adding/removing/deleting complete files or directories needs to be done via SVN and NOT via your file-browers as TotalCommander.
    • Right-mouse click on the root directory of your check-out, and choose 'TortoiseSVN >' (Fig 1) and then choose from the sub-menu.
  • For Deltares users: as a developer do not use the read-only work-copy on p:\mctools to make changes. Only use your own local checkout, and fix all tiny bugs when you encounter them.


Figure 1: After installing TortoiseSVN this menu pops up when clicking yout right-mosue button.

  • No labels