mir.pe (일반/어두운 화면)
최근 수정 시각 : 2024-12-15 16:51:19

주석(언어)

1. 개요2. 종류
2.1. 위치별2.2. 내용별2.3. 기타
3. 주석학4. 각 분야별 주석
4.1. 논문4.2. 위키위키4.3. 프로그래밍 코드4.4. 법학4.5. 회계

1. 개요

註 釋

낱말이나 문장의 뜻을 쉽게 풀이함. 또는 그런 글. 다른 말로 전주(箋註), 주해(註解), 주문(註文)라고 한다. '주석을 다는 행위'는 현주(懸註), 주(註)내다라고도 한다.

영어로는 Annotation, Footnote, Note, Comment라고 한다.

2. 종류

2.1. 위치별

파일:samgang1.jpg 파일:external/cfs12.blog.daum.net/4844cdcd017e4&filename=%EC%8A%A4%EC%BA%940001.jpg
삼강행실도언해의 두주 훈민정음 언해본의 할주

2.2. 내용별

2.3. 기타

3. 주석학

경전 및 종교적으로 권위가 있는 문헌들, 성현들의 저술의 경우에는 원문을 손상시켜서는 안되므로 주석을 달아서 연구 결과를 나타냈다.
주자가 신유학의 본좌로 떠오른 것도 사서에 모두 주석을 달아 놓은 사서집주를 내놓았기 때문이다. 청대의 고증학도 주석학과 관련이 있는데 기존의 주석이 제대로 된 주석인지 다양한 방법으로 검증하거나 혹은 자신들이 고증한 내용을 토대로 새로운 주석을 다는 등의 일을 했기 때문이다.

경전 이외에도 오래된 역사서의 경우 소략한 서술에 구체적인 내용을 덧붙이거나, 전후 맥락을 설명하거나 또는 고증하기 위해 주석을 달아 놓는 경우가 있다. 일반적으로 잘 알려진 주석이라면 사기의 삼가주나 정사 삼국지의 배송지주 같은 것들이 있다. 하지만 번역 과정에서 다 날려 먹는다. TnT

동양 문헌의 주석은 많은 경우 1글자씩 적는 칸에 글자를 절반 크기로 적어 두 줄로 적는 식으로 된 것이 많다. 동양의 책은 줄[2]이 미리 그어져 있는 경우가 많기 때문에 생겨난 특징이다.

서양에서도 학문으로 발전한 것은 아니지만 권위있는 문헌에 주석을 다는 일이 있었다. 보통 책의 여백에다가 깨알같은 글씨로 다는 것이 보통. 가장 중요한 것은 뭐니뭐니해도 성경이었다. 성경의 원문을 훼손할 수 없으니 주석을 다는 식으로 해석했던 것이다. 그레고어 멘델은 종의 기원에다가 식물의 생식에 대한 오류[3]가 있음을 지적했고, 페르마가 디오판토스의 '아리스메티카'에다가 주석을 달았던 것이 수학계 최고의 난제였던 페르마의 마지막 정리가 되었다. 이외에도 비평을 남기는 경우도 있었다. 마르크스의 종교는 인민의 아편이다라는 유명한 말도 헤겔의 법철학 강요를 비평하며 남긴 유명한 어구.

4. 각 분야별 주석

4.1. 논문

논문에서는 출처를 필수적으로 기입해야 하기 때문에 인용주를 꼼꼼히 넣어두어야 한다. 인용주의 형식은 학술지마다 다르기 때문에 내기 전에 미리 확인해두어야 한다( 인용/스타일 참고). 주로 각주만 사용하거나, 각주+미주를 사용하거나, 각주+내주를 사용한다. 내주는 내용을 작성할 때 참고한 문헌을 참고문헌에 다같이 적기만 하고, 구체적으로 어떤 페이지의 어떤 문장을 인용했는지는 표기하지 않고 주로 페이지까지만 적는다.

본문에는 숫자만 두고 하단에 인용 정보를 적는 방식을 외(外)각주라고 하고, 본문에서 "김철수(2003:10)"[4]과 같이 "저자(연도:페이지)"를 적어넣고 참고문헌 목록에서 "저자(연도)"의 저서를 확인할 수 있게 하는 방식을 내(內)각주라고 한다. # 사실 내각주는 본 문서에서 다루는 나무위키의 각주의 형식으로 표현되는 것은 아니고 일종의 내주로 볼 수도 있다. 외각주 방식에서는 "김철수는 다음과 같이 말했다"와 같이 저자를 문장 안에서 직접적으로 언급하는 경우가 많다.

논문에서의 인용 각주의 양식에 대해서는 인용/스타일 문서를 참고하자.

4.2. 위키위키

페이지가 없는 인터넷 사이트의 특성상 책으로 치면 맨 끝에 나오는 미주의 형식을 하고 있다. 나무위키에서 특정 지점에 주석을 나오게 하는 명령어는 '\
[1] 후대에 의미가 흐려지긴 했지만, 원래는 성인이 쓴 것을 경, 거기에 현명한 학자가 주석을 덧붙인 것을 전이라 불렀다. 둘을 합쳐 '경전'이 되는 것이다. [2] 서지학에서는 이 선을 계선( 界 線)이라고 한다. [3] '암술머리에 적당한 양의 꽃가루가 묻어야 수정이 된다', 사실은 꽃가루 단 한 알 만으로도 수정이 가능하다. [4] 페이지는 생략할 수 있으나 연도는 필수적으로 적어야 한다. 저자와 연도가 동일한 논문을 2개 이상 인용할 경우 연도 뒤에 'a, b'(혹은 'ㄱ, ㄴ') 등을 붙인다.
또는\'이며, 각주를 입력하는 것은 '\[5]'이다. 자세한 설명은 각주 문서 참고.

이런 각주와 별도로, 아래 항목의 프로그래밍 코드의 주석의 의미에서 위키위키 문서를 작성하는 문법에서 주석을 지원한다. 이때 주석이 들어간 텍스트는 편집기를 켰을 때에만 표시되고 화면에는 출력되지 않는다. 이를테면 나무위키에서는 새 줄의 첫 부분에 ##를 친 뒤에 글을 쓰면 문서를 편집할 때만 보이는 주석이 된다. 복잡한 테이블(표)의 작성이나 난잡한 서술의 방지, 규칙에 대한 주의나 설명, 템플릿에 대한 설명 등을 위해 쓰인다. 예를 들면 다음과 같다.(편집기에 들어가야 보인다)

나무위키에서는 2024년 2월 말에 주석 기능이 강화되었다. 주석 입력시 맨 앞에 기존의 '##' 대신 '##@'를 입력하면 편집 창 상단에 ##@ 뒤의 내용이 출력되는 방식이다. 만약 표 문법을 비롯하여 한 줄을 넘는 문법으로 구성된 내용을 편집창 상단에 표시하고 싶다면 해당 줄마다 맨 앞에 ##@을 입력하면 된다. 적용례[6][7]

4.3. 프로그래밍 코드

코드를 짤 때 넣는 설명문이다.

코드를 읽는 사람으로 하여금 쉽게 이해할 수 있게 하기 위한 것으로 실행에는 영향을 미치지 않는다. 만약 주석이 없다면 코드를 짠 사람조차 코드를 작성한 직후가 아니라면 이해하지 못하는 사태가 벌어질 가능성도 있기 때문에 코딩에서 필수요소로 꼽힌다. 특히 시스템이 정교해질수록 프로그래머 개인이 감당하기 힘들 정도로 코드 수가 많아지고, 이에 따라 프로그래머 간 협업이 필수적으로 이루어짐에 따라 주석을 잘 다는 것도 프로그래머의 중요한 능력 중 하나로 평가받기도 한다. 비단 프로그래머들 간의 협업 뿐만 아니라 업무 인수인계 등에 있어서도 주석을 적절히 다는 것은 매우 중요하다. 주석이 없을 경우 벌어지는 일

단순히 이 코드나 이 부분이 어떤 역할을 한다고 설명하는 역할 외에도 디버깅하는 상황에서 매우 유용한 도구이기도 하다. 만약 코드 어딘가에 문제가 있어서 원하는대로 실행이 안 되거나 실행은 되는데 의도하지 않은 결과를 내놓는다면 어디가 문제인지 찾아내야 하는데, 주석을 이용해서 일정 구간을 주석 처리하여 실행되지 않게 만든 후 다시 프로그램을 실행했을 때 진행이 막혀버리던 문제 등이 해결된다면 해당 주석 처리된 코드 내에 뭔가 문제가 있음을 알아낼 수 있다.

프로그래밍 언어마다 주석을 넣는 방식이 다른데, 예를 들어 C언어, C++, C#, Java에서는 슬래시 두 개(//)를 연속으로 놓으면 한 줄에서 그 뒷부분은 모조리 주석으로 처리하고, /* 주석 처리할 구역 */ 식으로 쓰면 사이에 있는 내용을 주석으로 처리한다. Ruby나 Python에서는 # 표시를 줄 앞에(혹은 줄 뒤에 주석을 짤막하게 넣고자 할 때 넣을 주석의 바로 앞에) 붙이는 것으로 하거나 주석 처리하고자 하는 문 앞뒤로 '''(작은 따옴표 3개)를 붙여서 주석 처리를 할 수 있고 BASIC에서는 특정 줄에서 REM 명령문 또는 작은따옴표(')를 찍으면 그 뒤로 주석처리된다. 프로그래밍 언어는 아니지만 마크업 언어인 HTML이나 XML에서도 주석 기능이 있는데, <!-- 주석 --> 이렇게 주석처리를 할 수 있다. 줄마다 맨 앞에 주석 처리를 넣는 건 주석처리 하려는 부분을 드래그하고 Ctrl + /를 누르면 된다. 나무위키에서도 적용되는 기능.[8]

쓸모 없어진 구버전 코드를 삭제하지 않고 주석 처리하는 것은 좋지 않은 습관으로, SonarQube 등의 코드 분석 도구에서도 주요 이슈로 처리하여 수정을 권장하고 있다. 코드의 가독성을 해칠 뿐만 아니라, 주석 처리된 코드가 풀리면 자칫 예기치 못한 오류를 발생시킬 수도 있기 때문이다. 구문 강조 기능이 기본 옵션으로 달려 있는 에디터라면 그나마 사정이 좋지만, 이 마저도 IDE에서 편집하는 경우는 자동 포매팅으로 인해 해당 코드의 가독성이 저해될 가능성도 크다. 따라서 이런 코드는 최신 버전에서 과감하게 삭제하고, 대신 구버전은 Git 같은 소스 관리 도구나 다른 곳에 백업하는 것이 옳다. 삭제는 해야 하는데 협업 특성상 곤란한 경우는 Java의 @Deprecated 같은 기능을 병용하여 삭제 예정 코드의 위치와 그 사유를 명시하고, 이후 참조가 모두 해제됐다면 그 때 과감하게 삭제하면 된다.

4.4. 법학

법학에서는 주석서라는 부류의 전문서적이 있다. 이는 법률의 조문별로 그 조문에 관한 학설, 판례 등을 정리해 놓은 책을 말한다. 법학 교과서가 일정한 체계에 따라 학설, 판례 등을 정리해 놓은 것과 대조를 이룬다. 주석서든 교과서든 다루는 대상이 상당히 겹치기는 하지만, 교과서는 여러 이유에서 어떤 특정 문제를 상세히 논하기 어려운 면이 있으므로 그런 상세한 내용은 주석서에 정리되게 된다. 따라서, 법조인들 역시 교과서를 찾아봐도 잘 모르겠다 싶은 내용이 있으면 그 다음 순서로 주석서를 찾아보는 예가 많다.

영미법계에서는 아예 법전 자체를 주석이 붙은 형태로 간행하는 관행이 있는 듯. 미국의 U.S.C.A.(United States Code Annotated)가 대표적인 예이고, 영국의 'Halsbury's Statutes of England and Wales'도 그러하며, 미국의 법재록(法再錄)(Restatement)도[9] 단순한 조문 나열이 아니라 주석이 붙은 형태로 되어 있다.

4.5. 회계

재무제표
{{{#!wiki style="margin: 0 -10px -5px; min-height: 26px"
{{{#!folding [ 펼치기 · 접기 ]
{{{#!wiki style="margin: -6px -1.5px -13px" 		재무상태표
자산 유동자산 : 당좌자산 · 재고자산 · 매출채권
비유동자산 : 투자자산 · 유형자산 · 무형자산 		부채 유동부채 : 단기차입금 · 미지급금 · 매입채무
비유동부채 : 장기차입금 · 회사채
자본 자본금 · 자본잉여금 · 자본조정 · 이익잉여금
포괄손익계산서
수익 비용
매출액 · 금융수익 · 영업외수익 매출원가 · 판매비와 관리비 · 법인세비용
영업이익 · EBITDA · 당기순이익 · FFO · AFFO
자본변동표
유상증자 · 배당 · 자기주식취득 및 소각
현금흐름표
영업활동 · 투자활동 · 재무활동
주석
※ DART의 삼성전자 사업보고서의 재무제표 항목 순서로 나열함.
※ 기타 다른 항목들에 대해서는 회계/용어를 참고.
}}}}}}}}} ||

주석은 재무상태표, 포괄손익계산서, 자본변동표 및 현금흐름표에 표시하는 정보에 추가하여 제공된 정보를 뜻한다. 주석은 상기 재무제표에 표시된 항목을 구체적으로 설명하거나 세분화하며, 상기 재무제표 인식요건을 충족하지 못하는 항목에 대한 정보를 제공한다. [10]

학교에서 회계학을 배울 때에는 비중이 제일 적다. 그럴 수밖에 없는 것이 회계의 정의에 부합하는 정보를 제공하기 위하여[11] 주석 외[12] 재무제표에 나타난 수치, 그러니까 산출된 수치의 근거와 설명을 하기 위해 주석이 존재하는 것이다.

흔히 주식이나 재무정보를 본다면서 주석 외 재무제표만 보는 사람들이 있는데 이는 재무제표가 제공한 정보의 극히 일부분만 보는 것이다. 다만 회계정보의 해석에 어느 정도 익숙한 이들은[13] 주석을 참고하지 않고 주석 외 재무제표만 보아도 어느 정도 정확하게 기업을 파악할 수 있기도 하다. 이런 경지에 다다르면 그야말로 주석은 그 말뜻처럼 참고 수준의 내용이라 할 수 있다.

'주석'이라는 용어는 언뜻 보기에 '추가적인 설명'일 것처럼 보이지만, 사실상 나머지 재무제표가 표현하고 있는 회계정보에 대한 모든 설명의 집합체이다.
[5] (각주 내용) [6] 링크는 나무위키 숏스택 문서의 r100 버전과 r101 버전의 비교 페이지이다. [7] 참고로 이렇게 틀을 적용하면 해당 틀의 역링크에 표시되지 않는다. 고정 주석도 주석이기 때문. [8] Microsoft 입력기가 아닌 한글 입력기의 영어 입력 모드로 하면 작동하지 않기도 하는데, 그럴 땐 한영 키를 눌러 영어 입력 모드에서 벗어나거나 Ctrl + Shift로 입력기를 전환하면 된다. [9] 이는 판례법을 법조문 형태로 재정리한 것이다. [10] K-IFRS 1001 문단 7의 정의 및 설명 [11] 회계의 정의는 항상 유용한 정보의 제공이다. [12] 주석을 제외한 나머지 4개 표만을 재무제표라 하고 주석은 재무제표와 별도의 것이라 생각하기 쉬운데 그렇지 않다. 재무상태표·손익계산서·자본변동표·현금흐름표 4개를 아울러 이르는 말은 '주석 외 재무제표'가 올바른 표현. [13] 예를 들면, 재무제표 각 항목별 동종업계 평균의 수치·재무비율 등과 그 기업의 재무제표에 나타나는 수치를 비교할 수 있는 사람. 회계사나 세무사 중에서도 그런 해석 능력을 갖춘 사람은 많지 않다.

분류