# ChangeLog Plug-in Functions

The ChangeLog plug-in has two functions: Insert ChangeLog and Prepare ChangeLog.

The first time you invoke either function for a specific project, a Folder Selection menu will appear. This menu will allow you to select where to save the `ChangeLog` file for that project.

After selecting where to save the `ChangeLog` file, Eclipse will open it in your workspace editor. The ChangeLog plug-in will then generate an appropriate pre-compiled entry for you to edit further. You can close the `ChangeLog` file after saving it; when you invoke the Insert ChangeLog or Prepare ChangeLog function again, Eclipse will use the same `ChangeLog` file.

The following sections describe both functions in more detail.

## Insert ChangeLog

This function generates a single ChangeLog entry for the currently selected file in the editor. To use this function, navigate to Edit > ChangeLog Entry. Alternatively, you can also use the key combination `Ctrl`+`Alt`+`C`.

Invoking the Insert ChangeLog function for another file in the same project will create a new ChangeLog entry for the file. If an entry already exists for a file, invoking the Insert ChangeLog function for that file will place the insertion point in the appropriate entry.

## Prepare ChangeLog

This function generates a full ChangeLog entry based on the differences between the local changes you made to a project and its source control repository. As such, using this function requires access to the the source control repository of a project.

The ChangeLog entry generated by the Prepare ChangeLog function will include new files, removed files, and modifications. To invoke this function, navigate to Project > Prepare ChangeLog. Alternatively, you can also use the key combination `Ctrl`+`Alt`+`P`.

© Copyright Red Hat, Inc. 2009
© Copyright Phil Muldoon <pkmuldoon@picobot.org> 2006.
This documentation is licensed under the Eclipse Public License v. 1.0.