openhatch / oh-mainline

The code that runs openhatch.org
http://openhatch.org
GNU Affero General Public License v3.0
242 stars 310 forks source link

Subversion Mission for Mac - documentation and connection error to remote repo #1159

Closed imported-from-roundup closed 10 years ago

imported-from-roundup commented 10 years ago

Comment by fstopzero:

http://openhatch.org/missions/diffpatch/recursive_patch

I'm a n00b to the command line and contributing, and am learning as I go through the trainings.
The instructions here: http://openhatch.org/missions/diffpatch/recursive_patch

are windows specific, and also, seem to be unclear - I don't know if the patch isn't working because of the recommended command line, or because I'm making a mistake.

Nitpicking here: the "1" looks like an "l" in this font. Maybe an explanation on what the number means?

Here's my command line:

Beckas-MacBook-Air:recursivediff becka$ patch -p1 < recipes.patch patch unexpectedly ends in middle of line patch: ** Only garbage was found in the patch input. Beckas-MacBook-Air:recursivediff becka$ patch -p1 < more-garlic.patch -bash: more-garlic.patch: No such file or directory Beckas-MacBook-Air:recursivediff becka$ patch -p1 < recipes.patch patch unexpectedly ends in middle of line patch: ** Only garbage was found in the patch input. Beckas-MacBook-Air:recursivediff becka$ patch -p1 < page -bash: page: No such file or directory Beckas-MacBook-Air:recursivediff becka$ patch -p1 < patch patching file recipes/README patching file recipes/MelanzaneParmigiana.txt


Comment by fstopzero:

Hey.

NIce description of what a VCS is, but there's only a download link for Windows users here: http://openhatch.org/missions/svn/description

-Becka


Comment by fstopzero:

Hi,

I'm looking at the training section on using Subversion.

My last issue I posted was on the VCS install and Subversion download. There's some confusion out there, apparently, on how to download for a Mac- some docs say it's included in OS X and higher: http://subversion.apache.org/packages.html#osx ... but according to other discussions, that doesn't seem to be the case:

http://stackoverflow.com/questions/12530085/how-to-setup-svn-on-mac-os-x-10-8-2

The above link rec's that you download xcode and then enter the command line from there

Apparently there is one at wandisco: http://www.wandisco.com/subversion/download#osx

... which comes with a very small amount of support - I've downloaded it, and am working now to figure out what to do next.

As you can see, it is the opposite of intuitive. It's important to note that the gui version of this is not free. Clarifying the documentation is very much needed.


Comment by paulproteus:

I believe our recommendation should be to tell people to install XCode, and then make sure they can run 'svn' from their Terminal.


Comment by paulproteus:

To increase the clarity here:

on http://openhatch.org/missions/svn/description we should tell people to install XCode. Since I'm not a Mac user, I'm not sure how to install XCode. It looks like https://www.macports.org/guide/chunked/installing.xcode.html is a reliable guide for installing XCode, but what do I know.

If it is a reliable guide, then that seems like a good thing to link to. If you have a better idea, or a video that you can find that you like, link to that.

Anyway, once XCode has been installed, hopefully then typing 'svn help' into a Terminal will cause you to see something like:

usage: svn <subcommand> [options] [args] Subversion command-line client, version 1.7.13. Type 'svn help <subcommand>' for help on a specific subcommand.

rather than "Command not found".

It's important that whoever fixes this actually test that the proposed solution seems to work. For example, maybe XCode typically installs svn in a place that is not available to Terminal, but if you set the $PATH variable, then it does become available? You, dear bug fixer, are going to have to find this out. (:

The fix is going to be done by editing mysite/missions/templates/missions/svn/about_svn.html and submitting a pull request with your new text there. You should view the site locally on your laptop/etc. before submitting the pull request.

(Marking as bitesize, in the hopes that a new contributor to OpenHatch can tackle this.)


Comment by blues_chick:

Based on current testing of the Subversion mission on Mac OSx v10.9, I am recommending two next steps: 1) Documentation of installation of Subversion on Mac using XCode: Aaron has begun taking screenshots of the installation process. The next step would be a brief write up of instructions

2) Error on svn mission checkout: When the command 'svn checkout svn://openhatch.org/user_name/trunk svn_missions' is executed from the command line, the command hangs. On termination of the command, an error message 'svn: E200015: Unable to connect to a repository at URL 'svn://openhatch.org/user_name/trunk'

Item (2) requires more testing to determine if: a) the remote repo is being created correctly (test using a Linux system), b) if remote repo does exist, test if it can be accessed from within XCode; c) try to test from the terminal command line.

My instinct on Item (2) is that this is related to permissions related to svn on the Mac or Mac's security system blocking access to the remote repo.

Thanks to Aaron for moving this issue forward especially with Item 1 documentation.

I am editing the issue title to more accurately reflect the current knowledge re: issue.


Comment by blues_chick:

Update: Item 2a from msg4040.

I tested the subversion mission on my Ubuntu system. Same results as on the Mac. I am unable to checkout the repo using the 'svn checkout' command mentioned in the mission.

If someone else, could confirm their findings on Linux that would be great. It should take only a few minutes.


Comment by paulproteus:

Yeah, I think this is currently an issue related to the switch to CloudFlare; see http://openhatch.org/bugs/issue910

I can tackle that probably today.


Comment by paulproteus:

Can y'all try this freshly, now that the underlying svn connectivity issue is fixed?


Comment by blues_chick:

Tested on a Mac running OSx 10.9.1.

svn connectivity issue is fixed. I was able to complete the entire mission. I consider Item 2 (svn connectivity) resolved. Thank you paulproteus!

Addition of Item 3 (Mission pages text being clipped): On a couple of the mission pages the text is getting cut off by approximately two characters. The major problem with this is that the secret word 'plenipotentiary' was missing its initial two letters.


Comment by achock:

Thanks to britta and carol for helping me out with the wiki page. Now that the wiki page is done where would you like me to insert the anchor?


Comment by blues_chick:

Thank you aaron!

I think the best place for the link to the wiki page would be on the main page of the subversion mission.

Perhaps editing: mysite/missions/templates/missions/svn/main_page.html


Comment by paulproteus:

Hey achock, did this get resolved? If not, are you still interested in taking a look to make sure the link gets put in a good place?


File at http://roundup-archive.openhatch.org/bugs/file656/unnamed by achock

Status: in-progress Nosy List: achock, blues_chick, fstopzero, paulproteus Priority: bug Imported from roundup ID: 844 (view archived page) Last modified: 2014-02-08.13:04:44

ehashman commented 10 years ago

I think this is fixed. Feel free to correct me.