본문 바로가기
C.W.K.
Stream
Lesson 08 of 10 · published

도움 받기: --help / tldr / cheat.sh

~15 min · help, tldr, cheat, documentation

Level 0창 구경꾼
0 XP0/95 lessons0/14 achievements
0/100 XP to next level100 XP to go0% complete

도움말은 필요한 깊이에 맞춰 골라

명령을 어떻게 호출하는지만 궁금할 때와 구현의 정확한 계약이 필요할 때는 읽어야 할 문서가 달라. 짧은 사용법은 --help, 대표 예시는 tldr, 설치된 구현의 전체 계약은 man, 낯선 문제의 탐색은 cheat.sh가 빠른 출발점이야. 한 도구가 다른 도구를 완전히 대신하는 것이 아니라 질문의 깊이에 따라 순서를 바꾸는 거야.

--help: 가장 가까운 첫 답

현대 CLI는 대개 command --help에서 사용법, 하위 명령과 주요 옵션을 보여 줘. 어떤 전통적인 명령은 -h를 쓰거나 별도 도움말 형식을 제공하므로 둘을 같은 뜻으로 가정하지 마. 출력이 길면 command --help | less로 읽고, 실제 버전과 함께 기록하면 다른 머신에서 옵션이 없을 때 원인을 찾기 쉬워.

tldr: 대표 예제로 감 잡기

tldr tar, tldr rsync처럼 실행하면 자주 쓰는 작업을 실제 한 줄 명령으로 보여 줘. 추상적인 옵션 목록보다 “압축을 풀려면”, “권한을 보존해 복사하려면” 같은 질문에 빨리 답해. 다만 커뮤니티 예시는 모든 버전과 경계 조건을 다루지 않으므로 중요한 작업에서는 매뉴얼과 시험 실행으로 확인해야 해.

cheat.sh: 설치 없이 질문하기

curl cheat.sh/find처럼 명령 이름을 URL에 붙여 요약을 볼 수 있어. 프로그래밍 언어나 조합형 질문도 검색할 수 있어서 막연한 시작점에서 후보를 찾기 좋아. 네트워크 응답을 그대로 실행하지 말고 읽을 자료로만 사용해. 자주 보는 항목은 로컬 메모에 저장하면 서비스가 없을 때도 다시 확인할 수 있어.

info: GNU 문서의 연결 구조

GNU 프로젝트 가운데 일부는 매뉴얼 페이지보다 info 문서를 더 자세히 관리해. info coreutils는 장과 절을 이동하는 하이퍼텍스트 문서로 열리고, 개념 설명과 예제가 풍부할 수 있어. 평소에는 --help와 man으로 충분해도 GNU 특유의 동작을 깊이 확인할 때 유용해.

실전에서는 빠른 답에서 정확한 계약으로 내려가

  1. 대표 동작을 보려면 tldr.
  2. 옵션 이름과 호출 형태는 --help.
  3. 종료 상태와 경계 조건은 man 또는 공식 문서.
  4. 이름조차 모르면 apropos나 cheat.sh로 후보 탐색.

복사한 예제는 입력과 출력, 변경 범위를 이해한 뒤 작은 표본에서 실행해. 도움말을 읽었다는 사실보다 현재 바이너리에서 원하는 결과와 실패 상태를 확인했다는 증거가 더 중요해.

Code

tldr 설치하고 써보기·bash
brew install tlrc          # Rust로 만든 빠른 클라이언트
tldr tar
tldr ssh
tldr --update              # 로컬 페이지 갱신
cheat.sh: 설치 없이 바로·bash
curl cheat.sh/find
curl cheat.sh/rsync
curl 'cheat.sh/python/sort+dict+by+value'
# 별칭으로 짧게 부르기
echo 'cheat() { curl -s "cheat.sh/$1"; }' >> ~/.zshrc

External links

Exercise

brew install tlrc로 tldr 클라이언트를 설치한 뒤 tldr ssh, tldr rsync, tldr docker를 열어 봐. 자주 쓰는 명령에서 처음 보는 플래그 하나를 기록하고, curl cheat.sh/find의 요약과 로컬 매뉴얼이 설명하는 현재 구현을 비교해.

Progress

Progress is local-only — sign in to sync across devices.
이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

댓글 0

🔔 답글 알림 (로그인 필요)
로그인댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.