Bugzilla/Bug report guide/ko

From Gentoo Wiki
Jump to: navigation, search
This page is a translated version of the page Bugzilla/Bug report guide and the translation is 94% complete.

Other languages:
English • ‎italiano • ‎日本語 • ‎한국어 • ‎русский • ‎中文(中国大陆)‎

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

모범 사례

  • 제출 전에 다시 읽어주십시오. 바꾼 내용은 되돌릴 수 없고 제출한 다음에 다시 편집할 수 없습니다. 버그 보고서에 입력한 텍스트는 수많은 사람에게 즉시 전자메일로 발송합니다. 간명한 언어로 기술하고 대화체는 피해주십시오.

요령: 버그 보고서를 쓸 때 삶의 단 한번의 기회가 주어졌음을 생각하는게 중요합니다. 수신자가 영문을 읽을 줄 안다는거 여러분도 압니다만, 주로 사용하는 언어는 아닙니다.

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

선택: 상업적 젠투 기술 지원

젠투 또는 새 이빌드와 관련하여 버그나 동작상 문제에 대해 상업적 지원이 필요하다면 젠투 컨설턴트 전문가 목록en을 참고하십시오.

꾸러미/이빌드

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

user $emerge --info > /tmp/emerge--info.txt

빌드 시간 버그 보고(이머지 실패)

  • sys-apps/package-2.3-r4에서 보는 바와 같은 버그 보고서의 제목에서 꾸러미의 정확한 버전을 먼저 적으십시오
  • 제목에 간단한 설명을 추가하십시오.
  • /var/tmp/portage/<category>/<packagename>/temp/build.log의 기록 파일을 첨부하십시오.
    • 기록 파일이 업로드하기 크다면
      user $ xz -9 /var/tmp/portage/<category>/<packagename>/temp/build.log
      명령으로 압축하고 이 디렉터리의 build.log.xz를 업로드하십시오
  • user $emerge --info <category/packagename>
    출력 내용을 첨부하십시오.

실행 시간 버그 보고

파일 및 관심 정보는 우선 순위에 따라 정렬합니다:

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

그 동안 업스트림에서 새 릴리즈가 나와 버전을 올려달라고 요청

  • Search Bugzilla before posting a bump request - is there already a bug open? Has the local Portage tree been synced lately; is it already in Portage?
  • Avoid Zero-day bump requests (wait at least 48 hours after the release announcement)
  • Has it actually been released by upstream sources, or is it just marked in the source tree? Some projects mark a release in the tree long time before it is officially released.
  • Be sure to mention if it compiles and runs well on your arch. Any other helpful information you provide is most welcome.
  • Add a link to the upstream website
  • Give a link or list of fixed bugs or new features (sometimes called changelog)
  • Write a title in the form app-editors/vim-12.3.5 version bump

추가 고려사항

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

새 꾸러미에 대한 이빌드 요청

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

  • Link to the upstream website in the bug report
  • Give a link or list of features
  • Suggest a preliminary category and package name for the ebuild in the subject line for example "media-gfx/inkscape ebuild request"
  • Provide an ebuild and patches that were tested in your local overlay (you can get help in IRC or in the forums with that)

XY 꾸러미를 안정 버전으로 처리해야 함

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

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

커널

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

  • 사용하고 있는 커널 및 버전, 사용중인 아키텍처. x86_64gentoo-sources-3.4.2-r2
  • /usr/src/linux/.config 커널 설정 파일을 버그 보고서에 첨부해야합니다
  • 시스템의 모든 장치 목록을 lspci -k로 가져올 수 있습니다
  • 커널 초기화시에 나오는 /var/log/dmesg 또는 /var/log/messages 로그 파일을 첨부해야합니다.
참고
kernel git-bisect 요청은 잘못된 패치 여부를 증명해낼 수 있습니다.

다른 버그 보고

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

추가 참조

외부 자료