56.1. 서식

소스 코드 형식은 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

탭을 적절하게 보여주기 위해.

정정 제출

문서에 올바르지 않은 내용이 있으면 일치하지 않습니다. 특정 기능에 대한 귀하의 경험 또는 추가 설명이 필요합니다. 사용이 양식문서 문제를보고하려면