blob: ce7d47b3f8621a7c84e97b8bf27550746f4ab256 [file] [log] [blame]
/*******************************************************************************
* Copyright (c) 2005, 2011 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
package org.eclipse.compare.patch;
import org.eclipse.compare.internal.core.patch.PatchReader;
import org.eclipse.core.resources.IProject;
/**
* Provides the headers required to create a workspace patch.
* @since 3.2
* @noinstantiate This class is not intended to be instantiated by clients.
* @noextend This class is not intended to be subclassed by clients.
*/
public class WorkspacePatcherUI {
/**
* Returns a string that must be the first line of a workspace patch (a multi-project patch
* that is understood by the Apply Patch wizard). Each project to be included in the patch
* must be prefixed by the line obtained from the <code>getWorkspacePatchProjectHeader()</code>.
* This snippet outlines how the a workspace patch is to be created:
* <pre>
* //Write out workspace patch header
* stream.println(CompareUI.getWorkspacePatchHeader());
* for (int i=0; i<projects.length; i++){
* //Write out project header
* stream.println(CompareUI.getWorkspacePatchProjectHeader(projects[i]);
* //Write out patches in Unified Diff format
* }
* </pre>
* @return String
* @see WorkspacePatcherUI#getWorkspacePatchProjectHeader(IProject)
* @since 3.2
*/
public static String getWorkspacePatchHeader() {
return PatchReader.MULTIPROJECTPATCH_HEADER+" "+PatchReader.MULTIPROJECTPATCH_VERSION; //$NON-NLS-1$
}
/**
* Returns the project header that must appear before any patches that apply to that
* project. All patches that are encountered after this header and before the next header
* are understood to belong the the project.
* @param project project to be patched
* @return String
* @see WorkspacePatcherUI#getWorkspacePatchHeader()
* @since 3.2
*/
public static String getWorkspacePatchProjectHeader(IProject project) {
return PatchReader.MULTIPROJECTPATCH_PROJECT+" "+ project.getName(); //$NON-NLS-1$
}
}