요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0
.. include:: <isonum.txt>
########################################
Linux Media Infrastructure userspace API
########################################
This section contains the driver development information and Kernel APIs
used by media devices.
Please see:
Documentation/admin-guide/media/index.rst
- for usage information about media subsystem and supported drivers;
Documentation/driver-api/media/index.rst
- for driver development information and Kernel APIs used by
media devices;
.. toctree::
:caption: Table of Contents
:maxdepth: 1
intro
v4l/v4l2
dvb/dvbapi
rc/remote_controllers
mediactl/media-controller
cec/cec-api
gen-errors
glossary
fdl-appendix
drivers/index
**Copyright** |copy| 2009-2020 : LinuxTV Developers
::
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1 or
any later version published by the Free Software Foundation, with no
Invariant Sections. A copy of the license is included in the chapter
entitled "GNU Free Documentation License".
Please notice that some documents inside the media userspace API,
when explicitly mentioned on its source code, are dual-licensed
with GNU Free Documentation License Version 1.1 and with the
GNU General Public License::
This documentation is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option) any
later version.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
more details.
For more details see the file COPYING in the source distribution of Linux.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
문서 범위와 관련 안내서
1-23이 절은 media device에서 사용하는 driver 개발 정보와 Kernel API를 담습니다.
Media subsystem의 사용법과 지원 driver 정보는 `Documentation/admin-guide/media/index.rst`를 봅니다.
Media device driver 개발 정보와 Kernel API는 `Documentation/driver-api/media/index.rst`를 봅니다.
사용 목적에 따라 연결되는 두 문서 경로입니다.
.. SPDX-License-Identifier: GPL-2.0
.. include:: <isonum.txt>
########################################
Linux Media Infrastructure userspace API
########################################
This section contains the driver development information and Kernel APIs
used by media devices.
Please see:
Documentation/admin-guide/media/index.rst
- for usage information about media subsystem and supported drivers;
Documentation/driver-api/media/index.rst
- for driver development information and Kernel APIs used by
media devices;
목차 구성
24-41목차는 `intro`, V4L2, Digital TV, remote controller, Media Controller, CEC, 공통 오류, 용어집, GNU FDL 부록, driver별 문서를 최대 깊이 1로 연결합니다.
Sphinx `toctree` 항목의 경로는 `v4l/v4l2`, `dvb/dvbapi`, `rc/remote_controllers`, `mediactl/media-controller`, `cec/cec-api`, `gen-errors`, `glossary`, `fdl-appendix`, `drivers/index`입니다.
.. toctree::
:caption: Table of Contents
:maxdepth: 1
intro
v4l/v4l2
dvb/dvbapi
rc/remote_controllers
mediactl/media-controller
cec/cec-api
gen-errors
glossary
fdl-appendix
drivers/index
저작권과 배포 조건
42-67Copyright © 2009-2020 LinuxTV Developers.
GNU Free Documentation License Version 1.1 또는 Free Software Foundation이 공개한 이후 version의 조건에 따라 이 문서를 복제, 배포 및 수정할 수 있습니다. Invariant Section은 없습니다. License 사본은 `GNU Free Documentation License` 장에 포함되어 있습니다.
Media userspace API 안의 일부 문서는 source code에 명시된 경우 GNU Free Documentation License Version 1.1과 GNU General Public License의 dual license로 제공됩니다.
GPL 조건에서는 Free Software Foundation이 공개한 GNU General Public License Version 2 또는 선택에 따라 이후 version의 조건으로 이 문서를 재배포하거나 수정할 수 있습니다. 이 문서는 유용하기를 바라며 배포하지만 어떠한 warranty도 제공하지 않으며, merchantability 또는 특정 목적에 대한 fitness의 묵시적 warranty조차 없습니다. 자세한 내용은 GNU General Public License와 Linux source distribution의 `COPYING` file을 봅니다.
**Copyright** |copy| 2009-2020 : LinuxTV Developers
::
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1 or
any later version published by the Free Software Foundation, with no
Invariant Sections. A copy of the license is included in the chapter
entitled "GNU Free Documentation License".
Please notice that some documents inside the media userspace API,
when explicitly mentioned on its source code, are dual-licensed
with GNU Free Documentation License Version 1.1 and with the
GNU General Public License::
This documentation is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option) any
later version.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
more details.
For more details see the file COPYING in the source distribution of Linux.
요약·해설
index.rst:1-67사용 안내, driver 개발 문서와 userspace API 색인의 역할을 분리해 안내합니다. 문서별 source notice에 따라 GNU FDL과 GPL dual license가 적용될 수 있습니다.