Pl/FGAddon: Difference between revisions

{{warning|The incorrect setting or absence of the mime-type property on a binary file will result in a binary diff.}}

When looking at the output of <code>svn diff</code> (or <code>git diff</code> if you are using git-svn) as well as when reading messages from the [[#FGAddon commitlog mailing list|FGAddon commitlog mailing list]], you may see a large number of unrecognisable characters. This is the result of what is known as a binary diff, showing the binary file differences as if it were text. Although this is not a issue for the operation of the repository, the situation is an aesthetic problem which makes it more difficult to perform a review of the changes.

To fix the problem, firstly the binary files with the <code>svn:mime-type</code> property missing need to be identified.  The following subversion command can be used:

As it can be tedious checking each file individually, the following Python script simplifies and automates the process to identify all binary files with a mime-type issue:

| type  = Python 2/3 script

| title  = Find binary files with no <code>svn:mime-type</code> property set.

| intro  = The following script is based on blacklisting text files.  Hence false positives are to be expected, and the blacklists can be expanded as needed.

==== Fixing the problem ====

As [[#Subversion_properties|git-svn cannot set or change]] the <code>svn:mime-type</code> property, a [[#Repository_checkout|svn checkout copy]] of the aircraft is required.  The property can then be set to the default Subversion binary mime-type with:

Alternatively, the following set of shell commands can be used to automate the process:

| type  = Shell commands

| title  = Set specific <code>svn:mime-type</code> values on a set of known binary files.

| intro = These shell commands will work on GNU/Linux or Mac OS X systems (or on Windows if using cygwin, or if a find command line tool is installed).  The list of file types here are those most commonly found in FGAddon.  To set the property on a list of binary files, type (or copy and paste):