소스 코드 형식은 4 열 탭 간격을 사용합니다. 각 논리적 인 압입 레벨은 하나의 추가 탭 정지입니다.
레이아웃 규칙 (브레이스 포지셔닝 등)은 BSD 컨벤션을 따릅니다. 특히, 통제 된 블록을위한 곱슬 괄호if
, while
, 스위치
등은 자신의 선으로 이동합니다.
코드가 80 열 창에서 읽을 수 있도록 라인 길이를 제한합니다. (예를 들어, 80 열 내에 코드를 유지하기 위해 임의의 장소에서 긴 오류 메시지 문자열을 깨뜨리는 것은 아마도 80 열 내에서 길이의 순이익이 아닐 것입니다.).
일관된 코딩 스타일을 유지하려면 C ++ 스타일 주석을 사용하지 마십시오 (//
댓글).Pgindent/* ... */
.
멀티 라인 주석 블록의 선호하는 스타일은입니다.
/* * 댓글 텍스트가 여기에서 시작됩니다 * 그리고 여기서 계속됩니다 */
1 열에서 시작하는 댓글 블록은 as-as-as-asPgindent, 그러나 댓글 블록이 평범한 텍스트 인 것처럼 변환 된 주석 블록을 다시 흐르게합니다. 압축 된 블록에서 라인 브레이크를 보존하려면 다음과 같은 대시를 추가하십시오.
/*--------- * 댓글 텍스트가 여기에서 시작됩니다 * 그리고 여기서 계속됩니다 *--------- */
제출 된 패치가 이러한 형식 규칙을 절대적으로 따를 필요는 없지만 그렇게하는 것이 좋습니다. 코드가 실행됩니다Pgindent다음 릴리스 전에 다른 포맷 규칙에서 멋지게 보이게 할 필요는 없습니다. 패치에 대한 좋은 경험 법칙은입니다.“새 코드를 기존 코드처럼 보이게합니다”.
theSRC/Tools/Editors
디렉토리는 샘플 설정 파일이 포함되어 있습니다.emacs, xemacs또는vim이 규칙에 따라 코드를 형식화 할 수 있도록 편집자.
실행하려는 경우Pgindent코드 일치 프로젝트 스타일을 만들기 위해 로컬로, 참조SRC/Tools/Pgindent
디렉토리.
텍스트 브라우징 도구moreandLess:로 호출 할 수 있습니다.
more -x4 Less -X4
탭을 적절하게 보여주기 위해.
문서에 올바르지 않은 내용이 있으면 일치하지 않습니다. 특정 기능에 대한 귀하의 경험 또는 추가 설명이 필요합니다. 사용이 양식문서 문제를보고하려면