Microsoft KB Archive/170750

From BetaArchive Wiki
Knowledge Base


INFO: End of Line Character Settings for Visual SourceSafe

Article ID: 170750

Article Last Modified on 2/24/2005



APPLIES TO

  • Microsoft Visual SourceSafe 4.0 Standard Edition
  • Microsoft Visual SourceSafe 4.0 Standard Edition
  • Microsoft Visual SourceSafe 5.0 Standard Edition
  • Microsoft Visual SourceSafe 6.0 Standard Edition
  • Microsoft SourceSafe
  • Microsoft SourceSafe
  • Microsoft SourceSafe
  • Microsoft SourceSafe
  • Microsoft SourceSafe
  • Microsoft SourceSafe
  • Microsoft SourceSafe



This article was previously published under Q170750

SUMMARY

The MS-DOS (including WINDOWS), UNIX, and Macintosh operating systems all use different characters to designate the end of a line within a text file.

  • MS-DOS and WINDOWS: Use a Carriage Return/Line Feed combination (CR/LF).
  • UNIX: Uses a Line Feed only (LF).
  • MAC: Uses a Carriage Return only (CR).

Visual SourceSafe always stores files internally using the CR/LF character combination. This means that when you are working with a Macintosh or UNIX operating system, SourceSafe has to translate the CR/LF combination into the appropriate End-Of-Line character (EOL) when you get or check out a file. SourceSafe also has to translate the EOL character back into the CR/LF combination when you check the file back in.

SourceSafe is designed this way so that UNIX, Macintosh, and PC users can all check the same files in and out and always see the file displayed correctly.

MORE INFORMATION

Visual SourceSafe translates the CR/LF characters into the appropriate EOL character when you get or check out a file. It changes the EOL character back into a CR/LF combination when you check the file back in.

It's important to notice that in this one instance, SourceSafe alters the contents of your text file. While this type of change is necessary for text files, it would cause unpredictable results for binary files. Therefore, this operation is never performed on a binary file.

You can change this default behavior by adding the EOL switch in the user's Ss.ini file. You can set the EOL variable to either an "r" (Carriage Return), "n" (Line Feed), or "rn" (Carriage Return/Line Feed). For example:

EOL = n
                

This forces SourceSafe to translate the CR/LF combination into a line feed when you get or check out a file.

You can also accomplish this by using the -g switch from the command line. The syntax is as follows:

ss Get -g(EOL) where EOL can be r, n, or rn
                

For Example:

ss Get -gr <Filename>
                

This forces SourceSafe to translate the CR/LF combination into a carriage return when you get or check out a file.

Keywords: kbinfo KB170750