ankhsvn
Wiki: Faq

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

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 subversion 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?

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

(Currently applies to the daily builds only)

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 .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.

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 beta2. It is the same install file (msi) for all versions. The installer will update !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 http://svnbook.red-bean.com/svnbook-1.0/ch06s03.html 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

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 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.

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.

Other

What's an Ankh?

Read about this ancient Egyptian sign of life.

Return to Wiki FrontPage