diff options
Diffstat (limited to 'upstream/archlinux/man1/perlko.1perl')
| -rw-r--r-- | upstream/archlinux/man1/perlko.1perl | 358 |
1 files changed, 358 insertions, 0 deletions
diff --git a/upstream/archlinux/man1/perlko.1perl b/upstream/archlinux/man1/perlko.1perl new file mode 100644 index 00000000..ac470bb2 --- /dev/null +++ b/upstream/archlinux/man1/perlko.1perl @@ -0,0 +1,358 @@ +.\" -*- mode: troff; coding: utf-8 -*- +.\" Automatically generated by Pod::Man 5.01 (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 +.. +.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. +.ie n \{\ +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. 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 1perl" +.TH PERLKO 1perl 2024-02-11 "perl v5.38.2" "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 +.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은 본래 문자열 생성을 위해 만들졌지만 지금은 시스템 관리와 웹 개발, +네트워크 프로그래밍, GUI 개발 등을 포함한 여러 분야에서 널리 사용되는 +범용 프로그래밍 언어입니다. +.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을 설치할 필요가 있다면 +현재 배포판에 들어있는 \fIINSTALL\fR 파일 안의 자세한 설명을 읽어야 합니다. +추가적으로 일반적이지 않은 다양한 플랫폼에서 Perl을 빌드하고 사용하는 +방법에 대한 도움말과 귀띔이 적혀있는 많은 수의 \fIREADME\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을 CPAN (Comprehensive Perl Archive Network) +사이트 <http://www.cpan.org/src/> 에서 찾을 수 있습니다. +.PP +perl 소스에 간단한 패치를 등록하고 싶다면 \fIpod/perlhack.pod\fR 문서의 +\&\fB"SUPER QUICK PATCH GUIDE"\fR를 살펴보세요. +.PP +그냥 개인적으로 참고하세요. +제가 이것처럼 멋진 물건을 만든다는 것을 여러분이 알기를 바랍니다. +그것은 제 이야기의 \fB"저자(Author)"\fR를 기쁘게하기 때문입니다. +이것이 여러분을 귀찮게 한다면 여러분의 \fB"저작(Authorship)"\fR에 +대한 생각을 정정해야 할 수도 있습니다. 하지만 어쨌거나 여러분은 +Perl을 사용하는데는 문제가 없답니다. :\-) +.PP +\&\- \fB"저자"\fR로부터. +.SH 인코딩 +.IX Header "인코딩" +Perl은 5.8.0판부터 유니코드/ISO 10646에 대해 광범위하게 지원합니다. +유니코드 지원의 일환으로 한중일을 비롯한 세계 각국에서 +유니코드 이전에 쓰고 있었고 지금도 널리 쓰이고 있는 수많은 인코딩을 +지원합니다. 유니코드는 전 세계에서 쓰이는 모든 언어를 위한 +표기 체계(유럽의 라틴 알파벳, 키릴 알파벳, 그리스 알파벳, 인도와 동남 아시아의 +브라미 계열 스크립트, 아랍 문자, 히브리 문자, 한중일의 한자, 한국어의 한글, +일본어의 가나, 북미 인디안의 표기 체계 등)를 수용하는 것을 목표로 하고 +있기 때문에 기존에 쓰이던 각 언어 및 국가 그리고 운영 체계에 고유한 +문자 집합과 인코딩에 쓸 수 있는 모든 글자는 물론이고 기존 문자 집합에서 +지원하고 있지 않던 아주 많은 글자를 포함하고 있습니다. +.PP +Perl은 내부적으로 유니코드를 문자 표현을 위해 사용합니다. +보다 구체적으로 말하면 Perl 스크립트 안에서 UTF\-8 문자열을 쓸 수 있고, +각종 함수와 연산자(예를 들어, 정규식, 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와 KS X 1001을 같이 쓰는 멀티바이트 인코딩으로 흔히 +완성형이라고 불림. KS X 2901과 RFC 1557 참고. +.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 +KS X 1001:1998 부록 3에서 규정한 조합형. 문자 레퍼토리는 cp949와 마찬가지로 +US\-ASCII와 KS X 1001에 8,822자의 한글 음절을 더한 것으로 인코딩 방식은 전혀 다름. +.IP \(bu 4 +\&\f(CW\*(C`iso\-2022\-kr\*(C'\fR +.Sp +RFC 1557에서 규정한 한국어 인터넷 메일 교환용 인코딩으로 US\-ASCII와 +KS X 1001을 레퍼토리로 하는 점에서 euc\-kr과 같지만 인코딩 방식이 다름. +1997\-8년 경까지 쓰였으나 더 이상 메일 교환에 쓰이지 않음. +.IP \(bu 4 +\&\f(CW\*(C`ksc5601\-raw\*(C'\fR +.Sp +KS X 1001(KS C 5601)을 GL(즉, MSB를 0으로 한 경우)에 놓았을 때의 인코딩. +US\-ASCII와 결합하지 않고 단독으로 쓰이는 일은 X11 등에서 글꼴 +인코딩(ksc5601.1987\-0. '0'은 GL을 의미함)으로 쓰이는 것을 제외하고는 +거의 없음. KS C 5601은 1997년 KS X 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 +소스 코드는 항상 UTF\-8 인코딩으로 저장 +.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와 같은 ISO 표준인 ISO/IEC 10646 UCS(Universal +Character Set)을 만드는 ISO/IEC JTC1/SC2/WG2의 웹 페이지 +.IP \(bu 4 +<https://www.cl.cam.ac.uk/~mgk25/unicode.html> +.Sp +유닉스/리눅스 사용자를 위한 UTF\-8 및 유니코드 관련 FAQ +.IP \(bu 4 +<http://wiki.kldp.org/Translations/html/UTF8\-Unicode\-KLDP/UTF8\-Unicode\-KLDP.html> +.Sp +유닉스/리눅스 사용자를 위한 UTF\-8 및 유니코드 관련 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 +CPAN \- Comprehensive Perl Archive Network, 통합적 Perl 파일 보관 네트워크 +.IP \(bu 4 +<https://metacpan.org> +.Sp +메타 CPAN +.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 +GYPARK(Geunyoung Park)의 Perl 관련 한글 문서 저장소 +.SH 라이센스 +.IX Header "라이센스" +\&\fIREADME\fR 파일의 \fB'LICENSING'\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> |