명령줄 인자
명령줄 플래그는 rustc 책에 문서화되어 있습니다. 모든 안정 플래그는 그곳에 문서화되어야 합니다. 불안정 플래그는 unstable book에 문서화되어야 합니다.
새 명령줄 인자를 추가하는 절차에 대한 자세한 내용은 새 옵션에 관한 forge 가이드를 참조하십시오.
지침
- 플래그는 서로 직교해야 합니다. 예를 들어, 여러 동작
foo와bar에 JSON을 출력하는 변형이 있다면,--foo-json과--bar-json을 추가하는 것보다 별도의--json플래그를 두는 편이 낫습니다. no-접두사가 붙은 플래그는 피하십시오. 대신-C embed-bitcode=no처럼parse_bool함수를 사용하십시오.- 플래그가 여러 번 전달될 때의 동작을 고려하십시오. 어떤 경우에는 값이 (순서대로!) 누적되어야 합니다. 다른 경우에는 뒤에 오는 플래그가 앞선 플래그를 덮어써야 합니다(예: 린트 수준 플래그). 그리고 어떤 플래그(
-o등)는 여러 번 지정했을 때의 의미가 지나치게 모호하다면 오류를 발생시켜야 합니다. - 컴파일러 스크립트를 더 이해하기 쉽게 만들기 위해서라도, 옵션에는 항상 길고 설명적인 이름을 붙이십시오.
--verbose플래그는rustc출력에 상세 정보를 추가하기 위한 것입니다. 예를 들어,--version플래그와 함께 사용하면 컴파일러 코드의 해시에 대한 정보를 제공합니다.- 실험적인 플래그와 옵션은 반드시
-Z unstable-options플래그를 지정해야만 사용할 수 있도록 제한해야 합니다.