diff options
Diffstat (limited to 'upstream/debian-bookworm/man1/perlko.1')
| -rw-r--r-- | upstream/debian-bookworm/man1/perlko.1 | 377 |
1 files changed, 377 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man1/perlko.1 b/upstream/debian-bookworm/man1/perlko.1 new file mode 100644 index 00000000..52e2625a --- /dev/null +++ b/upstream/debian-bookworm/man1/perlko.1 @@ -0,0 +1,377 @@ +.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) +.\" +.\" Standard preamble: +.\" ======================================================================== +.de Sp \" Vertical space (when we can't use .PP) +.if t .sp .5v +.if n .sp +.. +.de Vb \" Begin verbatim text +.ft CW +.nf +.ne \\$1 +.. +.de Ve \" End verbatim text +.ft R +.fi +.. +.\" Set up some character translations and predefined strings. \*(-- will +.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left +.\" double quote, and \*(R" will give a right double quote. \*(C+ will +.\" give a nicer C++. Capital omega is used to do unbreakable dashes and +.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, +.\" nothing in troff, for use with C<>. +.tr \(*W- +.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.ie n \{\ +. ds -- \(*W- +. ds PI pi +. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch +. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch +. ds L" "" +. ds R" "" +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds -- \|\(em\| +. ds PI \(*p +. ds L" `` +. ds R" '' +. ds C` +. ds C' +'br\} +.\" +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" +.\" If the F register is >0, we'll generate index entries on stderr for +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index +.\" entries marked with X<> in POD. Of course, you'll have to process the +.\" output yourself in some meaningful fashion. +.\" +.\" Avoid warning from groff about undefined register 'F'. +.de IX +.. +.nr rF 0 +.if \n(.g .if rF .nr rF 1 +.if (\n(rF:(\n(.g==0)) \{\ +. if \nF \{\ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" +.. +. if !\nF==2 \{\ +. nr % 0 +. nr F 2 +. \} +. \} +.\} +.rr rF +.\" ======================================================================== +.\" +.IX Title "PERLKO 1" +.TH PERLKO 1 "2023-11-25" "perl v5.36.0" "Perl Programmers Reference Guide" +.\" For nroff, turn off justification. Always turn off hyphenation; it makes +.\" way too many mistakes in technical documents. +.if n .ad l +.nh +이 파일을 내용 그대로 읽고 있다면 우스꽝스러운 문자는 무시해주세요. +이 문서는 POD로 읽을 수 있도록 \s-1POD\s0 형식(\fIpod/perlpod.pod\fR 문서를 +확인하세요)으로 작성되어 있습니다. +.SH "NAME" +perlko \- 한국어 Perl 안내서 +.SH "DESCRIPTION" +.IX Header "DESCRIPTION" +Perl의 세계에 오신 것을 환영합니다! +.PP +Perl은 가끔 \fB'Practical Extraction and Report Language'\fR라고 하기도 합니다만 +다른 널리 알려진 것들 중에서 \fB'Pathologically Eclectic Rubbish Lister'\fR라고 +하기도 합니다. 사실 이것은 끼워 맞춘 것이며 Perl이 이것들의 첫 글자를 +가져와서 이름을 붙인 것은 아닙니다. Perl의 창시자 Larry가 첫 번째 이름을 +먼저 생각했고 널리 알려진 것을 나중에 지었기 때문입니다. 그렇기 때문에 +\&\fB'Perl'\fR은 모두 대문자가 아닙니다. 널리 알려진 어떤 것을 가지고 논쟁하는 +것은 의미가 없습니다. Larry는 두 개 다 지지합니다. +.PP +가끔 p가 소문자로 작성된 \fB'perl'\fR을 볼 것입니다. P가 대문자로 되어 있는 +\&\fB'Perl'\fR은 언어를 참조할 때 쓰이며 \fB'perl'\fR처럼 p가 소문자인 경우는 여러분의 +프로그램을 컴파일하고 돌릴 때 사용되는 해석기를 지칭할 때 사용됩니다. +.SH "Perl에 관하여" +.IX Header "Perl에 관하여" +Perl은 본래 문자열 생성을 위해 만들졌지만 지금은 시스템 관리와 웹 개발, +네트워크 프로그래밍, \s-1GUI\s0 개발 등을 포함한 여러 분야에서 널리 사용되는 +범용 프로그래밍 언어입니다. +.PP +이 언어는 아름다움(아주 작고, 우아하고, 아주 적고)보다 +실용적(사용하기 쉽고, 효율적이며, 가능한 최대한)인 것을 지향하고 있습니다. +사용하기 쉽고, 절차적 프로그래밍과 객체 지향 프로그래밍을 모두 지원하고, +강력한 문자열 처리 기능을 내장하고, 세상에서 가장 인상적인 제 3자의 모듈 +모음처를 가지고 있다는 것은 Perl의 가장 중요한 특징입니다. +.PP +Perl의 언어적 특징은 \fIpod/perlintro.pod\fR 문서에서 소개합니다. +.PP +이번 릴리스에서 가장 중요한 변화는 \fIpod/perldelta.pod\fR에서 논의합니다. +.PP +또한 다양한 출판사가 출판한 많은 Perl 책은 다양한 주제를 다루고 있습니다. +자세한 정보는 \fIpod/perlbook.pod\fR 문서를 확인하세요. +.SH "설치" +.IX Header "설치" +여러분이 비교적 현대의 운영체제를 사용하고 있고 현재 버전의 Perl을 +지역적으로 설치하고 싶다면 다음 명령을 실행하세요. +.PP +.Vb 3 +\& ./Configure \-des \-Dprefix=$HOME/localperl +\& make test +\& make install +.Ve +.PP +앞의 명령은 여러분의 플랫폼에 맞게 환경을 설정하고 컴파일을 수행한 후, +회기 테스트를 수행한뒤, 홈 디렉터리 하부의 \fIlocalperl\fR 디렉터리에 perl을 +설치합니다. +.PP +여러분이 어떠한 문제든 겪게 되거나 사용자 정의 버전 Perl을 설치할 필요가 있다면 +현재 배포판에 들어있는 \fI\s-1INSTALL\s0\fR 파일 안의 자세한 설명을 읽어야 합니다. +추가적으로 일반적이지 않은 다양한 플랫폼에서 Perl을 빌드하고 사용하는 +방법에 대한 도움말과 귀띔이 적혀있는 많은 수의 \fI\s-1README\s0\fR 파일이 있습니다. +.PP +일단 Perl을 설치하고 나면 \f(CW\*(C`perldoc\*(C'\fR 도구를 이용해 풍부한 문서를 사용할 +수 있습니다. 시작하기 위해서 다음 명령을 실행하세요. +.PP +.Vb 1 +\& perldoc perl +.Ve +.SH "실행에 어려움을 겪는다면" +.IX Header "실행에 어려움을 겪는다면" +Perl은 뜨개질에서 부터 로켓 과학까지 모든 분야에서 사용할 수 있는 크고 +복잡한 시스템입니다. 여러분이 어려움에 부딪혔을때 그 문제는 이미 다른 +사람이 해결했을 가능성이 높습니다. 문서를 모두 확인했는데도 버그가 +확실하다면 \f(CW\*(C`perlbug\*(C'\fR 도구를 이용해서 저희에게 버그를 보고해주세요. +\&\f(CW\*(C`perlbug\*(C'\fR에 대한 더 자세한 정보는 \f(CW\*(C`perldoc perlbug\*(C'\fR 또는 \f(CW\*(C`perlbug\*(C'\fR를 +명령줄에서 실행해서 확인할 수 있습니다. +.PP +Perl을 사용 가능하게 만들었다 하더라도 Perl은 계속해서 진화하기 때문에 +여러분이 맞닥뜨린 버그를 수정했거나 여러분이 유용하다고 생각할법한 +새로운 기능이 추가된 좀 더 최신 버전이 있을 수 있습니다. +.PP +여러분은 항상 최신 버전의 perl을 \s-1CPAN\s0 (Comprehensive Perl Archive Network) +사이트 <http://www.cpan.org/src/> 에서 찾을 수 있습니다. +.PP +perl 소스에 간단한 패치를 등록하고 싶다면 \fIpod/perlhack.pod\fR 문서의 +\&\fB\*(L"\s-1SUPER QUICK PATCH GUIDE\*(R"\s0\fR를 살펴보세요. +.PP +그냥 개인적으로 참고하세요. +제가 이것처럼 멋진 물건을 만든다는 것을 여러분이 알기를 바랍니다. +그것은 제 이야기의 \fB\*(L"저자(Author)\*(R"\fR를 기쁘게하기 때문입니다. +이것이 여러분을 귀찮게 한다면 여러분의 \fB\*(L"저작(Authorship)\*(R"\fR에 +대한 생각을 정정해야 할 수도 있습니다. 하지만 어쨌거나 여러분은 +Perl을 사용하는데는 문제가 없답니다. :\-) +.PP +\&\- \fB\*(L"저자\*(R"\fR로부터. +.SH "인코딩" +.IX Header "인코딩" +Perl은 5.8.0판부터 유니코드/ISO 10646에 대해 광범위하게 지원합니다. +유니코드 지원의 일환으로 한중일을 비롯한 세계 각국에서 +유니코드 이전에 쓰고 있었고 지금도 널리 쓰이고 있는 수많은 인코딩을 +지원합니다. 유니코드는 전 세계에서 쓰이는 모든 언어를 위한 +표기 체계(유럽의 라틴 알파벳, 키릴 알파벳, 그리스 알파벳, 인도와 동남 아시아의 +브라미 계열 스크립트, 아랍 문자, 히브리 문자, 한중일의 한자, 한국어의 한글, +일본어의 가나, 북미 인디안의 표기 체계 등)를 수용하는 것을 목표로 하고 +있기 때문에 기존에 쓰이던 각 언어 및 국가 그리고 운영 체계에 고유한 +문자 집합과 인코딩에 쓸 수 있는 모든 글자는 물론이고 기존 문자 집합에서 +지원하고 있지 않던 아주 많은 글자를 포함하고 있습니다. +.PP +Perl은 내부적으로 유니코드를 문자 표현을 위해 사용합니다. +보다 구체적으로 말하면 Perl 스크립트 안에서 \s-1UTF\-8\s0 문자열을 쓸 수 있고, +각종 함수와 연산자(예를 들어, 정규식, index, substr)가 바이트 단위 +대신 유니코드 글자 단위로 동작합니다. +더 자세한 것은 \fIpod/perlunicode.pod\fR 문서를 참고하세요. +유니코드가 널리 보급되기 전에 널리 쓰이고 있었고, 여전히 널리 쓰이고 있는 +각국/각 언어별 인코딩으로 입출력을 하고 이들 인코딩으로 된 데이터와 문서를 +다루는 것을 돕기 위해 Encode 모듈이 쓰이고 있습니다. +무엇보다 Encode 모듈을 사용하면 수많은 인코딩 사이의 변환을 쉽게 할 수 있습니다. +.SS "Encode 모듈" +.IX Subsection "Encode 모듈" +\fI지원 인코딩\fR +.IX Subsection "지원 인코딩" +.PP +Encode 모듈은 다음과 같은 한국어 인코딩을 지원합니다. +.IP "\(bu" 4 +\&\f(CW\*(C`euc\-kr\*(C'\fR +.Sp +US\-ASCII와 \s-1KS X\s0 1001을 같이 쓰는 멀티바이트 인코딩으로 흔히 +완성형이라고 불림. \s-1KS X\s0 2901과 \s-1RFC 1557\s0 참고. +.IP "\(bu" 4 +\&\f(CW\*(C`cp949\*(C'\fR +.Sp +MS-Windows 9x/ME에서 쓰이는 확장 완성형. euc\-kr에 8,822자의 +한글 음절을 더한 것임. alias는 uhc, windows\-949, x\-windows\-949, +ks_c_5601\-1987. 맨 마지막 이름은 적절하지 않은 이름이지만, Microsoft +제품에서 CP949의 의미로 쓰이고 있음. +.IP "\(bu" 4 +\&\f(CW\*(C`johab\*(C'\fR +.Sp +\&\s-1KS X 1001:1998\s0 부록 3에서 규정한 조합형. 문자 레퍼토리는 cp949와 마찬가지로 +US\-ASCII와 \s-1KS X\s0 1001에 8,822자의 한글 음절을 더한 것으로 인코딩 방식은 전혀 다름. +.IP "\(bu" 4 +\&\f(CW\*(C`iso\-2022\-kr\*(C'\fR +.Sp +\&\s-1RFC\s0 1557에서 규정한 한국어 인터넷 메일 교환용 인코딩으로 US\-ASCII와 +\&\s-1KS X\s0 1001을 레퍼토리로 하는 점에서 euc\-kr과 같지만 인코딩 방식이 다름. +1997\-8년 경까지 쓰였으나 더 이상 메일 교환에 쓰이지 않음. +.IP "\(bu" 4 +\&\f(CW\*(C`ksc5601\-raw\*(C'\fR +.Sp +\&\s-1KS X 1001\s0(\s-1KS C 5601\s0)을 \s-1GL\s0(즉, MSB를 0으로 한 경우)에 놓았을 때의 인코딩. +US\-ASCII와 결합하지 않고 단독으로 쓰이는 일은 X11 등에서 글꼴 +인코딩(ksc5601.1987\-0. '0'은 GL을 의미함)으로 쓰이는 것을 제외하고는 +거의 없음. \s-1KS C\s0 5601은 1997년 \s-1KS X\s0 1001로 이름을 바꾸었음. 1998년에는 두 +글자(유로화 부호와 등록 상표 부호)가 더해졌음. +.PP +\fI변환 예제\fR +.IX Subsection "변환 예제" +.PP +예를 들어, euc-kr 인코딩으로 된 파일을 UTF\-8로 변환하려면 +명령줄에서 다음처럼 실행합니다. +.PP +.Vb 1 +\& perl \-Mencoding=euc\-kr,STDOUT,utf8 \-pe1 < file.euc\-kr > file.utf8 +.Ve +.PP +반대로 변환할 경우 다음처럼 실행합니다. +.PP +.Vb 1 +\& perl \-Mencoding=utf8,STDOUT,euc\-kr \-pe1 < file.utf8 > file.euc\-kr +.Ve +.PP +이런 변환을 좀더 편리하게 할 수 있도록 도와주는 \fIpiconv\fR가 Perl에 +기본으로 들어있습니다. 이 유틸리티는 Encode 모듈을 이용한 순수 Perl +유틸리티로 이름에서 알 수 있듯이 Unix의 \f(CW\*(C`iconv\*(C'\fR를 모델로 한 것입니다. +사용법은 다음과 같습니다. +.PP +.Vb 2 +\& piconv \-f euc\-kr \-t utf8 < file.euc\-kr > file.utf8 +\& piconv \-f utf8 \-t euc\-kr < file.utf8 > file.euc\-kr +.Ve +.PP +\fI모범 사례\fR +.IX Subsection "모범 사례" +.PP +Perl은 기본적으로 내부에서 UTF\-8을 사용하며 Encode 모듈을 통해 +다양한 인코딩을 지원하지만 항상 다음 규칙을 지킴으로써 인코딩과 +관련한 다양하게 발생할 수 있는 문제의 가능성을 줄이는 것을 추천합니다. +.IP "\(bu" 4 +소스 코드는 항상 \s-1UTF\-8\s0 인코딩으로 저장 +.IP "\(bu" 4 +소스 코드 상단에 \f(CW\*(C`use utf8;\*(C'\fR 프라그마 사용 +.IP "\(bu" 4 +소스 코드, 터미널, 운영체제, 데이터 인코딩을 분리해서 이해 +.IP "\(bu" 4 +입출력 파일 핸들에 명시적인 인코딩을 사용 +.IP "\(bu" 4 +중복(double) 인코딩을 주의 +.PP +\fI유니코드 및 한국어 인코딩 관련 자료\fR +.IX Subsection "유니코드 및 한국어 인코딩 관련 자료" +.IP "\(bu" 4 +perluniintro +.IP "\(bu" 4 +perlunicode +.IP "\(bu" 4 +Encode +.IP "\(bu" 4 +Encode::KR +.IP "\(bu" 4 +encoding +.IP "\(bu" 4 +<https://www.unicode.org/> +.Sp +유니코드 컨소시엄 +.IP "\(bu" 4 +<http://std.dkuug.dk/JTC1/SC2/WG2> +.Sp +기본적으로 Unicode와 같은 \s-1ISO\s0 표준인 \s-1ISO/IEC 10646 UCS\s0(Universal +Character Set)을 만드는 \s-1ISO/IEC\s0 JTC1/SC2/WG2의 웹 페이지 +.IP "\(bu" 4 +<https://www.cl.cam.ac.uk/~mgk25/unicode.html> +.Sp +유닉스/리눅스 사용자를 위한 \s-1UTF\-8\s0 및 유니코드 관련 \s-1FAQ\s0 +.IP "\(bu" 4 +<http://wiki.kldp.org/Translations/html/UTF8\-Unicode\-KLDP/UTF8\-Unicode\-KLDP.html> +.Sp +유닉스/리눅스 사용자를 위한 \s-1UTF\-8\s0 및 유니코드 관련 FAQ의 한국어 번역 +.SH "Perl 관련 자료" +.IX Header "Perl 관련 자료" +다음은 공식적인 Perl 관련 자료중 일부입니다. +.IP "\(bu" 4 +<https://www.perl.org/> +.Sp +Perl 공식 홈페이지 +.IP "\(bu" 4 +<https://www.perl.com/> +.Sp +O'Reilly의 Perl 웹 페이지 +.IP "\(bu" 4 +<https://www.cpan.org/> +.Sp +\&\s-1CPAN\s0 \- Comprehensive Perl Archive Network, 통합적 Perl 파일 보관 네트워크 +.IP "\(bu" 4 +<https://metacpan.org> +.Sp +메타 \s-1CPAN\s0 +.IP "\(bu" 4 +<https://lists.perl.org/> +.Sp +Perl 메일링 리스트 +.IP "\(bu" 4 +<http://blogs.perl.org/> +.Sp +Perl 메타 블로그 +.IP "\(bu" 4 +<https://www.perlmonks.org/> +.Sp +Perl 수도승들을 위한 수도원 +.IP "\(bu" 4 +<https://www.pm.org/groups/asia.html> +.Sp +아시아 지역 Perl 몽거스 모임 +.IP "\(bu" 4 +<http://www.perladvent.org/> +.Sp +Perl 크리스마스 달력 +.PP +다음은 Perl을 더 깊게 공부하는데 도움을 줄 수 있는 한국어 관련 사이트입니다. +.IP "\(bu" 4 +<https://perl.kr/> +.Sp +한국 Perl 커뮤니티 공식 포털 +.IP "\(bu" 4 +<https://doc.perl.kr/> +.Sp +Perl 문서 한글화 프로젝트 +.IP "\(bu" 4 +<https://cafe.naver.com/perlstudy.cafe> +.Sp +네이버 Perl 카페 +.IP "\(bu" 4 +<http://www.perl.or.kr/> +.Sp +한국 Perl 사용자 모임 +.IP "\(bu" 4 +<https://advent.perl.kr> +.Sp +Seoul.pm Perl 크리스마스 달력 (2010 ~ 2012) +.IP "\(bu" 4 +<http://gypark.pe.kr/wiki/Perl> +.Sp +\&\s-1GYPARK\s0(Geunyoung Park)의 Perl 관련 한글 문서 저장소 +.SH "라이센스" +.IX Header "라이센스" +\&\fI\s-1README\s0\fR 파일의 \fB'\s-1LICENSING\s0'\fR 항목을 참고하세요. +.SH "AUTHORS" +.IX Header "AUTHORS" +.IP "\(bu" 4 +Jarkko Hietaniemi <jhi@iki.fi> +.IP "\(bu" 4 +신정식 <jshin@mailaps.org> +.IP "\(bu" 4 +김도형 <keedi@cpan.org> |