Bugzilla/Bug report guide/ko

이 글은 여러분이 버그 보고서를 제출할 때 다른 사람들을 편하게 하기 위해 지켜야 할 여러가지 사항을 다룹니다. 항상 기억해두시고, 여러분이 제기한 문제를 원하는 대로 다룬다는 사실을 항상 기억하십시오:

일반 정보
제출 전에 다시 읽어주십시오. 바꾼 내용은 되돌릴 수 없고 제출한 다음에 다시 편집할 수 없습니다. 버그 보고서에 입력한 텍스트는 수많은 사람들에게 즉시 전자메일로 발송합니다.

새 버그 보고서 만들기
중복 여부를 검색하십시오. 누군가는 문제를 이미 보고했을지도 모릅니다. 새 버그 보고서를 만드는 방법을 안내했으니 절차를 신중하게 읽으십시오. 분류를 선택했다면, 중복을 피하기 위해 최근 제출한 버그 보고서 목록을 보여줍니다.

다른 버그 정보 추가

 * 항상 주제를 지키십시오 - 버그 추적 시스템은 기술적 보고서를 처리하는데 사용하며 잡담은 배제합니다. 포럼, IRC, 메일링 리스트에서 이 점을 지켜주십시오.
 * 문제가 있는지 확인하십시오 - 다른 사람이 또 보고하면 문제를 해결하는데 도움이 안됩니다. 허나 여러분이 보유한 시스템과 확인한 사람의 시스템이 명백히 다르거나 하여 알아야 할 사항이 있다면, 해당 정보를 추가하십시오
 * 다른 버그를 갖다 붙이지 마십시오 - 보고한 버그 보고서에서 다루는 문제가 아니라면, 해당 문제를 찾거나 새 보고서를 작성하십시오.
 * 추적기의 버그에 대해선 말하지 마십시오 - 해당 버그는 통상적인 버그입니다. 쓸만한 정보를 추가하려면 관련 하위 버그 보고서에 추가하든지 새 버그 보고서를 만드십시오.

꾸러미/이빌드
버그에 시스템 설정 정보를 항상 추가해야합니다. 이렇게 하려면 다음 내용을 새 첨부 파일로 만들어 붙여넣으십시오:

빌드할 때 일어나는 문제
파일 및 관심 정보는 우선순위에 따라 정렬합니다:


 * sys-apps/package-2.3-r4에서 보는 바와 같은 버그 보고서의 제목에서 꾸러미의 정확한 버전
 * 가능한 경우 오류 메시지 부분을 제목에 추가하십시오
 * 의 기록 파일
 * 기록 파일이 업로드하기 크다면 명령으로 압축하고 이 디렉터리의 build.log.gz를 업로드하십시오
 * ''emerge --info " 출력 내용

실행할 때 일어나는 문제
파일 및 관심 정보는 우선 순위에 따라 정렬합니다:


 * sys-apps/package-2.3-r4 crashes with error: Cannot proceed...와 같은 버그 보고서의 제목에 명시한 정확한 버전
 * 다른 사람이 재현할 수 있도록 하는 문제 설명
 * 프로그램 실행 방법(콘솔, 터미널, 데몬, 어떤 런레벨인가 등)
 * 오류 출력
 * 프로그램이 깨졌을 때, 뭔가가 잘못됐을 때, 시작하지 않았을 때의 원인
 * 해결책이 있는가?
 * 꾸러미의 최신 동작 버전이 있다면 몇인가?
 * 동작하지 않게 하는 (바뀐) 원인이 무엇인가?
 * emerge --info 출력 결과
 * 의존 요소를 간단하게 확인하는데 필요한 emerge -pv  출력 결과

XY 꾸러미를 새 버전으로 릴리즈 함
업스트림 웹사이트에서는 새 릴리즈를 출시했음을 알립니다:


 * 출시 알림 후 24시간은 보내게 해주십시오. 이미 개발자가 작업중일지도 모릅니다.
 * 버그 보고서에 업스트림 웹사이트를 연결해주십시오
 * 고친 버그나 새 기능 목록이 있다면 링크를 제시해주십시오

만약 업그레이드한 이빌드의 새 정보를 제공한다면(선택):


 * 새 버전에서 이빌드 내용을 필요로 하지 않는다면, 알려주십시오
 * 첨부 파일을 제출하기 전에 로컬 오버레이에서 이빌드를 테스트하십시오
 * 바뀐 내용에 대한 설명을 곁들여 제안한 이빌드 편집의 패치를 제공하십시오(파일 이름은 이전 버전이 아닌 새 버전 번호에 맞춰야 합니다)
 * 추가 파일(initd, unit 파일)을 별도로 첨부(필요한 대로)로 제공하십시오
 * 답글에 이빌드 또는 이빌드 관련 내용을 직접 붙여넣지 마십시오. 이렇게 하려면 첨부하십시오.

XY 꾸러미가 포티지에 있어야 함
포티지 트리에 추가할 프로그램의 새 이빌드를 요청하려면 꾸러미의 관리자를 찾거나 자신이 직접 꾸러미 관리자가 돼야합니다:


 * Link to the upstream website in the bug report
 * Give a link or list of features
 * Provide an ebuild and patches that were tested in the local overlay (you can get help in IRC or in the forums with that)

XY 꾸러미를 안정 버전으로 처리해야 함
비 안정버전 상태에서 30일 이상이 흘렀지만 여전히 불안정하다고 표시한 꾸러미를 빌드하고 문제없이 시스템에서 돌아가는 경우에 해당합니다:


 * stable/unstable 브랜치에 대한 내용은 KEYWORDS 참조
 * 여러분이 안정 버전으로 표시하길 원하는대로 충분히 시험했습니까?
 * 어떤 버그와 관련하여 다른 버그 보고서가 있습니까?
 * 포티지 트리의 꾸러미 버전을 최소한 30일전에 등록 처리했습니까?
 * 의존 요소를 안정 버전으로 표시했습니까?

커널
커널 버그 보고서의 파일과 관심 정보는 우선 순위에 따라 정렬합니다:


 * 사용하고 있는 커널 및 버전, 사용중인 아키텍처. x86_64의 gentoo-sources-3.4.2-r2
 * 커널 설정 파일을 버그 보고서에 첨부해야합니다
 * 시스템의 모든 장치 목록을 lspci -k로 가져올 수 있습니다
 * 커널 초기화시에 나오는 또는  로그 파일을 첨부해야합니다.

다른 버그 보고
실제 양식은 없습니다. wiki.gentoo.org, forum.gentoo.org 하단의 캡차 또는 프로그램과 관련이 없는 다른 문제와 유사한 분류에 양식을 두었습니다.

추가 참조

 * Bugzilla guide
 * Contributing to Gentoo
 * Stable request
 * Gentoo Github - Helping the Gentoo project and considering sending a Pull Request via GitHub

외부 자료

 * 젠투 버그질라 사이트