SVN Setup - Revision history

Heydowns at 18:02, 30 January 2021

2021-01-30T18:02:50Z

← Older revision		Revision as of 11:02, 30 January 2021
Line 5:		Line 5:
	== Using SVN to Access the Robot Code==		== Using SVN to Access the Robot Code==

	* ''Initial Setup''		* '''Initial Setup'''
	** Pick one of the client options from the bottom of this page and install it. The easiest client to use on Windows is [https://tortoisesvn.net/ Tortoise SVN]. These instructions assume you are using this.		** Pick one of the client options from the bottom of this page and install it. The easiest client to use on Windows is [https://tortoisesvn.net/ Tortoise SVN]. These instructions assume you are using this.
	** Install TortoiseSVN - the default options are typically fine for most people.		** Install TortoiseSVN - the default options are typically fine for most people.
Line 14:		Line 14:
	** You will be prompted to login. If you don't have a login for SVN or forgot it, ask a mentor.		** You will be prompted to login. If you don't have a login for SVN or forgot it, ask a mentor.
	** The most recent version of the robot code on the server is transferred to c:\FIRST on your computer.		** The most recent version of the robot code on the server is transferred to c:\FIRST on your computer.
	* ''Updating Your Local Copy of Code''		* '''Updating Your Local Copy of Code'''
	** Your local version of the robot code can be updated with the work others have checked into the server - ''you should do this once a day or more often when you start working''		** Your local version of the robot code can be updated with the work others have checked into the server - ''you should do this once a day or more often when you start working''
	** To update, open Windows explorer to your code location on your computer		** To update, open Windows explorer to your code location on your computer
	** Right-click the code folder and choose "SVN Update"		** Right-click the code folder and choose "SVN Update"
	** The code is updated locally - NOTE: If another person updated a file that you had made changes to as well, you may get what is known as a "Merge conflict". See "Resolving Merge Conflicts" below.		** The code is updated locally - NOTE: If another person updated a file that you had made changes to as well, you may get what is known as a "Merge conflict". See "Resolving Merge Conflicts" below.
	* ''Committing Your Changes''		* '''Committing Your Changes'''
	** Once you have made a set of changes that you want to share with the rest of the team, you will need to "commit" them to the SVN server.		** Once you have made a set of changes that you want to share with the rest of the team, you will need to "commit" them to the SVN server.
	** ''Before doing this, have your changes checked by a mentor''		** '''Before doing this, have your changes checked by a mentor!''' See the [[#Mentor Review of Code Changes\|section below on mentor review!]]
	** Open Windows Explorer to your robot code folder. Right-click the folder and choose "SVN Commit".		** Open Windows Explorer to your robot code folder. Right-click the folder and choose "SVN Commit".
	** Enter a high-level description of the changes you made (example: "Added code to run the new intake"		** Enter a high-level description of the changes you made (example: "Added code to run the new intake"
Line 46:		Line 46:
	** If you need help figuring out what edits to make to fix a conflict, ask a mentor.		** If you need help figuring out what edits to make to fix a conflict, ask a mentor.
	** Once you edit all the conflicts, you need to tell SVN you are done. This is called "Resolving" the conflict. To do this, open Windows Explorer to the code location, find the conflicted file(s), select them, then right-click and choose Tortoise SVN, then "Resolve"		** Once you edit all the conflicts, you need to tell SVN you are done. This is called "Resolving" the conflict. To do this, open Windows Explorer to the code location, find the conflicted file(s), select them, then right-click and choose Tortoise SVN, then "Resolve"
	** When you have marked all conflicts as resolved, you would to a commit ~~as normal~~ to send your changes to the server.		** When you have marked all conflicts as resolved, you would continue the normal process to make your own changes to the code. Eventually you will want to commit to send your changes to the server. Remember to have a mentor review before committing!

			== Mentor Review of Code Changes ==

			Before you commit changes to the code into SVN, a '''programming''' mentor should review the changes. When working in person, simply ask one of the '''programming''' mentors to look your changes over on the laptop you have been working on. If working remotely, follow these steps to get a mentor to look at your changes:

			# Make sure all files in VSCode are saved!
			# Do an Update from SVN before you proceed. This will make sure your changes apply cleanly with anyone else's recent changes. If you get conflicts, see the steps in the [[Using SVN to Access the Robot Code\|Using SVN section]] to resolve the conflicts.
			# These next steps will generate a "patch file" that shows the changes you've made in a concise form.
			## Open Windows Explorer to the location on your computer where your code is.
			## Right-click in Explorer and mouse over TortoiseSVN to expand the next menu. Then choose "Create Patch".
			## In the new window, make sure there is a checkmark next to all your changed files. It should do this automatically, but double-check. Especially check that any new files you are adding are checked.
			## Click OK, then browse to a location to save the "patch" file.
			# Post the newly created patch file in the programming Slack channel with a short message saying what the changes do and a mentor will take a look!
			# Once the mentor reviews and says it is ok, proceed by committing.

	== Team 1511 Subversion Repository Details ==		== Team 1511 Subversion Repository Details ==

Heydowns at 23:23, 23 January 2021

2021-01-23T23:23:11Z

← Older revision		Revision as of 16:23, 23 January 2021
Line 2:		Line 2:

	Team 1511 uses Subversion for its source code management. Subversion allows multiple developers to easily work together on a common code base, across many computer systems. On this page, you'll find the access information for our repository, as well as links to Subversion client software.		Team 1511 uses Subversion for its source code management. Subversion allows multiple developers to easily work together on a common code base, across many computer systems. On this page, you'll find the access information for our repository, as well as links to Subversion client software.

			== Using SVN to Access the Robot Code==

			* ''Initial Setup''
			** Pick one of the client options from the bottom of this page and install it. The easiest client to use on Windows is [https://tortoisesvn.net/ Tortoise SVN]. These instructions assume you are using this.
			** Install TortoiseSVN - the default options are typically fine for most people.
			** Create a folder on your computer to hold the robot code. For this example, we will use c:\FIRST
			** Open this folder in Windows Explorer, then right-click in the explorer window. In the context menu, choose "SVN Checkout"
			** In the window that opens, you need to enter the URL to the SVN repository. You can get the right URL to use in the next section of this page (each year's code uses a different URL)
			** Click OK
			** You will be prompted to login. If you don't have a login for SVN or forgot it, ask a mentor.
			** The most recent version of the robot code on the server is transferred to c:\FIRST on your computer.
			* ''Updating Your Local Copy of Code''
			** Your local version of the robot code can be updated with the work others have checked into the server - ''you should do this once a day or more often when you start working''
			** To update, open Windows explorer to your code location on your computer
			** Right-click the code folder and choose "SVN Update"
			** The code is updated locally - NOTE: If another person updated a file that you had made changes to as well, you may get what is known as a "Merge conflict". See "Resolving Merge Conflicts" below.
			* ''Committing Your Changes''
			** Once you have made a set of changes that you want to share with the rest of the team, you will need to "commit" them to the SVN server.
			** ''Before doing this, have your changes checked by a mentor''
			** Open Windows Explorer to your robot code folder. Right-click the folder and choose "SVN Commit".
			** Enter a high-level description of the changes you made (example: "Added code to run the new intake"
			** Click OK -- the changes are sent to the server.
			** You may get a message that your local version is out of date. This means you need to Update (see above section) to get the latest changes from the server before you can commit. Update, then repeat the commit.
			* ''Resolving Merge Conflicts''
			** Follow these steps if you have a merge conflict after doing an update. A merge conflict means that someone else made changes to the same part of the code that you did and SVN couldn't figure out how to automatically combine the changes in a sensible way.
			** In Windows Explorer, the files with conflicts will be marked with a special icon. Open these files in VS Code.
			** The file will have the sections in conflict marked up as follows:
			<pre>
			<<<<<<<<
			// My code I wrote or changed is here
			int my_x = 10;
			my_x++;
			========
			// The code changes by the other author will be here
			int the_other_persons_x = 20;
			the_other_persons_x++;
			>>>>>>>>
			</pre>
			** As you can see, your version of the code and the other author's changes are shown with special line markings (the <, ==, and > lines)
			** You need to edit these to produce one final version, merging things together. When you are done, you remove the special line markings, leaving only the final code.
			** Sometimes you might completely remove their edits and use yours, sometimes you might completely remove your edits because the other person did the same thing but differently, or other times you might keep both sets of changes or some mixture thereof!
			** If you need help figuring out what edits to make to fix a conflict, ask a mentor.
			** Once you edit all the conflicts, you need to tell SVN you are done. This is called "Resolving" the conflict. To do this, open Windows Explorer to the code location, find the conflicted file(s), select them, then right-click and choose Tortoise SVN, then "Resolve"
			** When you have marked all conflicts as resolved, you would to a commit as normal to send your changes to the server.

	== Team 1511 Subversion Repository Details ==		== Team 1511 Subversion Repository Details ==

Heydowns at 20:59, 23 January 2021

2021-01-23T20:59:45Z

← Older revision		Revision as of 13:59, 23 January 2021
Line 27:		Line 27:
	Links to Subversion clients:		Links to Subversion clients:

	*~~Eclipse - Eclipse can use SVN using the~~ [https://~~marketplace~~.~~eclipse.org~~/~~content/subclipse subclipse plugin~~]. ~~2009 and beyond Projects are formatted~~ to ~~work with this. To check out~~ the ~~project,~~ right click ~~the project window, choose import,~~ and ~~enter the project SVN URL from the previous section~~.		*[https://tortoisesvn.net/ Tortoise SVN] - Easy-to-use graphical client implemented as a Windows Explorer shell extension. Basically adds menu items to the Explorer right-click menues. Very convenient and user-friendly. Windows only.
	*[http://subclipse.tigris.org/servlets/ProjectDocumentList?folderID=2240 SVN] - Command-line client provided by creators of Subversion. Works on Linux, Windows, and just about everything.		*[http://subclipse.tigris.org/servlets/ProjectDocumentList?folderID=2240 SVN] - Command-line client provided by creators of Subversion. Works on Linux, Windows, and just about everything.
	*[http://tortoisesvn.tigris.org/ Tortoise SVN] - Easy-to-use graphical client implemented as a Windows Explorer shell extension. Basically adds menu items to the Explorer right-click menues. Very convenient and user-friendly. Windows only.

Heydowns: /* Team 1511 Subversion Repository Details */

2021-01-23T20:56:03Z

Team 1511 Subversion Repository Details

← Older revision		Revision as of 13:56, 23 January 2021
Line 7:		Line 7:
	We have one repository for each team-year. All repositories are accessible via http. Simple browsing can be done with a web browser; actually modifying and contributing code requires a Subversion client. When checking out your initial working copy, configure your Subversion client to use the URLs below:		We have one repository for each team-year. All repositories are accessible via http. Simple browsing can be done with a web browser; actually modifying and contributing code requires a Subversion client. When checking out your initial working copy, configure your Subversion client to use the URLs below:

			*2019-2020 and 2021 - [http://svn.penfieldrobotics.com/FRC2020/trunk http://svn.penfieldrobotics.com/FRC2020/trunk]
	*2015-2016 - [http://svn.penfieldrobotics.com/FRC2016/trunk http://svn.penfieldrobotics.com/FRC2016/trunk]		*2015-2016 - [http://svn.penfieldrobotics.com/FRC2016/trunk http://svn.penfieldrobotics.com/FRC2016/trunk]
	*2014-2015 - [http://svn.penfieldrobotics.com/FRC2015/trunk http://svn.penfieldrobotics.com/FRC2015/trunk]		*2014-2015 - [http://svn.penfieldrobotics.com/FRC2015/trunk http://svn.penfieldrobotics.com/FRC2015/trunk]
Line 21:		Line 22:

	Access requires a username and password. Access is provided to Programming Subteam members only. Please post to the Programming Build Season forum or contact Jeff if you need an account.		Access requires a username and password. Access is provided to Programming Subteam members only. Please post to the Programming Build Season forum or contact Jeff if you need an account.



	== Subversion Client Software ==		== Subversion Client Software ==

Heydowns: /* Source Code Repository Introduction */

2016-01-15T18:33:44Z

Source Code Repository Introduction

← Older revision		Revision as of 11:33, 15 January 2016
Line 1:		Line 1:
	== Source Code Repository Introduction ==		== Source Code Repository Introduction ==

	~~From 2005 to 2013,~~ Team 1511 ~~used~~ Subversion for its source code management. Subversion allows multiple developers to easily work together on a common code base, across many computer systems. On this page, you'll find the access information for our repository, as well as links to Subversion client software.		Team 1511 uses Subversion for its source code management. Subversion allows multiple developers to easily work together on a common code base, across many computer systems. On this page, you'll find the access information for our repository, as well as links to Subversion client software.



	== Team 1511 Subversion Repository Details ==		== Team 1511 Subversion Repository Details ==

Heydowns at 18:33, 15 January 2016

2016-01-15T18:33:10Z

← Older revision		Revision as of 11:33, 15 January 2016
Line 30:		Line 30:
	Links to Subversion clients:		Links to Subversion clients:

	*[~~http~~://~~www~~.~~usfirst~~.org/~~frccontrolsystem Windriver Workbench~~] ~~- Windriver Workbench includes a Subversion plugin~~. ~~2008-~~2009 ~~Projects~~ and beyond ~~repositories~~ are formatted to work with this. To check out the project, right click the project window, choose import, and enter the project SVN URL from the previous section.		*Eclipse - Eclipse can use SVN using the [https://marketplace.eclipse.org/content/subclipse subclipse plugin]. 2009 and beyond Projects are formatted to work with this. To check out the project, right click the project window, choose import, and enter the project SVN URL from the previous section.
	*[http://subclipse.tigris.org/servlets/ProjectDocumentList?folderID=2240 SVN] - Command-line client provided by creators of Subversion. Works on Linux, Windows, and just about everything.		*[http://subclipse.tigris.org/servlets/ProjectDocumentList?folderID=2240 SVN] - Command-line client provided by creators of Subversion. Works on Linux, Windows, and just about everything.
	*[http://tortoisesvn.tigris.org/ Tortoise SVN] - Easy-to-use graphical client implemented as a Windows Explorer shell extension. Basically adds menu items to the Explorer right-click menues. Very convenient and user-friendly. Windows only.		*[http://tortoisesvn.tigris.org/ Tortoise SVN] - Easy-to-use graphical client implemented as a Windows Explorer shell extension. Basically adds menu items to the Explorer right-click menues. Very convenient and user-friendly. Windows only.

Heydowns at 18:31, 15 January 2016

2016-01-15T18:31:30Z

← Older revision		Revision as of 11:31, 15 January 2016
Line 9:		Line 9:
	We have one repository for each team-year. All repositories are accessible via http. Simple browsing can be done with a web browser; actually modifying and contributing code requires a Subversion client. When checking out your initial working copy, configure your Subversion client to use the URLs below:		We have one repository for each team-year. All repositories are accessible via http. Simple browsing can be done with a web browser; actually modifying and contributing code requires a Subversion client. When checking out your initial working copy, configure your Subversion client to use the URLs below:

	*~~2013~~-2014 - [http://svn.penfieldrobotics.com/~~git~~/~~thunderbot2014~~.~~git~~ http://svn.penfieldrobotics.com/~~git~~/~~thunderbot2014~~.~~git~~] ~~(git repository)~~		*2015-2016 - [http://svn.penfieldrobotics.com/FRC2016/trunk http://svn.penfieldrobotics.com/FRC2016/trunk]
			*2014-2015 - [http://svn.penfieldrobotics.com/FRC2015/trunk http://svn.penfieldrobotics.com/FRC2015/trunk]
			*2013-2014 - [http://svn.penfieldrobotics.com/FRC2014/trunk http://svn.penfieldrobotics.com/FRC2014/trunk]
	*2012-2013 - [http://svn.penfieldrobotics.com/FRC2013/trunk http://svn.penfieldrobotics.com/FRC2013/trunk]		*2012-2013 - [http://svn.penfieldrobotics.com/FRC2013/trunk http://svn.penfieldrobotics.com/FRC2013/trunk]
	*2011-2012 - [http://svn.penfieldrobotics.com/FRC2012/trunk http://svn.penfieldrobotics.com/FRC2012/trunk]		*2011-2012 - [http://svn.penfieldrobotics.com/FRC2012/trunk http://svn.penfieldrobotics.com/FRC2012/trunk]

Programming: applied history

2015-01-28T19:24:18Z

applied history

← Older revision		Revision as of 12:24, 28 January 2015
Line 1:		Line 1:
	== Source Code Repository Introduction ==		== Source Code Repository Introduction ==

	Team 1511 ~~uses~~ Subversion for its source code management. Subversion allows multiple developers to easily work together on a common code base, across many computer systems. On this page, you'll find the access information for our repository, as well as links to Subversion client software.		From 2005 to 2013, Team 1511 used Subversion for its source code management. Subversion allows multiple developers to easily work together on a common code base, across many computer systems. On this page, you'll find the access information for our repository, as well as links to Subversion client software.

	~~<br>~~

	~~== Team 1511 Subversion Repository Details ==~~

	~~We have one repository for each team-year. All repositories are accessible via http. Simple browsing can be done with a web browser; actually modifying and contributing code requires a~~ Subversion ~~client. When checking out your initial working copy, configure your Subversion client to use the URLs below:~~		== Team 1511 Subversion Repository Details ==

	*2013-2014 - http://svn.penfieldrobotics.com/git/thunderbot2014.git (git repository)		We have one repository for each team-year. All repositories are accessible via http. Simple browsing can be done with a web browser; actually modifying and contributing code requires a Subversion client. When checking out your initial working copy, configure your Subversion client to use the URLs below:
	*2012-~~2013 - http://svn.penfieldrobotics~~.~~com/FRC2013/trunk~~
	*2011-2012 - http~~://svn~~.~~penfieldrobotics.com/FRC2012/trunk~~
	*2010-2011 - http://svn.penfieldrobotics.com/FRC2011/trunk
	*2009-2010 - http://svn.penfieldrobotics.com/FRC2010/trunk
	*2008-2009 - http://svn.penfieldrobotics.com/FRC2009/trunk
	*2007-2008 - http://svn.penfieldrobotics.com/FRC2008/trunk
	*2006-2007 - http://svn.penfieldrobotics.com/FRC2007/trunk
	*2005-2006 "ROFLbot" and ~~"CamView" - http://www.svn.penfieldrobotics~~.~~com/FRC2006/~~
	*2004-2005 "Rhinobot" - http:~~//www.svn.penfieldrobotics.com/FRC2005/trunk~~

	~~Access requires a username~~ and ~~password~~. ~~Access is provided to Programming Subteam members only~~. ~~Please post to the Programming Build Season forum or contact Jeff if you need an account~~.		*2013-2014 - [http://svn.penfieldrobotics.com/git/thunderbot2014.git http://svn.penfieldrobotics.com/git/thunderbot2014.git] (git repository)
			*2012-2013 - [http://svn.penfieldrobotics.com/FRC2013/trunk http://svn.penfieldrobotics.com/FRC2013/trunk]
			*2011-2012 - [http://svn.penfieldrobotics.com/FRC2012/trunk http://svn.penfieldrobotics.com/FRC2012/trunk]
			*2010-2011 - [http://svn.penfieldrobotics.com/FRC2011/trunk http://svn.penfieldrobotics.com/FRC2011/trunk]
			*2009-2010 - [http://svn.penfieldrobotics.com/FRC2010/trunk http://svn.penfieldrobotics.com/FRC2010/trunk]
			*2008-2009 - [http://svn.penfieldrobotics.com/FRC2009/trunk http://svn.penfieldrobotics.com/FRC2009/trunk]
			*2007-2008 - [http://svn.penfieldrobotics.com/FRC2008/trunk http://svn.penfieldrobotics.com/FRC2008/trunk]
			*2006-2007 - [http://svn.penfieldrobotics.com/FRC2007/trunk http://svn.penfieldrobotics.com/FRC2007/trunk]
			*2005-2006 "ROFLbot" and "CamView" - [http://www.svn.penfieldrobotics.com/FRC2006/ http://www.svn.penfieldrobotics.com/FRC2006/]
			*2004-2005 "Rhinobot" - [http://www.svn.penfieldrobotics.com/FRC2005/trunk http://www.svn.penfieldrobotics.com/FRC2005/trunk]

	~~<br>~~		Access requires a username and password. Access is provided to Programming Subteam members only. Please post to the Programming Build Season forum or contact Jeff if you need an account.

	~~== Subversion Client Software ==~~

	~~Links to Subversion clients:~~

	*[http://www.usfirst.org/frccontrolsystem Windriver Workbench] - Windriver Workbench includes a Subversion plugin. 2008-2009 Projects and beyond repositories are formatted to work with this. To check out the project, right click the project window, choose import, and enter the project SVN URL from the previous section.		== Subversion Client Software ==
	*[http://subclipse.tigris.org/servlets/ProjectDocumentList?folderID=2240 SVN] - Command-line client provided by creators of Subversion. Works on Linux, Windows, and just about everything.
			Links to Subversion clients:

			*[http://www.usfirst.org/frccontrolsystem Windriver Workbench] - Windriver Workbench includes a Subversion plugin. 2008-2009 Projects and beyond repositories are formatted to work with this. To check out the project, right click the project window, choose import, and enter the project SVN URL from the previous section.
			*[http://subclipse.tigris.org/servlets/ProjectDocumentList?folderID=2240 SVN] - Command-line client provided by creators of Subversion. Works on Linux, Windows, and just about everything.
	*[http://tortoisesvn.tigris.org/ Tortoise SVN] - Easy-to-use graphical client implemented as a Windows Explorer shell extension. Basically adds menu items to the Explorer right-click menues. Very convenient and user-friendly. Windows only.		*[http://tortoisesvn.tigris.org/ Tortoise SVN] - Easy-to-use graphical client implemented as a Windows Explorer shell extension. Basically adds menu items to the Explorer right-click menues. Very convenient and user-friendly. Windows only.

Programming: /* Team 1511 Subversion Repository Details */

2014-09-23T23:23:28Z

Team 1511 Subversion Repository Details

← Older revision		Revision as of 16:23, 23 September 2014
Line 9:		Line 9:
	We have one repository for each team-year. All repositories are accessible via http. Simple browsing can be done with a web browser; actually modifying and contributing code requires a Subversion client. When checking out your initial working copy, configure your Subversion client to use the URLs below:		We have one repository for each team-year. All repositories are accessible via http. Simple browsing can be done with a web browser; actually modifying and contributing code requires a Subversion client. When checking out your initial working copy, configure your Subversion client to use the URLs below:

			*2013-2014 - http://svn.penfieldrobotics.com/git/thunderbot2014.git (git repository)
	*2012-2013 - http://svn.penfieldrobotics.com/FRC2013/trunk		*2012-2013 - http://svn.penfieldrobotics.com/FRC2013/trunk
	*2011-2012 - http://svn.penfieldrobotics.com/FRC2012/trunk		*2011-2012 - http://svn.penfieldrobotics.com/FRC2012/trunk

Programming: Added 2013 svn url

2013-02-05T23:58:08Z

Added 2013 svn url

← Older revision		Revision as of 16:58, 5 February 2013
Line 9:		Line 9:
	We have one repository for each team-year. All repositories are accessible via http. Simple browsing can be done with a web browser; actually modifying and contributing code requires a Subversion client. When checking out your initial working copy, configure your Subversion client to use the URLs below:		We have one repository for each team-year. All repositories are accessible via http. Simple browsing can be done with a web browser; actually modifying and contributing code requires a Subversion client. When checking out your initial working copy, configure your Subversion client to use the URLs below:

			*2012-2013 - http://svn.penfieldrobotics.com/FRC2013/trunk
	*2011-2012 - http://svn.penfieldrobotics.com/FRC2012/trunk		*2011-2012 - http://svn.penfieldrobotics.com/FRC2012/trunk
	*2010-2011 - http://svn.penfieldrobotics.com/FRC2011/trunk		*2010-2011 - http://svn.penfieldrobotics.com/FRC2011/trunk