ankhsvn
Wiki: Faq

Edit this page | Links to this page | Page information | Attachments | Refresh page

 

AnkhSVN FAQ

This is the complete FAQ for AnkhSVN. We have used our Wiki for this FAQ so that it is easy for you to help us maintain the contents of this FAQ. You only have to be a logged in project member to use the Wiki. There should be an Edit this page link displayed above.

Return to Wiki FrontPage

Contents

  1. Using the features of AnkhSVN
    1. How do I identify the version of AnkhSVN I am using?
    2. Some project settings not preserved across checkin/checkout (ie. Working Directory). Why?
    3. Does AnkhSVN support locking of files? IE is there an equivalent of "checked out by me", "checked by other" as in Visual Source Safe?
    4. How does AnkhSVN determine whether a solution is version controlled?
    5. Why does AnkhSVN change my Solution file
    6. What glyphs does AnkhSVN use in the Solution Explorer?
    7. Why doesn't AnkhSVN 2.0 show glyphs on folders
    8. Why do unchanged files have a blue checkmark instead of a green one
    9. Can I force my users to lock a file before is is editable?
    10. When does AnkhSVN use "_svn" instead of ".svn"?
    11. Where is "Setup Issue Tracker" option?
  2. Using AnkhSVN with other software
    1. What versions of VS.NET does AnkhSVN run on?
    2. Does it work with the Visual Studio 2005 / 2008 / 2010 Express versions?
    3. Can I use AnkhSVN 2.X as MSSCCI provider in applications other than Visual Studio
    4. What else do I need to have installed to use AnkhSVN?
    5. How do I convert my Visual SourceSafe repository to Subversion?
    6. Why doesn't AnkhSVN work with Intel Compiler projects/{insert favorite project type here}
    7. I am using svnserve, when I attempt to do a commit to the remote repository I get a Permission denied error. How do I set up user accounts for svnserve?
  3. Errors
    1. When committing, I get an error saying Aborting commit: file remains in conflict
    2. I get an error saying "The version resource does not correspond to the resource within the transaction."
    3. I get an error saying "PROPFIND of ...: 405 Method Not Allowed"
    4. I get an error saying "Repository UUID 'XXXXXX' doesn't match expected UUID 'YYYYYY'
    5. I get an error "SSL error: parse tlsext" or "SSL error: bad decompression"
    6. AnkhSVN is installed, but when I enable AnkhSVN as SCC provider nothing happens
    7. AnkhSVN doesn't handle files in my temp directory correctly
  4. Future
    1. I heard that AnkhSVN will be localized, what can I expect?
  5. Other
    1. What's an Ankh?
    2. Why did you name AnkhSVN "AnkhSVN"?

Using the features of AnkhSVN

How do I identify the version of AnkhSVN I am using?

From within Visual Studio choose Help -> About Microsoft Visual Studio

In the dialog that is shown choose AnkhSVN from "Installed products" and the version details will then be displayed in "Product details".

Note both these lists may require scrolling to find AnkhSVN and the version numbers.

Some project settings not preserved across checkin/checkout (ie. Working Directory). Why?

Those settings are considered to be the local user project options and they are not meant to be version controled by definition. (FYI they are not stored in the .vcproj / .csproj but in the .suo / .csproj.user Visual Studio user option files)

Does AnkhSVN support locking of files? IE is there an equivalent of "checked out by me", "checked by other" as in Visual Source Safe?

AnkhSVN supports locking via the Lock and Unlock commands. It also has icons to indicate the lock status of a file.

To enabled Source Safe like behavior, set the  svn:needs-lock  subversion property on the file(s) that you want this behavior on. For more information see the documentation on this subject

How does AnkhSVN determine whether a solution is version controlled?

AnkhSVN is loaded and set as active source control provider when the Solution (and projects that require it) are 'connected'. To connect a solution, go to File -> Subversion -> Change Source Control

Why does AnkhSVN change my Solution file

When Visual Studio opens a solution file it starts communicating with the SCC provider responsible for managing the solution. To enable this communication AnkhSVN must be loaded and enabled as active SCC provider.

To enable this scenario Visual Studio delegates certain sections of the solution file to specific packages. The information we currently add is there to load and enable AnkhSVN as active SCC provider. (You can disable this behavior by disconnecting the Solution in File->Subversion->Change Source Control)

When we add enlist support we will have to extend this section to contain some extra required reference data.

See this thread on the user forum for more details.

What glyphs does AnkhSVN use in the Solution Explorer?

http://ankhsvn.open.collab.net/images/Glyphs-Descriptions.png

Why doesn't AnkhSVN 2.0 show glyphs on folders

AnkhSVN 2.0 is a true Visual Studio SCC provider, while previous versions where just an AddIn providing source control actions.

The Visual Studio design makes projects responsible for asking glyphs from the SCC provider. The SCC providers delivers those on demand, but can't send answers to requests that were not sent.

The common project types do not ask for glyphs on their (virtual) folders. So we are not able to answer glyphs for them.

Most AnkhSVN 1.X and TortoiseSVN users asking for this feature should first check out the new Pending Changes Window. (View -> Pending Changes, when AnkhSVN is enabled)

Why do unchanged files have a blue checkmark instead of a green one

About ten percent of the male population is colorblind and has problems seeing the difference between the old green check and the red (editted document) state. As we would rather not change all red icons in some other color we decided to change the neutral/unmodified color in a light blue shade.

Can I force my users to lock a file before is is editable?

Subversion allows locking files exclusively to make sure it is impossible to commit while it is locked in another workingcopy. This feature is available by right clicking on the file -> Subversion -> Lock.

In some cases you might wish to force users to lock a specific file before editting it (e.g. images or other files that can't be automatically merged). This is possible by setting the  svn:needs-lock property  on the file. (More information)

In this case subversion makes the file read-only unless the file is locked in this working copy and AnkhSVN will show a padlock glyph on the file to notify this.

If you try to edit the file from VS you will automatically get a lock dialog popup asking you to lock this file before continuing. (Like VSS does when you try to edit a not checked-out file).

When does AnkhSVN use "_svn" instead of ".svn"?

Visual Studio 2005 and 2008 don't have problems with a '.svn' directory. For backwards compatibility we continue to check the environment variable "SVN_ASP_DOT_NET_HACK" but we don't offer to set this from our user interface.

Where is "Setup Issue Tracker" option?

"Setup Issue Tracker" option is available only on the solution node in Solution Explorer. If this option is not visible, there are no "Issue Tracker Connector"s registered. The option will be available after you install a compatible connector.

Visual Studio hides the Solution Node by default in certain development environment settings, like that of Visual Basic development. You can make the solution node visible by checking Always show solution option on "Tools -> Options -> Projects and Solutions" page, or by adding a second project to the solution.

Using AnkhSVN with other software

What versions of VS.NET does AnkhSVN run on?

AnkhSVN 2.0 supports Visual Studio 2005, Visual Studio 2008 and Visual Studio 2010. It is the same install file (msi) for all versions. The installer will automatically uninstall AnkhSVN versions starting at 0.5.0.

Does it work with the Visual Studio 2005 / 2008 / 2010 Express versions?

No, and it might never do so. The current position from Microsoft is that these SKUs will not support addins.

Can I use AnkhSVN 2.X as MSSCCI provider in applications other than Visual Studio

No, AnkhSVN 2.x implements the newer SCC implementation for Visual Studio 2005 and later. The older MSSCCI implementation forced all implementations to use the check-out check-in idiom (including making files read-only).

The newer VAPI SCC implementation implemented by AnkhSVN 2.x doesn't have these limitations and allows our implementation to integrate deeper in Visual Studio.

What else do I need to have installed to use AnkhSVN?

AnkhSVN links into the same libraries that svn.exe does, so if the Subversion repository is already created it is possible to use AnkhSVN without ever installing Subversion at all.

However, with AnkhSVN you cannot yet do some things, including but not limited to creating or upgrading a local repository. For these tasks it is highly recommended that Subversion be installed as well at this point. You can download Subversion from SlikSVN. Other than that all you need is Visual Studio.

How do I convert my Visual SourceSafe repository to Subversion?

Information is in the Subversion Migration section of openCollabNet.

Why doesn't AnkhSVN work with Intel Compiler projects/{insert favorite project type here}

With the redesign for AnkhSVN 2.0 we implemented the new style SCC api which should support all project types that are scc-enabled just like the other source code control providers from other vendors. You might want to try connecting the problematic project. If that doesn't work either it probably means that the project has no support for source code control.

I am using svnserve, when I attempt to do a commit to the remote repository I get a Permission denied error. How do I set up user accounts for svnserve?

Svnserve has built-in authentication and authorization. You can setup users and realms within your /path-to-repos/conf/svnserve.conf file. See SvnServe: Built-in Authentication and Authorization for instructions.

Errors

When committing, I get an error saying Aborting commit: file remains in conflict

This means you have a file that is in conflict, i.e., someone else has made a change that conflicts with one of yours. You will have to resolve the conflict before proceeding. See TasksHelp/ResolvingConflicts on how to do this.

Starting with AnkhSVN 2.1.7819, you no longer get an error message, but you get a warning that explains how to solve the conflict.

I get an error saying "The version resource does not correspond to the resource within the transaction."

Running Update on the item in question solves this problem.

I get an error saying "PROPFIND of ...: 405 Method Not Allowed"

This usually means you are trying to perform a Subversion operation against an URL that isn't set up as a Subversion repository.

I get an error saying "Repository UUID 'XXXXXX' doesn't match expected UUID 'YYYYYY'

Subversion 1.5 (and higher) clients give this error if the repository uuid changed since creating the working copy. Previous versions of the subversion libraries did not check this value as much as 1.5 clients do.

The suggested workaround is to check out a clean working copy. This should resolve the issue.

I get an error "SSL error: parse tlsext" or "SSL error: bad decompression"

AnkhSVN is compiled against the latest (at the time) OpenSSL versions and has TLS negotiation enabled to allow connecting to https servers that have more than one DNS name and/or use compression. If your server uses older OpenSSL/GnuTLS versions then you might see some negotiation errors like "SSL error: parse tlsext" or "SSL error: bad decompression". You can fix this by upgrading the server hosting the repository (recommended) or by disabling TLS on the server. The OpenSSL versions affected have (unrelated) known security issues, so upgrading is recommended anyway.

AnkhSVN is installed, but when I enable AnkhSVN as SCC provider nothing happens

If Visual Studio Packages -as AnkhSVN- throw an error while loading, packages can get disabled.

Please try to start  devenv.exe /ResetSkipPkgs , this re-enables all packages previously disabled by Visual Studio.

AnkhSVN doesn't handle files in my temp directory correctly

Your temp file directory is a directory for temporary files and Visual Studio creates *a lot* of temporary files. For some reason it sometimes expect the SCC provider to know about these files.

To speed up common tasks like refactoring AnkhSVN 2.1 just responds to that all these files are unversioned.

Please save your projects outside your temp folder for correct behavior.

Future

I heard that AnkhSVN will be localized, what can I expect?

We would like to create localized versions of AnkhSVN in all languages that Visual Studio is available in. As far as I can tell the list of languages for VS2010 contains English (en-us, neutral, fallback), French, German (de), Japanese, Spanish (es), Italian (it), Russian (ru), Traditional Chinese, Simplified Chinese and Korean.

As we (the current AnkhSVN developers) don't understand most of these languages, we would like to get in contact with users/developers that do and are willing to help us parts of AnkhSVN into these languages. If you are interested, please contact us via the user and/or development lists.

We hope to deliver a first localized version in the AnkhSVN 2.2/2.3 timespan.

Other

What's an Ankh?

Read about this ancient Egyptian sign of life.

Why did you name AnkhSVN "AnkhSVN"?

We lost the exact history, but when thinking about the name we were starting the project on tigris.org. The Tigris is a river in the Middle East. From the Middle East we got to the ancient Egypth history. And somehow we got to the "Ankh" -the sign of life- as base for AnkhSVN.

Return to Wiki FrontPage

Faq (last edited 2010-09-14 14:37:44 -0700 by ?rhuijben)