User`s guide

Projects and Workspaces

4.6.1 Microsoft Visual Source Safe

Having some knowledge of VSS and MPLAB IDE is necessary to use VSS from within

MPLAB IDE.

For more information on this version control system, please see the related web site.

• Microsoft Visual Source Safe: http://www.microsoft.com

Certain VSS files are required to be available locally (on your PC) for VSS to work with

MPLAB IDE. If you are using VSS on a network drive, you will need to run

NETSETUP.EXE to install the proper files on your PC.

4.6.2 PVCS

Having some knowledge of PVCS and MPLAB IDE is necessary to use PVCS from

within MPLAB IDE.

For more information on this version control system, please see the related web site.

• PVCS: http://www.serena.com/Products/professional/vm/home.asp

4.6.3 CVS

Having some knowledge of CVS and MPLAB IDE is necessary to use CVS from within

MPLAB IDE.

For more information on this version control system, please see the related web site.

• CVS: http://www.nongnu.org/cvs/

4.6.3.1 IMPORTING FILES

If your source files aren't already in the repository, you will have to import them to get

started. This creates the directory structure in the repository and places all of the files

there as well.

An example of an import command is given below. The -d argument is not given, since

the assumption is that you have assigned the appropriate value to the CVSROOT

environment variable. You want to be inside the very top directory of your source tree

when you give this command. The command will automatically recurse into

subdirectories.

$ cd TopOfSrcTree

$ cvs import -m “message” DirWithinCVSRoot VendorTag ReleaseTag

4.6.3.2 CHECKING OUT FILES

Even if you have your source files locally, you will have to perform a cvs checkout

once (first-time use) before you can check out files from CVS in MPLAB IDE. This

checkout creates the management files that CVS requires to perform commands on

various files. All of these management files are stored in a hidden subdirectory of each

directory in the source tree. Each of these hidden subdirectories is called CVS.

Trying to do a checkout overtop of existing source files without these supporting CVS

directories will cause CVS to complain. You should either delete or move away the local

copy of the sources before performing the checkout.

CAUTION

Do not place the workspace (MCW) or build-state (MCS) files on the repository.

MPLAB IDE needs to be able to write to these files while running.