기 Eclipse Java 코드 포맷을 무시하 블록 코멘트
https://stackoverflow.com/questions/1024886
italiano
english
français
española
中国
日本の
العربية
Deutsch
한국어
Português
Russian문제
가 있을 만들 수 있는 방법 이클립스에 내장 된 자바 코드 포맷터 무시한 의견이 있으십니까?때마다 나는 그것을 실행,그것이:
/*
* PSEUDOCODE
* Read in user's string/paragraph
*
* Three cases are possible
* Case 1: foobar
* do case 1 things
* Case 2: fred hacker
* do case 2 things
* Case 3: cowboyneal
* do case 3 things
*
* In all cases, do some other thing
*/
이:
/*
* PSEUDOCODE Read in user's string/paragraph
*
* Three cases are possible Case 1: foobar do case 1 things Case 2: fred
* hacker do case 2 things Case 3: cowboyneal do case 3 things
*
* In all cases, do some other thing
*/
저는 이미 주위 Windows>설정>Java>코드 스타일>포맷 설정을 하지만 하나를 찾을 수 없습니다 유지에 대한 코멘트 포맷입니다.내가 사용하여 Eclipse3.4.0.
해결책
2010 년 업데이트 OP에 의해 지적되었습니다 그리고 이 대답에서, 특별한 문자열 // @formatter:off Eclipse에서 3.6으로 충분합니다.
사용할 수 없었습니다 질문 당시.
원래 답변 : 2009 년 6 월, 일식 3.4/3.5
Java Formatter와 함께 (Windows > Preferences > Java > Code Style > Formatter), 새로운 포맷터 프로파일을 만들 수 있습니다.
주석 탭 (eclipse3.5)에서 "Javadoc comment settings", 선택 해제"Format HTML tags".
"도"Never join lines"안에서"General settings" 부분.
그런 다음 귀하의 의견은 다음과 같이 작성해야합니다.
/**
* PSEUDOCODE
* Read in user's string/paragraph
*
* Three cases are possible:
* <dl>
* <dt>Case 1: foobar</dt>
* <dd> do case 1 things</dd>
* <dt>Case 2: fred hacker</dt>
* <dd> do case 2 things</dd>
* <dt>Case 3: cowboyneal</dt>
* <dd> do case 3 things</dd>
* </dl>
* In all cases, do some other thing
*/
참고 : 나는 a Javadoc 그 많은 텍스트가있는 댓글이 메소드 앞에 더 잘 배치 될 수 있다고 생각하기 때문에 간단한 의견이 아닙니다. 또한 Javadoc 섹션에는 더 많은 서식 매개 변수가 있습니다.
메소드 (True Javadoc) 앞에있는 경우 HTML 태그 <dl>, <dt> 그리고 <dd> Javadoc보기 내에서 올바르게 제시하는 데 도움이됩니다.
다른 팁
특정 블록 주석의 형식을 억제하는 데 사용할 수있는 또 다른 솔루션이 있습니다. 사용 /*- (하이픈 참고) 블록 주석의 시작 부분에서 나머지 파일을 포맷하면 형식이 영향을받지 않습니다.
/*- * Here is a block comment with some very special * formatting that I want indent(1) to ignore. * * one * two * three */
원천: http://www.oracle.com/technetwork/java/javase/documentation/codeconventions-141999.html#350
방금 동료로부터 Eclipse가 사용할 수있는 특수 서식 태그를 제공한다는 것을 알게되었습니다.
// @formatter:off
/*
* ╔════════╦═══════╦══════════╗
* ║ Month ║ Sales ║ Position ║
* ╠════════╬═══════╬══════════╣
* ║ June ║ 44k ║ 2nd ║
* ║ July ║ 39k ║ 2nd ║
* ║ August ║ 49k ║ 4th ║
* ╚════════╩═══════╩══════════╝
*
* This comment shouldn't be formatted, and will now be ignored by the formatter.
*/
// @formatter:on
기본 설정 메뉴 → java> 코드 스타일> Formatter, 클릭을 통해이 기능을 수동으로 활성화해야 할 수도 있습니다. 편집하다, 선택 OFF/ON 태그 탭 및 확인 OFF/ON 태그를 활성화합니다 (원천).
문자열의 빠른 구글 @formatter : OFF 나를 데려왔다 이것은 다른 대답입니다, 코드 블록에 대한 Formatter를 비활성화하는 맥락 에서이 기능을 언급했습니다. "정상"블록 주석 및 Javadoc 블록 댓글, 라인 댓글에도 효과가 있음을 확인했습니다.
또 다른 가능성은 HTML을 사용하는 것입니다u003Cpre> Javadoc에서 :
/**
* <pre>
* this
* is
* kept
* as
* is
* </pre>
*/
적어도 이것은 내가 소스 코드 주석에 내 ascii-art를 포함시키는 경향이 있습니다 :)
특정 텍스트를 둘러싸고 있습니다 <pre> </pre> 태그.
Eclipse 3.4 : 환경 설정, Java-> Code Style-> Formatter, 그런 다음 프로파일 편집, 주석 탭. 주석 형식을 제어하기위한 많은 옵션이 있습니다.
하려면을 억압하는 포맷 eclipse 에서 당신은 항상 포장용 콘텐츠를 수 없는 형식으로 <pre>UNFORMATTED CONTENT</pre> 태그입니다. Javadoc 포맷을 감지하는 태그, 며,떠나는 모든 사 태그를 포맷되지 않습니다.
장점:
- 의 나머지 부분 Javadoc 은 여전히 포맷
- Javadoc 의 html 을 출력 될 것입니다"형식화"뿐만 아니기 때문에 사전에 태그
단점:
- 보이지 않는 하나
하나의 해결 방법은 추가하는 것입니다 사전 Eclipse가 형식을 원하지 않는 주석에 대한 태그
/**
* <pre>
* this part
* is
* out of
* format
*
* </pre>
*/
언어 의존적입니다.
예를 들어, JavaScript로 작업하는 경우 "Window-> preferences-> javaScript-> Code Style-> Formatter"로 이동 한 다음 Formatter 옵션을 편집합니다.
편집하다 (OP 질문의 변경 사항을 반영합니다
Java 코드 형식을 편집하려면 "Window-> preferences-> java-> 코드 스타일 -> Formatter"로 이동하십시오.
패널 상단에는 볼 수 있습니다
활성 프로필 :
일식 [내장
거기에서 오른쪽에 "편집", 아래 두 개, "new ..."및 "import ..."에 하나의 버튼이 있습니다. 기존 프로필을 편집하는 것이 좋습니다.
프로필 편집 대화 상자에는 상단을 따라 일련의 탭이 있습니다. 마지막 탭은 "댓글"입니다. 주석 형식을 완전히 비활성화하려면 "Javadoc 주석 형식 활성화 활성화", "블록 주석 형식 활성화", "라인 주석 형식 활성화"및 "헤더 주석 형식 활성화"를 선택 취소하십시오.
편집을 클릭하는 것보다 Windows- 환경 설정 -Java- 코드 스타일 - 포맷터에서 이것을 변경할 수 있습니다.
그런 다음 괜찮을 것입니다.
이거 한번 해봐. 이것은 나를 위해 효과가있었습니다. Java Formatter (Windows> Preferences> Java> Code Style> Formatter)를 사용하면 기존에서 새 Formatter 프로파일을 작성한 다음 편집 할 수 있습니다.
Eclipse가 이것을 저장할 수 없다면 새 것을 만들고 그것을 저장하십시오.
