범퍼카 토토 9.1.24 문서 | ||||
---|---|---|---|---|
사설 토토 : 문서 : 9.1 : 사설 토토 코딩 규칙 | up | 47 장. 범퍼카 토토 코딩 규칙 | 다음 |
소스 코드 형식은 4 열 탭 간격을 사용합니다. 보존 (즉, 탭은 공간으로 확장되지 않음). 각 논리적 들여 쓰기 레벨은 하나의 추가 탭 정지입니다.
레이아웃 규칙 (브레이스 포지셔닝 등)은 BSD 규칙을 따릅니다. 특히, 통제 된 블록을위한 곱슬 괄호if, while, 스위치등은 자신의 라인으로 이동합니다.
코드가 80 열 창. (그렇다고해서 절대지나 가지 말아야한다는 의미는 아닙니다 80 열. 예를 들어, 긴 오류 메시지 문자열을 깨뜨립니다 80 열 이내에 코드를 유지하기 위해 임의의 장소는 다음과 같습니다. 아마도 가독성의 순 이익이 아닐 것입니다.)
C ++ 스타일 댓글을 사용하지 마십시오 (//댓글). 엄격한 ANSI C 컴파일러는이를 허용하지 않습니다. For the 동일한 이유, 새로운 선언과 같은 C ++ 확장자를 사용하지 마십시오. 변수 중간 블록.
멀티 라인 주석 블록의 선호하는 스타일은입니다.
/* * 댓글 텍스트가 여기에서 시작됩니다 * 그리고 여기서 계속됩니다 */
1 열에서 시작하는 주석 블록은 다음과 같습니다. as- 보존Pgindent그러나 마치 평범한 것처럼 들여 쓰기 한 주석 블록을 다시 흐르게 할 것입니다. 텍스트. 당신이 들여 쓰기에서 줄을 보존하고 싶다면 블록, 다음과 같은 대시 추가 :
/*--------- * 댓글 텍스트가 여기에서 시작됩니다 * 그리고 여기서 계속됩니다 *--------- */
제출 된 패치는 절대적으로 따를 필요가 없습니다. 규칙 포맷, 그렇게하는 것이 좋습니다. 귀하의 코드가 얻을 것입니다 실행Pgindent전 다음 릴리스이므로 아래에서 멋지게 보이게 할 필요가 없습니다. 다른 포맷 규칙 세트. 좋은 경험 법칙 패치는"새 코드를 모양으로 만드십시오 그 주변의 기존 코드 ".
theSRC/Tools디렉토리가 포함되어 있습니다 샘플 설정 파일emacs, xemacs또는vim편집자가 형식을 보장하는 데 도움이됩니다 이 규칙에 따른 코드.
텍스트 브라우징 도구moreandLess:로 호출 할 수 있습니다.
more -x4 Less -X4
탭을 적절하게 보여주기 위해.