MDS/openide
1
0
Fork 0
mirror of https://gitflic.ru/project/openide/openide.git synced 2026-09-27 10:03:11 +07:00
Code Issues Packages Projects Releases Wiki Activity

IDEA-CR-56782: CPP-18466: Deprecate the shorter versions of reformatting calls

Browse Source 
... and add missing documentation parts.

GitOrigin-RevId: b3f5fbbf51d53e7fcded55ce7454a5e4b6bb9d43
This commit is contained in:
Ivan Donchevskii
2019-12-23 15:07:19 +00:00
committed by intellij-monorepo-bot
parent bc2adf7359
commit 0666056872
1 changed files with 32 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
platform/core-api/src/com/intellij/psi/codeStyle/CodeStyleManager.java
+32
View File
@@ -82,8 +82,23 @@ public abstract class CodeStyleManager {
* @throws IncorrectOperationException if the file to reformat is read-only.
* @see #reformatText(PsiFile, int, int)
*/
@Deprecated
@NotNull public abstract PsiElement reformat(@NotNull PsiElement element, boolean canChangeWhiteSpacesOnly) throws IncorrectOperationException;
/**
* Reformats the contents of the specified PSI element, and optionally enforces braces
* and splits import statements according to the user's code style.
*
* @param element the element to reformat.
* @param canChangeWhiteSpacesOnly if {@code true}, only reformatting is performed; if {@code false},
* braces and import statements also can be modified if necessary.
* @param keepLineBreaks if {@code true}, no new or empty lines are removed if {@code false},
* the default formatting is performed.
* @return the element in the PSI tree after the reformat operation corresponding to the
* original element.
* @throws IncorrectOperationException if the file to reformat is read-only.
* @see #reformatText(PsiFile, int, int)
*/
@NotNull
public abstract PsiElement reformat(@NotNull PsiElement element, boolean canChangeWhiteSpacesOnly, boolean keepLineBreaks)
throws IncorrectOperationException;
@@ -116,11 +131,28 @@ public abstract class CodeStyleManager {
* @throws IncorrectOperationException if the file to reformat is read-only.
* @see #reformatText(PsiFile, int, int)
*/
@Deprecated
public abstract PsiElement reformatRange(@NotNull PsiElement element,
int startOffset,
int endOffset,
boolean canChangeWhiteSpacesOnly) throws IncorrectOperationException;
/**
* Reformats part of the contents of the specified PSI element, and optionally enforces braces
* and splits import statements according to the user's code style.
*
* @param element the element to reformat.
* @param startOffset the start offset in the document of the text range to reformat.
* @param endOffset the end offset in the document of the text range to reformat.
* @param canChangeWhiteSpacesOnly if {@code true}, only reformatting is performed; if {@code false},
* braces and import statements also can be modified if necessary.
* @param keepLineBreaks if {@code true}, no new or empty lines are removed if {@code false},
* the default formatting is performed.
* @return the element in the PSI tree after the reformat operation corresponding to the
* original element.
* @throws IncorrectOperationException if the file to reformat is read-only.
* @see #reformatText(PsiFile, int, int)
*/
public abstract PsiElement reformatRange(@NotNull PsiElement element,
int startOffset,
int endOffset,