Configure EOL conversion

Enable an end of line (EOL) conversion mechanism to transform different end of lines of text into the right EOL type for your system.

If you enable EOL conversion, Unity Version Control (UVCS) uses EOL conversion during updates and each time you retrieve a file from the workspace. If you update an existing workspace, UVCS doesn’t rewrite unchanged files and converts only the new files that download.

EOL conversion only works when you download files. A check in always preserves the content you create.

There are two ways to enable EOL conversion, which is disabled by default:

Note: The recommended best practice is to start with a clean workspace before you enable EOL conversion.

Refer to more information on how to use value pattern configuration files.

Edit the client.conf file

  1. Add the AutoEolConversion key: Auto`
  2. Set one of the following conversion types:
    • None (default)
    • Auto (converts based on your operating system)
    • CR
    • LF
    • CRLF
  3. Restart the GUI after you change the settings to reload the client.conf file.

Create the eolconversion.conf file

  1. Create an eolconversion.conf file in one of the following locations:
    1. In your client installation directory.
    2. In the plastic4 directory (under C:\Users\<em>user</em>\AppData\Local\plastic4 on Windows or under $HOME/.plastic4 on Linux and macOS systems).
  2. Set one of the following conversion types:
    • None (default)
    • Auto (converts based on your operating system)
    • CR
    • LF
    • CRLF

Note: If you don’t set a conversion type, UVCS uses the general conversion type configured in your client.conf file.