How do I tell Subversion to treat a file as a bina

Question

How do I tell Subversion (svn) to treat a file as a binary file?

Answer 1

From page 367 of the Subversion book

In the most general sense, Subversion handles binary files more gracefully than CVS does. Because CVS uses RCS, it can only store successive full copies of a changing binary file. Subversion, however, expresses differences between files using a binary differencing algorithm, regardless of whether they contain textual or binary data. That means all files are stored differentially (compressed) in the repository.

CVS users have to mark binary files with -kb flags to prevent data from being garbled (due to keyword expansion and line-ending translations). They sometimes forget to do this.

Subversion takes the more paranoid route. First, it never performs any kind of keyword or line-ending translation unless you explicitly ask it to do so (see the section called “Keyword Substitution” and the section called “End-of-Line Character Sequences” for more details). By default, Subversion treats all file data as literal byte strings, and files are always stored in the repository in an untranslated state.

Second, Subversion maintains an internal notion of whether a file is “text” or “binary” data, but this notion is only extant in the working copy. During an svn update, Subversion will perform contextual merges on locally modified text files, but will not attempt to do so for binary files.

To determine whether a contextual merge is possible, Subversion examines the svn:mime-type property. If the file has no svn:mime-type property, or has a MIME type that is textual (e.g., text/*), Subversion assumes it is text. Otherwise, Subversion assumes the file is binary. Subversion also helps users by running a binary-detection algorithm in the svn import and svn add commands. These commands will make a good guess and then (possibly) set a binary svn:mime-type property on the file being added. (If Subversion guesses wrong, the user can always remove or hand-edit the property.)

Hand editing would be done by

svn propset svn:mime-type some/type filename.extension

Answer 2

As per the Subversion FAQ, you can use svn propset to change the svn:mime-type property to application/octet-stream

Answer 3

Basically, you have to set the mime type to octet-stream:

svn propset svn:mime-type application/octet-stream <filename>

Answer 4

If using tortoise svn in Windows, right click on the file and go to properties. Click on new and add a new property of type svn:mime-type. For the value put: application/octet-stream

Answer 5

Although Subversion tries to automatically detect whether a file is binary or not, you can override the mime-type using svn propset. For example, svn propset svn:mime-type application/octet-stream example.txt. This will make your file act as a collection of bytes rather than a text file. See also, the svn manual on File Portability.

Answer 6

If 'svn add' guesses the incorrect type and gives you an error like the following:

svn: E200009: File 'qt/examples/dialogs/configdialog/images/config.png' has inconsistent newlines
svn: E135000: Inconsistent line ending style

then the workaround is to add the file without properties and then set the properties in a second step:

svn add --no-auto-props qt/examples/dialogs/configdialog/images/config.png
svn propset svn:mime-type image/png qt/examples/dialogs/configdialog/images/config.png