Developers Blog - LANDIS-II
Like Lesley, I used this document as a guide for installing TortoiseGit. Note in the pre-requisites that you should install Git for Windows before installing TortoiseGit. I did NOT need to download the Windows Installer 4.5.
Then I used these directions to generate and save the SSH keys needed to commit code without using a password every time. The directions worked perfectly, except for Step 3. Right before #2 in Step 3 (Add key), I had to insert an additional command from this website:
To CLONE a local copy of a repository (i.e. download a copy of the code to your computer), you will need the repository url. This can be found online on the right-hand side of a repository's web page. Keep in mind that currently all the succession extensions are grouped together so the url to download the code is here. Right now, you have to download the code for ALL the succession extensions to be able to modify one of them.
Like with Torroise SVN, you make a folder on your computer, then right click on it to pull up a drop-down menu. Click on Git Clone, which will pull up a menu that will prompt you for the GitHub repository URL. Hit OK and it should start downloading the code.
To commit your changes to the GitHub repository, click on the folder and click on Git Commit... Master. When that's finished, click on Git Synch and click on Push to "push" your revised code back to GitHub
Now that we have transitioned to GitHub, we are adding guidelines for the use of the various repositories under the The LANDIS-II Foundation GitHub page. All people with commit access to any of these code repositories (currently on GitHub) are expected to follow these rules or risk having their permissions revoked by the Technical Advisor Committee (Robert Scheller, Brian Sturtevant, Jonathan Thompson).
The Technical Advisor Committee (TAC), as established by The LANDIS-II Foundation, has instituted the following rules as of July 2015.
1. For every extension (disturbance, output, and succession), there is a single party (an individual or a team of people like a lab or research group) who is responsible for its maintenance (including source code, installers, and documentation). This party is listed as the Contact (or 'Maintainer') on the extension web site.
2. Any proposed changes to an extension must be communicated to the Contact.
3. Any actual changes to the 'trunk' of the extension (including source code, installers, and documentation) must receive written prior approval by the Contact. Note: All committers can create code branches without approval.
4. The LANDIS-II core, and its associated libraries, documentation, and installers are maintained together; they are referred to collectively as the ‘Core Framework’. For the purpose of these guidelines, the TAC is the Maintainer of the Core Framework. Any changes to the Core Framework’s trunk requires the consent of the TAC. As with extensions, all committers can create code branches without approval.
5. For libraries that are not used by the Core Framework (‘extension libraries’, e.g., the Metadata library), their Maintainers are listed in the GitHub wiki. If a Maintainer is not listed, the TAC is the Maintainer. Any actual changes to the trunk of the library (including source code, installers, and documentation) must receive written prior approval by the Maintainer. The Maintainer is responsible for communicating any proposed changes to all developers who use the library.
6. We encourage developers to release old (tagged) versions of extensions and current versions of libraries on GitHub. However, current versions of extensions are only to be released via the official LANDIS-II web site.
The LANDIS-II repositories are moving to GitHub (thanks Marc!) because Google is shutting down their current location. I was using TortoiseSVN with google code so am learning TortoiseGit. I have been using GitHub's Windows client for another project and it has worked OK but seems to lack some of the more complex functions. So far, however, it appears that the two clients can be installed side-by-side with no consequences.
I used this document as a guide for installing TortoiseGit. Note in the pre-requisites that you should install Git for Windows before installing TortoiseGit.
I used this document as a introductory guide for using TortoiseGit. Note that after I followed the instructions in the aforementioned document, all of the installation steps had been completed. You do need to create public and private SSH keys for GitHub. You can save the public key to your user account on the GitHub web page. Save the private key to your local computer. When you clone your first repository, check the "Load Putty Key" box to supply the path to your private key for TortoiseSVN.
To CLONE a local copy of a repository, you will need the repository url. This can be found online on the right-hand side of a repository's web page. This document provides additional information about repository urls.
Saving your changes in TortoiseGit is a 2-step process. First you COMMIT your changes to your local copy. Second, you can SYNC your changes with the remote repository in GitHub. GitHub will ask you for your user name and password every time you do a sync. You can cache this information in TortoiseGit for each repository using the procedures in this document.
I am trying to debug a question with Landis Core. These are the steps I had to take to get the core to run in the debugger:
1. Copy the Landis.Console-6.1.exe.config file to the build directory
2. Set the Console project as the debug project
3. Copy gdal_csharp.dll to the build directory to avoid the gdal error
4. Add the following lines to App.cs to avoid the gdal error
5. Copy extensions.xml and installed extensions to the build directory
LANDIS-II documentation maintains the version number in a custom Word field. The process of updating this field is not straightforward for the uninitiated and I keep forgetting how to do it. These instructions are for Word 2010
This post summarizes a conference call with Jimm Domingo to transfer knowledge of the new Landis-II library release process:
When debugging the Base Harvest extension, I found that many of the IDE menu options were unavailable including "Go To Definition". The "solution" was to close the C# solution, delete the hidden .suo file associated with the C# solution, open the C# solution, and finally rebuild the C# solution.
Open an MS-DOS command prompt and type SET. This lists all the environment variables currently set and their values. Much faster than navigating through the Control Panel dialogs.
1-10 of 54