42 | | Internally, Subversion stores all text files using the Unix line endings (i.e., a single line feed). When checking out a text file on a Windows machine, however, we would prefer the file to have Windows-style line endings (i.e., carriage return/line feed pairs). Blinding adding and committing files can lead to inconsistent line endings, causing problems with some tools. Boost adopts an approach using [http://svnbook.red-bean.com/en/1.1/ch07s02.html `svn:eol-style` properties] to provide native line endings for users on all platforms. Each text file in the Boost Subversion repository must have its MIME type set appropriately and have the `svn:eol-style` property set to `native`. These settings will be verified by the Subversion repository itself, to keep the repository consistent. |
| 42 | Internally, Subversion stores all text files using the Unix line endings (i.e., a single line feed). When checking out a text file on a Windows machine, however, we would prefer the file to have Windows-style line endings (i.e., carriage return/line feed pairs). Blindly adding and committing files can lead to inconsistent line endings, causing problems with some tools. Boost adopts an approach using [http://svnbook.red-bean.com/en/1.1/ch07s02.html `svn:eol-style` properties] to provide native line endings for users on all platforms. Each text file in the Boost Subversion repository must have its MIME type set appropriately and have the `svn:eol-style` property set to `native`. These settings will be verified by the Subversion repository itself, to keep the repository consistent. |
44 | | To automatically maintain correct MIME types and end-of-line styles, modify your Subversion configuration file by merging the following code. This code enables the automatic setting of properties when you add files to Subversion, including the MIME type and end-of-line style: |
| 44 | To automatically maintain correct MIME types and end-of-line styles, you will need to modify your Subversion configuration to use the "auto-props" feature. When you edit your Subversion configuration, remove the existing {{{enable-auto-props = no}}} setting, if it exists, and then add the following text to enable Subversion's auto-properties. The location of the Subversion configuration differs from on platform to the next: |
| 45 | |
| 46 | * On Unix: Edit the file {{{~/.subversion/config}}}. |
| 47 | * With the command-line Subversion on Windows: Edit the file {{{%APPDATA%\Subversion\config}}}. |
| 48 | * With [http://tortoisesvn.tigris.org/ TortoiseSVN] on Windows: Right-click in Windows Explorer to bring up the context menu, and select TortoiseSVN->Settings. In the "General" configuration tab, click the Edit button to the right of "Subversion configuration file". Now, past the contents below into that editor window and save the results. |