* [PATCH RFC 0/2] Move media uAPI and kAPI docs to a better place
@ 2020-03-04 10:51 Mauro Carvalho Chehab
2020-03-04 10:51 ` [PATCH RFC 2/2] docs: media kAPI docs: move them to driver-api Mauro Carvalho Chehab
2020-03-06 22:48 ` [PATCH RFC 0/2] Move media uAPI and kAPI docs to a better place Jonathan Corbet
0 siblings, 2 replies; 4+ messages in thread
From: Mauro Carvalho Chehab @ 2020-03-04 10:51 UTC (permalink / raw)
To: Linux Doc Mailing List, Jonathan Corbet
Cc: Mauro Carvalho Chehab, linux-kernel, linux-media
Hi Jon,
This is something that you always wanted: move uAPI and kAPI to
separate books.
This RFC series start doing it for the media docs.
For now, this is just a RFC, being only an initial step for it. I'm sending
it on this early stage just to rise some discussions.
This changeset basically moves:
- the media kAPI files to be under driver-api/media;
- the media uAPI files to be under userspace-api/media.
This version keeps including both inside Documentation/media/index.rst.
It also keeps the driver-specific stuff inside Documentation/media.
In other words, after this series, we'll have:
Documentation/media/index.rst
- An index that points to all media docs;
Documentation/userspace-api/media/index.rst
- Media uAPI;
Documentation/driver-api/media/index.rst
- Media kAPI;
Documentation/media/{cec-drivers,dvb-drivers,v4l-drivers}/index.rst
- Driver-specific information
The driver-specific information is messy, as each file there may contain
either one or more of the following items:
- driver-development information;
- on a few drivers, drivers-specific uAPI.
- modprobe parameters;
- List of devices supported by each driver;
The last two are probably contents for the admin-guide, but not sure
where to place driver-specific development information. Does it
belong to "driver-api" book too?
I guess that driver-specific uAPI could fit at the userspace-api, but I
don't want them to be at the same place as the core media API stuff.
Suggestions?
With regards to the main index, IMHO, for the ones that will be working
with media development, the best would be to have just one book with
everything related to media altogether, e. g. keep everything included
at
Documentation/media/index.rst
On the other hand, I guess I understand the rationale behind having
the uAPI docs included at Documentation/userspace-api/index.rst.
So, there's actually a dilemma here...
I see a few ways to solve it:
1) keep them included at Documentation/media/index.rst;
2) move them to Documentation/{userspace,driver}-api/index.rst
3) place them on both;
4) place them on one of the places, and add a :doc: reference to the
other location.
I suspect that (4) would fit better, but then we need to decide where
the file will be included - either (1) or (2).
Comments?
Regards,
Mauro
-
Mauro Carvalho Chehab (2):
docs: media: move uAPI book to userspace-api/media
docs: media kAPI docs: move them to driver-api
Documentation/ABI/testing/debugfs-cec-error-inj | 2 +-
Documentation/Makefile | 10 +++++-----
.../{media/kapi => driver-api/media}/cec-core.rst | 0
.../{media/kapi => driver-api/media}/csi2.rst | 0
.../{media/kapi => driver-api/media}/dtv-ca.rst | 0
.../kapi => driver-api/media}/dtv-common.rst | 0
.../{media/kapi => driver-api/media}/dtv-core.rst | 0
.../{media/kapi => driver-api/media}/dtv-demux.rst | 0
.../kapi => driver-api/media}/dtv-frontend.rst | 0
.../{media/kapi => driver-api/media}/dtv-net.rst | 0
.../media_kapi.rst => driver-api/media/index.rst} | 12 ++++++------
.../{media/kapi => driver-api/media}/mc-core.rst | 0
.../{media/kapi => driver-api/media}/rc-core.rst | 0
.../kapi => driver-api/media}/v4l2-async.rst | 0
.../kapi => driver-api/media}/v4l2-clocks.rst | 0
.../kapi => driver-api/media}/v4l2-common.rst | 0
.../kapi => driver-api/media}/v4l2-controls.rst | 0
.../{media/kapi => driver-api/media}/v4l2-core.rst | 0
.../{media/kapi => driver-api/media}/v4l2-dev.rst | 0
.../kapi => driver-api/media}/v4l2-device.rst | 0
.../kapi => driver-api/media}/v4l2-dv-timings.rst | 0
.../kapi => driver-api/media}/v4l2-event.rst | 0
.../{media/kapi => driver-api/media}/v4l2-fh.rst | 0
.../media}/v4l2-flash-led-class.rst | 0
.../kapi => driver-api/media}/v4l2-fwnode.rst | 0
.../kapi => driver-api/media}/v4l2-intro.rst | 0
.../{media/kapi => driver-api/media}/v4l2-mc.rst | 0
.../kapi => driver-api/media}/v4l2-mediabus.rst | 0
.../kapi => driver-api/media}/v4l2-mem2mem.rst | 0
.../{media/kapi => driver-api/media}/v4l2-rect.rst | 0
.../kapi => driver-api/media}/v4l2-subdev.rst | 0
.../kapi => driver-api/media}/v4l2-tuner.rst | 0
.../kapi => driver-api/media}/v4l2-tveeprom.rst | 0
.../kapi => driver-api/media}/v4l2-videobuf.rst | 0
.../kapi => driver-api/media}/v4l2-videobuf2.rst | 0
Documentation/fb/api.rst | 4 ++--
Documentation/media/index.rst | 4 ++--
Documentation/media/v4l-drivers/max2175.rst | 2 +-
.../zh_CN/video4linux/v4l2-framework.txt | 2 +-
Documentation/{ => userspace-api}/media/Makefile | 2 +-
.../media/audio.h.rst.exceptions | 0
.../{ => userspace-api}/media/ca.h.rst.exceptions | 0
.../{ => userspace-api}/media/cec.h.rst.exceptions | 0
.../uapi => userspace-api/media}/cec/cec-api.rst | 2 +-
.../media}/cec/cec-func-close.rst | 2 +-
.../media}/cec/cec-func-ioctl.rst | 2 +-
.../media}/cec/cec-func-open.rst | 2 +-
.../media}/cec/cec-func-poll.rst | 2 +-
.../uapi => userspace-api/media}/cec/cec-funcs.rst | 2 +-
.../media}/cec/cec-header.rst | 2 +-
.../uapi => userspace-api/media}/cec/cec-intro.rst | 2 +-
.../media}/cec/cec-ioc-adap-g-caps.rst | 2 +-
.../media}/cec/cec-ioc-adap-g-conn-info.rst | 0
.../media}/cec/cec-ioc-adap-g-log-addrs.rst | 2 +-
.../media}/cec/cec-ioc-adap-g-phys-addr.rst | 2 +-
.../media}/cec/cec-ioc-dqevent.rst | 2 +-
.../media}/cec/cec-ioc-g-mode.rst | 2 +-
.../media}/cec/cec-ioc-receive.rst | 2 +-
.../media}/cec/cec-pin-error-inj.rst | 2 +-
.../{ => userspace-api}/media/conf_nitpick.py | 0
.../{ => userspace-api}/media/dmx.h.rst.exceptions | 0
.../media}/dvb/audio-bilingual-channel-select.rst | 2 +-
.../media}/dvb/audio-channel-select.rst | 2 +-
.../media}/dvb/audio-clear-buffer.rst | 2 +-
.../media}/dvb/audio-continue.rst | 2 +-
.../media}/dvb/audio-fclose.rst | 2 +-
.../media}/dvb/audio-fopen.rst | 2 +-
.../media}/dvb/audio-fwrite.rst | 2 +-
.../media}/dvb/audio-get-capabilities.rst | 2 +-
.../media}/dvb/audio-get-status.rst | 2 +-
.../media}/dvb/audio-pause.rst | 2 +-
.../media}/dvb/audio-play.rst | 2 +-
.../media}/dvb/audio-select-source.rst | 2 +-
.../media}/dvb/audio-set-av-sync.rst | 2 +-
.../media}/dvb/audio-set-bypass-mode.rst | 2 +-
.../media}/dvb/audio-set-id.rst | 2 +-
.../media}/dvb/audio-set-mixer.rst | 2 +-
.../media}/dvb/audio-set-mute.rst | 2 +-
.../media}/dvb/audio-set-streamtype.rst | 2 +-
.../media}/dvb/audio-stop.rst | 2 +-
.../uapi => userspace-api/media}/dvb/audio.rst | 2 +-
.../media}/dvb/audio_data_types.rst | 2 +-
.../media}/dvb/audio_function_calls.rst | 2 +-
.../uapi => userspace-api/media}/dvb/ca-fclose.rst | 2 +-
.../uapi => userspace-api/media}/dvb/ca-fopen.rst | 2 +-
.../media}/dvb/ca-get-cap.rst | 2 +-
.../media}/dvb/ca-get-descr-info.rst | 2 +-
.../media}/dvb/ca-get-msg.rst | 2 +-
.../media}/dvb/ca-get-slot-info.rst | 2 +-
.../uapi => userspace-api/media}/dvb/ca-reset.rst | 2 +-
.../media}/dvb/ca-send-msg.rst | 2 +-
.../media}/dvb/ca-set-descr.rst | 2 +-
.../{media/uapi => userspace-api/media}/dvb/ca.rst | 2 +-
.../media}/dvb/ca_data_types.rst | 2 +-
.../media}/dvb/ca_function_calls.rst | 2 +-
.../uapi => userspace-api/media}/dvb/demux.rst | 2 +-
.../media}/dvb/dmx-add-pid.rst | 2 +-
.../media}/dvb/dmx-expbuf.rst | 2 +-
.../media}/dvb/dmx-fclose.rst | 2 +-
.../uapi => userspace-api/media}/dvb/dmx-fopen.rst | 2 +-
.../uapi => userspace-api/media}/dvb/dmx-fread.rst | 2 +-
.../media}/dvb/dmx-fwrite.rst | 2 +-
.../media}/dvb/dmx-get-pes-pids.rst | 2 +-
.../media}/dvb/dmx-get-stc.rst | 2 +-
.../uapi => userspace-api/media}/dvb/dmx-mmap.rst | 2 +-
.../media}/dvb/dmx-munmap.rst | 2 +-
.../uapi => userspace-api/media}/dvb/dmx-qbuf.rst | 2 +-
.../media}/dvb/dmx-querybuf.rst | 2 +-
.../media}/dvb/dmx-remove-pid.rst | 2 +-
.../media}/dvb/dmx-reqbufs.rst | 2 +-
.../media}/dvb/dmx-set-buffer-size.rst | 2 +-
.../media}/dvb/dmx-set-filter.rst | 2 +-
.../media}/dvb/dmx-set-pes-filter.rst | 2 +-
.../uapi => userspace-api/media}/dvb/dmx-start.rst | 2 +-
.../uapi => userspace-api/media}/dvb/dmx-stop.rst | 2 +-
.../media}/dvb/dmx_fcalls.rst | 2 +-
.../uapi => userspace-api/media}/dvb/dmx_types.rst | 2 +-
.../media}/dvb/dvb-fe-read-status.rst | 2 +-
.../media}/dvb/dvb-frontend-event.rst | 2 +-
.../media}/dvb/dvb-frontend-parameters.rst | 2 +-
.../uapi => userspace-api/media}/dvb/dvbapi.rst | 2 +-
.../media}/dvb/dvbproperty.rst | 2 +-
.../uapi => userspace-api/media}/dvb/dvbstb.svg | 2 +-
.../uapi => userspace-api/media}/dvb/examples.rst | 2 +-
.../media}/dvb/fe-bandwidth-t.rst | 2 +-
.../media}/dvb/fe-diseqc-recv-slave-reply.rst | 2 +-
.../media}/dvb/fe-diseqc-reset-overload.rst | 2 +-
.../media}/dvb/fe-diseqc-send-burst.rst | 2 +-
.../media}/dvb/fe-diseqc-send-master-cmd.rst | 2 +-
.../media}/dvb/fe-dishnetwork-send-legacy-cmd.rst | 2 +-
.../media}/dvb/fe-enable-high-lnb-voltage.rst | 2 +-
.../media}/dvb/fe-get-event.rst | 2 +-
.../media}/dvb/fe-get-frontend.rst | 2 +-
.../media}/dvb/fe-get-info.rst | 2 +-
.../media}/dvb/fe-get-property.rst | 2 +-
.../media}/dvb/fe-read-ber.rst | 2 +-
.../media}/dvb/fe-read-signal-strength.rst | 2 +-
.../media}/dvb/fe-read-snr.rst | 2 +-
.../media}/dvb/fe-read-status.rst | 2 +-
.../media}/dvb/fe-read-uncorrected-blocks.rst | 2 +-
.../media}/dvb/fe-set-frontend-tune-mode.rst | 2 +-
.../media}/dvb/fe-set-frontend.rst | 2 +-
.../media}/dvb/fe-set-tone.rst | 2 +-
.../media}/dvb/fe-set-voltage.rst | 2 +-
.../uapi => userspace-api/media}/dvb/fe-type-t.rst | 2 +-
.../media}/dvb/fe_property_parameters.rst | 2 +-
.../media}/dvb/frontend-header.rst | 2 +-
.../media}/dvb/frontend-property-cable-systems.rst | 2 +-
.../dvb/frontend-property-satellite-systems.rst | 2 +-
.../dvb/frontend-property-terrestrial-systems.rst | 2 +-
.../media}/dvb/frontend-stat-properties.rst | 2 +-
.../uapi => userspace-api/media}/dvb/frontend.rst | 2 +-
.../media}/dvb/frontend_f_close.rst | 2 +-
.../media}/dvb/frontend_f_open.rst | 2 +-
.../media}/dvb/frontend_fcalls.rst | 2 +-
.../media}/dvb/frontend_legacy_api.rst | 2 +-
.../media}/dvb/frontend_legacy_dvbv3_api.rst | 2 +-
.../uapi => userspace-api/media}/dvb/headers.rst | 2 +-
.../uapi => userspace-api/media}/dvb/intro.rst | 2 +-
.../media}/dvb/legacy_dvb_apis.rst | 2 +-
.../media}/dvb/net-add-if.rst | 2 +-
.../media}/dvb/net-get-if.rst | 2 +-
.../media}/dvb/net-remove-if.rst | 2 +-
.../uapi => userspace-api/media}/dvb/net-types.rst | 2 +-
.../uapi => userspace-api/media}/dvb/net.rst | 2 +-
.../media}/dvb/query-dvb-frontend-info.rst | 2 +-
.../media}/dvb/video-clear-buffer.rst | 2 +-
.../media}/dvb/video-command.rst | 2 +-
.../media}/dvb/video-continue.rst | 2 +-
.../media}/dvb/video-fast-forward.rst | 2 +-
.../media}/dvb/video-fclose.rst | 2 +-
.../media}/dvb/video-fopen.rst | 2 +-
.../media}/dvb/video-freeze.rst | 2 +-
.../media}/dvb/video-fwrite.rst | 2 +-
.../media}/dvb/video-get-capabilities.rst | 2 +-
.../media}/dvb/video-get-event.rst | 2 +-
.../media}/dvb/video-get-frame-count.rst | 2 +-
.../media}/dvb/video-get-pts.rst | 2 +-
.../media}/dvb/video-get-size.rst | 2 +-
.../media}/dvb/video-get-status.rst | 2 +-
.../media}/dvb/video-play.rst | 2 +-
.../media}/dvb/video-select-source.rst | 2 +-
.../media}/dvb/video-set-blank.rst | 2 +-
.../media}/dvb/video-set-display-format.rst | 2 +-
.../media}/dvb/video-set-format.rst | 2 +-
.../media}/dvb/video-set-streamtype.rst | 2 +-
.../media}/dvb/video-slowmotion.rst | 2 +-
.../media}/dvb/video-stillpicture.rst | 2 +-
.../media}/dvb/video-stop.rst | 2 +-
.../media}/dvb/video-try-command.rst | 2 +-
.../uapi => userspace-api/media}/dvb/video.rst | 2 +-
.../media}/dvb/video_function_calls.rst | 2 +-
.../media}/dvb/video_types.rst | 2 +-
.../uapi => userspace-api/media}/fdl-appendix.rst | 2 +-
.../media/frontend.h.rst.exceptions | 0
.../uapi => userspace-api/media}/gen-errors.rst | 2 +-
.../media/index.rst} | 14 +++++++-------
Documentation/{ => userspace-api}/media/intro.rst | 0
.../media/lirc.h.rst.exceptions | 0
.../media/media.h.rst.exceptions | 0
.../media}/mediactl/media-controller-intro.rst | 2 +-
.../media}/mediactl/media-controller-model.rst | 2 +-
.../media}/mediactl/media-controller.rst | 2 +-
.../media}/mediactl/media-func-close.rst | 2 +-
.../media}/mediactl/media-func-ioctl.rst | 2 +-
.../media}/mediactl/media-func-open.rst | 2 +-
.../media}/mediactl/media-funcs.rst | 2 +-
.../media}/mediactl/media-header.rst | 2 +-
.../media}/mediactl/media-ioc-device-info.rst | 2 +-
.../media}/mediactl/media-ioc-enum-entities.rst | 2 +-
.../media}/mediactl/media-ioc-enum-links.rst | 2 +-
.../media}/mediactl/media-ioc-g-topology.rst | 2 +-
.../media}/mediactl/media-ioc-request-alloc.rst | 2 +-
.../media}/mediactl/media-ioc-setup-link.rst | 2 +-
.../media}/mediactl/media-request-ioc-queue.rst | 2 +-
.../media}/mediactl/media-request-ioc-reinit.rst | 2 +-
.../media}/mediactl/media-types.rst | 2 +-
.../media}/mediactl/request-api.rst | 2 +-
.../media}/mediactl/request-func-close.rst | 2 +-
.../media}/mediactl/request-func-ioctl.rst | 2 +-
.../media}/mediactl/request-func-poll.rst | 2 +-
.../{ => userspace-api}/media/net.h.rst.exceptions | 0
.../uapi => userspace-api/media}/rc/keytable.c.rst | 2 +-
.../media}/rc/lirc-dev-intro.rst | 2 +-
.../uapi => userspace-api/media}/rc/lirc-dev.rst | 2 +-
.../uapi => userspace-api/media}/rc/lirc-func.rst | 2 +-
.../media}/rc/lirc-get-features.rst | 2 +-
.../media}/rc/lirc-get-rec-mode.rst | 2 +-
.../media}/rc/lirc-get-rec-resolution.rst | 2 +-
.../media}/rc/lirc-get-send-mode.rst | 2 +-
.../media}/rc/lirc-get-timeout.rst | 2 +-
.../media}/rc/lirc-header.rst | 2 +-
.../uapi => userspace-api/media}/rc/lirc-read.rst | 2 +-
.../media}/rc/lirc-set-measure-carrier-mode.rst | 2 +-
.../media}/rc/lirc-set-rec-carrier-range.rst | 2 +-
.../media}/rc/lirc-set-rec-carrier.rst | 2 +-
.../media}/rc/lirc-set-rec-timeout-reports.rst | 2 +-
.../media}/rc/lirc-set-rec-timeout.rst | 2 +-
.../media}/rc/lirc-set-send-carrier.rst | 2 +-
.../media}/rc/lirc-set-send-duty-cycle.rst | 2 +-
.../media}/rc/lirc-set-transmitter-mask.rst | 2 +-
.../media}/rc/lirc-set-wideband-receiver.rst | 2 +-
.../uapi => userspace-api/media}/rc/lirc-write.rst | 2 +-
.../uapi => userspace-api/media}/rc/rc-intro.rst | 2 +-
.../uapi => userspace-api/media}/rc/rc-protos.rst | 0
.../media}/rc/rc-sysfs-nodes.rst | 2 +-
.../media}/rc/rc-table-change.rst | 2 +-
.../uapi => userspace-api/media}/rc/rc-tables.rst | 2 +-
.../media}/rc/remote_controllers.rst | 2 +-
.../media/typical_media_device.svg | 2 +-
.../uapi => userspace-api/media}/v4l/app-pri.rst | 2 +-
.../uapi => userspace-api/media}/v4l/async.rst | 2 +-
.../uapi => userspace-api/media}/v4l/audio.rst | 2 +-
.../uapi => userspace-api/media}/v4l/bayer.svg | 2 +-
.../uapi => userspace-api/media}/v4l/biblio.rst | 2 +-
.../uapi => userspace-api/media}/v4l/buffer.rst | 2 +-
.../media}/v4l/capture-example.rst | 2 +-
.../uapi => userspace-api/media}/v4l/capture.c.rst | 2 +-
.../media}/v4l/colorspaces-defs.rst | 2 +-
.../media}/v4l/colorspaces-details.rst | 2 +-
.../media}/v4l/colorspaces.rst | 2 +-
.../media}/v4l/common-defs.rst | 2 +-
.../uapi => userspace-api/media}/v4l/common.rst | 2 +-
.../uapi => userspace-api/media}/v4l/compat.rst | 2 +-
.../media}/v4l/constraints.svg | 2 +-
.../uapi => userspace-api/media}/v4l/control.rst | 2 +-
.../uapi => userspace-api/media}/v4l/crop.rst | 2 +-
.../uapi => userspace-api/media}/v4l/crop.svg | 2 +-
.../media}/v4l/depth-formats.rst | 2 +-
.../media}/v4l/dev-capture.rst | 2 +-
.../media}/v4l/dev-decoder.rst | 0
.../uapi => userspace-api/media}/v4l/dev-event.rst | 2 +-
.../media}/v4l/dev-mem2mem.rst | 2 +-
.../uapi => userspace-api/media}/v4l/dev-meta.rst | 2 +-
.../uapi => userspace-api/media}/v4l/dev-osd.rst | 2 +-
.../media}/v4l/dev-output.rst | 2 +-
.../media}/v4l/dev-overlay.rst | 2 +-
.../uapi => userspace-api/media}/v4l/dev-radio.rst | 2 +-
.../media}/v4l/dev-raw-vbi.rst | 2 +-
.../uapi => userspace-api/media}/v4l/dev-rds.rst | 2 +-
.../uapi => userspace-api/media}/v4l/dev-sdr.rst | 2 +-
.../media}/v4l/dev-sliced-vbi.rst | 2 +-
.../media}/v4l/dev-stateless-decoder.rst | 0
.../media}/v4l/dev-subdev.rst | 2 +-
.../uapi => userspace-api/media}/v4l/dev-touch.rst | 2 +-
.../uapi => userspace-api/media}/v4l/devices.rst | 2 +-
.../uapi => userspace-api/media}/v4l/diff-v4l.rst | 2 +-
.../uapi => userspace-api/media}/v4l/dmabuf.rst | 2 +-
.../media}/v4l/dv-timings.rst | 2 +-
.../media}/v4l/ext-ctrls-camera.rst | 2 +-
.../media}/v4l/ext-ctrls-codec.rst | 2 +-
.../media}/v4l/ext-ctrls-detect.rst | 2 +-
.../media}/v4l/ext-ctrls-dv.rst | 2 +-
.../media}/v4l/ext-ctrls-flash.rst | 2 +-
.../media}/v4l/ext-ctrls-fm-rx.rst | 2 +-
.../media}/v4l/ext-ctrls-fm-tx.rst | 2 +-
.../media}/v4l/ext-ctrls-image-process.rst | 2 +-
.../media}/v4l/ext-ctrls-image-source.rst | 2 +-
.../media}/v4l/ext-ctrls-jpeg.rst | 2 +-
.../media}/v4l/ext-ctrls-rf-tuner.rst | 2 +-
.../media}/v4l/extended-controls.rst | 2 +-
.../media}/v4l/field-order.rst | 2 +-
.../media}/v4l/fieldseq_bt.svg | 2 +-
.../media}/v4l/fieldseq_tb.svg | 2 +-
.../uapi => userspace-api/media}/v4l/format.rst | 2 +-
.../media}/v4l/func-close.rst | 2 +-
.../media}/v4l/func-ioctl.rst | 2 +-
.../uapi => userspace-api/media}/v4l/func-mmap.rst | 2 +-
.../media}/v4l/func-munmap.rst | 2 +-
.../uapi => userspace-api/media}/v4l/func-open.rst | 2 +-
.../uapi => userspace-api/media}/v4l/func-poll.rst | 2 +-
.../uapi => userspace-api/media}/v4l/func-read.rst | 2 +-
.../media}/v4l/func-select.rst | 2 +-
.../media}/v4l/func-write.rst | 2 +-
.../uapi => userspace-api/media}/v4l/hist-v4l2.rst | 2 +-
.../media}/v4l/hsv-formats.rst | 2 +-
.../{media/uapi => userspace-api/media}/v4l/io.rst | 2 +-
.../media}/v4l/libv4l-introduction.rst | 2 +-
.../uapi => userspace-api/media}/v4l/libv4l.rst | 2 +-
.../media}/v4l/meta-formats.rst | 2 +-
.../uapi => userspace-api/media}/v4l/mmap.rst | 2 +-
.../uapi => userspace-api/media}/v4l/nv12mt.svg | 2 +-
.../media}/v4l/nv12mt_example.svg | 2 +-
.../uapi => userspace-api/media}/v4l/open.rst | 2 +-
.../uapi => userspace-api/media}/v4l/pipeline.dot | 0
.../media}/v4l/pixfmt-bayer.rst | 2 +-
.../media}/v4l/pixfmt-cnf4.rst | 0
.../media}/v4l/pixfmt-compressed.rst | 2 +-
.../media}/v4l/pixfmt-grey.rst | 2 +-
.../media}/v4l/pixfmt-indexed.rst | 2 +-
.../media}/v4l/pixfmt-intro.rst | 2 +-
.../media}/v4l/pixfmt-inzi.rst | 2 +-
.../media}/v4l/pixfmt-m420.rst | 2 +-
.../media}/v4l/pixfmt-meta-d4xx.rst | 2 +-
.../media}/v4l/pixfmt-meta-intel-ipu3.rst | 2 +-
.../media}/v4l/pixfmt-meta-uvc.rst | 2 +-
.../media}/v4l/pixfmt-meta-vivid.rst | 2 +-
.../media}/v4l/pixfmt-meta-vsp1-hgo.rst | 2 +-
.../media}/v4l/pixfmt-meta-vsp1-hgt.rst | 2 +-
.../media}/v4l/pixfmt-nv12.rst | 2 +-
.../media}/v4l/pixfmt-nv12m.rst | 2 +-
.../media}/v4l/pixfmt-nv12mt.rst | 2 +-
.../media}/v4l/pixfmt-nv16.rst | 2 +-
.../media}/v4l/pixfmt-nv16m.rst | 2 +-
.../media}/v4l/pixfmt-nv24.rst | 2 +-
.../media}/v4l/pixfmt-packed-hsv.rst | 2 +-
.../media}/v4l/pixfmt-packed-yuv.rst | 2 +-
.../media}/v4l/pixfmt-reserved.rst | 2 +-
.../media}/v4l/pixfmt-rgb.rst | 2 +-
.../media}/v4l/pixfmt-sdr-cs08.rst | 2 +-
.../media}/v4l/pixfmt-sdr-cs14le.rst | 2 +-
.../media}/v4l/pixfmt-sdr-cu08.rst | 2 +-
.../media}/v4l/pixfmt-sdr-cu16le.rst | 2 +-
.../media}/v4l/pixfmt-sdr-pcu16be.rst | 2 +-
.../media}/v4l/pixfmt-sdr-pcu18be.rst | 2 +-
.../media}/v4l/pixfmt-sdr-pcu20be.rst | 2 +-
.../media}/v4l/pixfmt-sdr-ru12le.rst | 2 +-
.../media}/v4l/pixfmt-srggb10-ipu3.rst | 2 +-
.../media}/v4l/pixfmt-srggb10.rst | 2 +-
.../media}/v4l/pixfmt-srggb10alaw8.rst | 2 +-
.../media}/v4l/pixfmt-srggb10dpcm8.rst | 2 +-
.../media}/v4l/pixfmt-srggb10p.rst | 2 +-
.../media}/v4l/pixfmt-srggb12.rst | 2 +-
.../media}/v4l/pixfmt-srggb12p.rst | 2 +-
.../media}/v4l/pixfmt-srggb14p.rst | 2 +-
.../media}/v4l/pixfmt-srggb16.rst | 2 +-
.../media}/v4l/pixfmt-srggb8.rst | 2 +-
.../media}/v4l/pixfmt-tch-td08.rst | 2 +-
.../media}/v4l/pixfmt-tch-td16.rst | 2 +-
.../media}/v4l/pixfmt-tch-tu08.rst | 2 +-
.../media}/v4l/pixfmt-tch-tu16.rst | 2 +-
.../media}/v4l/pixfmt-uv8.rst | 2 +-
.../media}/v4l/pixfmt-uyvy.rst | 2 +-
.../media}/v4l/pixfmt-v4l2-mplane.rst | 2 +-
.../media}/v4l/pixfmt-v4l2.rst | 2 +-
.../media}/v4l/pixfmt-vyuy.rst | 2 +-
.../media}/v4l/pixfmt-y10.rst | 2 +-
.../media}/v4l/pixfmt-y10b.rst | 2 +-
.../media}/v4l/pixfmt-y10p.rst | 2 +-
.../media}/v4l/pixfmt-y12.rst | 2 +-
.../media}/v4l/pixfmt-y12i.rst | 2 +-
.../media}/v4l/pixfmt-y16-be.rst | 2 +-
.../media}/v4l/pixfmt-y16.rst | 2 +-
.../media}/v4l/pixfmt-y41p.rst | 2 +-
.../media}/v4l/pixfmt-y8i.rst | 2 +-
.../media}/v4l/pixfmt-yuv410.rst | 2 +-
.../media}/v4l/pixfmt-yuv411p.rst | 2 +-
.../media}/v4l/pixfmt-yuv420.rst | 2 +-
.../media}/v4l/pixfmt-yuv420m.rst | 2 +-
.../media}/v4l/pixfmt-yuv422m.rst | 2 +-
.../media}/v4l/pixfmt-yuv422p.rst | 2 +-
.../media}/v4l/pixfmt-yuv444m.rst | 2 +-
.../media}/v4l/pixfmt-yuyv.rst | 2 +-
.../media}/v4l/pixfmt-yvyu.rst | 2 +-
.../media}/v4l/pixfmt-z16.rst | 2 +-
.../uapi => userspace-api/media}/v4l/pixfmt.rst | 2 +-
.../media}/v4l/planar-apis.rst | 2 +-
.../uapi => userspace-api/media}/v4l/querycap.rst | 2 +-
.../{media/uapi => userspace-api/media}/v4l/rw.rst | 2 +-
.../media}/v4l/sdr-formats.rst | 2 +-
.../media}/v4l/selection-api-configuration.rst | 2 +-
.../media}/v4l/selection-api-examples.rst | 2 +-
.../media}/v4l/selection-api-intro.rst | 2 +-
.../media}/v4l/selection-api-targets.rst | 2 +-
.../media}/v4l/selection-api-vs-crop-api.rst | 2 +-
.../media}/v4l/selection-api.rst | 2 +-
.../uapi => userspace-api/media}/v4l/selection.svg | 2 +-
.../media}/v4l/selections-common.rst | 2 +-
.../uapi => userspace-api/media}/v4l/standard.rst | 2 +-
.../media}/v4l/streaming-par.rst | 2 +-
.../media}/v4l/subdev-formats.rst | 2 +-
.../media}/v4l/subdev-image-processing-crop.svg | 2 +-
.../media}/v4l/subdev-image-processing-full.svg | 2 +-
...ubdev-image-processing-scaling-multi-source.svg | 2 +-
.../media}/v4l/tch-formats.rst | 2 +-
.../uapi => userspace-api/media}/v4l/tuner.rst | 2 +-
.../uapi => userspace-api/media}/v4l/user-func.rst | 2 +-
.../uapi => userspace-api/media}/v4l/userp.rst | 2 +-
.../media}/v4l/v4l2-selection-flags.rst | 2 +-
.../media}/v4l/v4l2-selection-targets.rst | 2 +-
.../uapi => userspace-api/media}/v4l/v4l2.rst | 2 +-
.../media}/v4l/v4l2grab-example.rst | 2 +-
.../media}/v4l/v4l2grab.c.rst | 2 +-
.../uapi => userspace-api/media}/v4l/vbi_525.svg | 2 +-
.../uapi => userspace-api/media}/v4l/vbi_625.svg | 2 +-
.../uapi => userspace-api/media}/v4l/vbi_hsync.svg | 2 +-
.../uapi => userspace-api/media}/v4l/video.rst | 2 +-
.../uapi => userspace-api/media}/v4l/videodev.rst | 2 +-
.../media}/v4l/vidioc-create-bufs.rst | 2 +-
.../media}/v4l/vidioc-cropcap.rst | 2 +-
.../media}/v4l/vidioc-dbg-g-chip-info.rst | 2 +-
.../media}/v4l/vidioc-dbg-g-register.rst | 2 +-
.../media}/v4l/vidioc-decoder-cmd.rst | 2 +-
.../media}/v4l/vidioc-dqevent.rst | 2 +-
.../media}/v4l/vidioc-dv-timings-cap.rst | 2 +-
.../media}/v4l/vidioc-encoder-cmd.rst | 2 +-
.../media}/v4l/vidioc-enum-dv-timings.rst | 2 +-
.../media}/v4l/vidioc-enum-fmt.rst | 2 +-
.../media}/v4l/vidioc-enum-frameintervals.rst | 2 +-
.../media}/v4l/vidioc-enum-framesizes.rst | 2 +-
.../media}/v4l/vidioc-enum-freq-bands.rst | 2 +-
.../media}/v4l/vidioc-enumaudio.rst | 2 +-
.../media}/v4l/vidioc-enumaudioout.rst | 2 +-
.../media}/v4l/vidioc-enuminput.rst | 2 +-
.../media}/v4l/vidioc-enumoutput.rst | 2 +-
.../media}/v4l/vidioc-enumstd.rst | 2 +-
.../media}/v4l/vidioc-expbuf.rst | 2 +-
.../media}/v4l/vidioc-g-audio.rst | 2 +-
.../media}/v4l/vidioc-g-audioout.rst | 2 +-
.../media}/v4l/vidioc-g-crop.rst | 2 +-
.../media}/v4l/vidioc-g-ctrl.rst | 2 +-
.../media}/v4l/vidioc-g-dv-timings.rst | 2 +-
.../media}/v4l/vidioc-g-edid.rst | 2 +-
.../media}/v4l/vidioc-g-enc-index.rst | 2 +-
.../media}/v4l/vidioc-g-ext-ctrls.rst | 2 +-
.../media}/v4l/vidioc-g-fbuf.rst | 2 +-
.../media}/v4l/vidioc-g-fmt.rst | 2 +-
.../media}/v4l/vidioc-g-frequency.rst | 2 +-
.../media}/v4l/vidioc-g-input.rst | 2 +-
.../media}/v4l/vidioc-g-jpegcomp.rst | 2 +-
.../media}/v4l/vidioc-g-modulator.rst | 2 +-
.../media}/v4l/vidioc-g-output.rst | 2 +-
.../media}/v4l/vidioc-g-parm.rst | 2 +-
.../media}/v4l/vidioc-g-priority.rst | 2 +-
.../media}/v4l/vidioc-g-selection.rst | 2 +-
.../media}/v4l/vidioc-g-sliced-vbi-cap.rst | 2 +-
.../media}/v4l/vidioc-g-std.rst | 2 +-
.../media}/v4l/vidioc-g-tuner.rst | 2 +-
.../media}/v4l/vidioc-log-status.rst | 2 +-
.../media}/v4l/vidioc-overlay.rst | 2 +-
.../media}/v4l/vidioc-prepare-buf.rst | 2 +-
.../media}/v4l/vidioc-qbuf.rst | 2 +-
.../media}/v4l/vidioc-query-dv-timings.rst | 2 +-
.../media}/v4l/vidioc-querybuf.rst | 2 +-
.../media}/v4l/vidioc-querycap.rst | 2 +-
.../media}/v4l/vidioc-queryctrl.rst | 2 +-
.../media}/v4l/vidioc-querystd.rst | 2 +-
.../media}/v4l/vidioc-reqbufs.rst | 2 +-
.../media}/v4l/vidioc-s-hw-freq-seek.rst | 2 +-
.../media}/v4l/vidioc-streamon.rst | 2 +-
.../v4l/vidioc-subdev-enum-frame-interval.rst | 2 +-
.../media}/v4l/vidioc-subdev-enum-frame-size.rst | 2 +-
.../media}/v4l/vidioc-subdev-enum-mbus-code.rst | 2 +-
.../media}/v4l/vidioc-subdev-g-crop.rst | 2 +-
.../media}/v4l/vidioc-subdev-g-fmt.rst | 2 +-
.../media}/v4l/vidioc-subdev-g-frame-interval.rst | 2 +-
.../media}/v4l/vidioc-subdev-g-selection.rst | 2 +-
.../media}/v4l/vidioc-subscribe-event.rst | 2 +-
.../media}/v4l/yuv-formats.rst | 2 +-
.../media/video.h.rst.exceptions | 0
.../media/videodev2.h.rst.exceptions | 0
MAINTAINERS | 12 ++++++++----
492 files changed, 466 insertions(+), 462 deletions(-)
rename Documentation/{media/kapi => driver-api/media}/cec-core.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/csi2.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/dtv-ca.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/dtv-common.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/dtv-core.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/dtv-demux.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/dtv-frontend.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/dtv-net.rst (100%)
rename Documentation/{media/media_kapi.rst => driver-api/media/index.rst} (89%)
rename Documentation/{media/kapi => driver-api/media}/mc-core.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/rc-core.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-async.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-clocks.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-common.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-controls.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-core.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-dev.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-device.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-dv-timings.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-event.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-fh.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-flash-led-class.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-fwnode.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-intro.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-mc.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-mediabus.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-mem2mem.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-rect.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-subdev.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-tuner.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-tveeprom.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-videobuf.rst (100%)
rename Documentation/{media/kapi => driver-api/media}/v4l2-videobuf2.rst (100%)
rename Documentation/{ => userspace-api}/media/Makefile (97%)
rename Documentation/{ => userspace-api}/media/audio.h.rst.exceptions (100%)
rename Documentation/{ => userspace-api}/media/ca.h.rst.exceptions (100%)
rename Documentation/{ => userspace-api}/media/cec.h.rst.exceptions (100%)
rename Documentation/{media/uapi => userspace-api/media}/cec/cec-api.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/cec/cec-func-close.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/cec/cec-func-ioctl.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/cec/cec-func-open.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/cec/cec-func-poll.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/cec/cec-funcs.rst (93%)
rename Documentation/{media/uapi => userspace-api/media}/cec/cec-header.rst (90%)
rename Documentation/{media/uapi => userspace-api/media}/cec/cec-intro.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/cec/cec-ioc-adap-g-caps.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/cec/cec-ioc-adap-g-conn-info.rst (100%)
rename Documentation/{media/uapi => userspace-api/media}/cec/cec-ioc-adap-g-log-addrs.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/cec/cec-ioc-adap-g-phys-addr.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/cec/cec-ioc-dqevent.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/cec/cec-ioc-g-mode.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/cec/cec-ioc-receive.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/cec/cec-pin-error-inj.rst (99%)
rename Documentation/{ => userspace-api}/media/conf_nitpick.py (100%)
rename Documentation/{ => userspace-api}/media/dmx.h.rst.exceptions (100%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-bilingual-channel-select.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-channel-select.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-clear-buffer.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-continue.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-fclose.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-fopen.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-fwrite.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-get-capabilities.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-get-status.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-pause.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-play.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-select-source.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-set-av-sync.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-set-bypass-mode.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-set-id.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-set-mixer.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-set-mute.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-set-streamtype.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio-stop.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio_data_types.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/audio_function_calls.rst (94%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/ca-fclose.rst (94%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/ca-fopen.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/ca-get-cap.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/ca-get-descr-info.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/ca-get-msg.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/ca-get-slot-info.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/ca-reset.rst (94%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/ca-send-msg.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/ca-set-descr.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/ca.rst (94%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/ca_data_types.rst (90%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/ca_function_calls.rst (92%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/demux.rst (94%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-add-pid.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-expbuf.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-fclose.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-fopen.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-fread.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-fwrite.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-get-pes-pids.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-get-stc.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-mmap.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-munmap.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-qbuf.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-querybuf.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-remove-pid.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-reqbufs.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-set-buffer-size.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-set-filter.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-set-pes-filter.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-start.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx-stop.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx_fcalls.rst (93%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dmx_types.rst (90%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dvb-fe-read-status.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dvb-frontend-event.rst (91%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dvb-frontend-parameters.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dvbapi.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dvbproperty.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/dvbstb.svg (99%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/examples.rst (93%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-bandwidth-t.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-diseqc-recv-slave-reply.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-diseqc-reset-overload.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-diseqc-send-burst.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-diseqc-send-master-cmd.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-dishnetwork-send-legacy-cmd.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-enable-high-lnb-voltage.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-get-event.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-get-frontend.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-get-info.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-get-property.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-read-ber.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-read-signal-strength.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-read-snr.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-read-status.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-read-uncorrected-blocks.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-set-frontend-tune-mode.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-set-frontend.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-set-tone.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-set-voltage.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe-type-t.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/fe_property_parameters.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/frontend-header.rst (90%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/frontend-property-cable-systems.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/frontend-property-satellite-systems.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/frontend-property-terrestrial-systems.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/frontend-stat-properties.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/frontend.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/frontend_f_close.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/frontend_f_open.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/frontend_fcalls.rst (93%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/frontend_legacy_api.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/frontend_legacy_dvbv3_api.rst (93%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/headers.rst (93%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/intro.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/legacy_dvb_apis.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/net-add-if.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/net-get-if.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/net-remove-if.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/net-types.rst (90%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/net.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/query-dvb-frontend-info.rst (93%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-clear-buffer.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-command.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-continue.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-fast-forward.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-fclose.rst (94%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-fopen.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-freeze.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-fwrite.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-get-capabilities.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-get-event.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-get-frame-count.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-get-pts.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-get-size.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-get-status.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-play.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-select-source.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-set-blank.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-set-display-format.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-set-format.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-set-streamtype.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-slowmotion.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-stillpicture.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-stop.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video-try-command.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video_function_calls.rst (94%)
rename Documentation/{media/uapi => userspace-api/media}/dvb/video_types.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/fdl-appendix.rst (99%)
rename Documentation/{ => userspace-api}/media/frontend.h.rst.exceptions (100%)
rename Documentation/{media/uapi => userspace-api/media}/gen-errors.rst (98%)
rename Documentation/{media/media_uapi.rst => userspace-api/media/index.rst} (80%)
rename Documentation/{ => userspace-api}/media/intro.rst (100%)
rename Documentation/{ => userspace-api}/media/lirc.h.rst.exceptions (100%)
rename Documentation/{ => userspace-api}/media/media.h.rst.exceptions (100%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-controller-intro.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-controller-model.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-controller.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-func-close.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-func-ioctl.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-func-open.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-funcs.rst (93%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-header.rst (90%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-ioc-device-info.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-ioc-enum-entities.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-ioc-enum-links.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-ioc-g-topology.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-ioc-request-alloc.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-ioc-setup-link.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-request-ioc-queue.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-request-ioc-reinit.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/media-types.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/request-api.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/request-func-close.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/request-func-ioctl.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/mediactl/request-func-poll.rst (98%)
rename Documentation/{ => userspace-api}/media/net.h.rst.exceptions (100%)
rename Documentation/{media/uapi => userspace-api/media}/rc/keytable.c.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-dev-intro.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-dev.rst (90%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-func.rst (94%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-get-features.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-get-rec-mode.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-get-rec-resolution.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-get-send-mode.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-get-timeout.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-header.rst (90%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-read.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-set-measure-carrier-mode.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-set-rec-carrier-range.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-set-rec-carrier.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-set-rec-timeout-reports.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-set-rec-timeout.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-set-send-carrier.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-set-send-duty-cycle.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-set-transmitter-mask.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-set-wideband-receiver.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/rc/lirc-write.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/rc/rc-intro.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/rc/rc-protos.rst (100%)
rename Documentation/{media/uapi => userspace-api/media}/rc/rc-sysfs-nodes.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/rc/rc-table-change.rst (93%)
rename Documentation/{media/uapi => userspace-api/media}/rc/rc-tables.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/rc/remote_controllers.rst (95%)
rename Documentation/{ => userspace-api}/media/typical_media_device.svg (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/app-pri.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/async.rst (90%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/audio.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/bayer.svg (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/biblio.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/buffer.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/capture-example.rst (90%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/capture.c.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/colorspaces-defs.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/colorspaces-details.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/colorspaces.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/common-defs.rst (92%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/common.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/compat.rst (92%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/constraints.svg (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/control.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/crop.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/crop.svg (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/depth-formats.rst (91%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dev-capture.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dev-decoder.rst (100%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dev-event.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dev-mem2mem.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dev-meta.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dev-osd.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dev-output.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dev-overlay.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dev-radio.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dev-raw-vbi.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dev-rds.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dev-sdr.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dev-sliced-vbi.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dev-stateless-decoder.rst (100%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dev-subdev.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dev-touch.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/devices.rst (92%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/diff-v4l.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dmabuf.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/dv-timings.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/ext-ctrls-camera.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/ext-ctrls-codec.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/ext-ctrls-detect.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/ext-ctrls-dv.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/ext-ctrls-flash.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/ext-ctrls-fm-rx.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/ext-ctrls-fm-tx.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/ext-ctrls-image-process.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/ext-ctrls-image-source.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/ext-ctrls-jpeg.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/ext-ctrls-rf-tuner.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/extended-controls.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/field-order.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/fieldseq_bt.svg (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/fieldseq_tb.svg (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/format.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/func-close.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/func-ioctl.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/func-mmap.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/func-munmap.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/func-open.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/func-poll.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/func-read.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/func-select.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/func-write.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/hist-v4l2.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/hsv-formats.rst (93%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/io.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/libv4l-introduction.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/libv4l.rst (90%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/meta-formats.rst (92%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/mmap.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/nv12mt.svg (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/nv12mt_example.svg (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/open.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pipeline.dot (100%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-bayer.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-cnf4.rst (100%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-compressed.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-grey.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-indexed.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-intro.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-inzi.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-m420.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-meta-d4xx.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-meta-intel-ipu3.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-meta-uvc.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-meta-vivid.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-meta-vsp1-hgo.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-meta-vsp1-hgt.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-nv12.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-nv12m.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-nv12mt.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-nv16.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-nv16m.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-nv24.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-packed-hsv.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-packed-yuv.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-reserved.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-rgb.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-sdr-cs08.rst (94%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-sdr-cs14le.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-sdr-cu08.rst (94%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-sdr-cu16le.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-sdr-pcu16be.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-sdr-pcu18be.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-sdr-pcu20be.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-sdr-ru12le.rst (94%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-srggb10-ipu3.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-srggb10.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-srggb10alaw8.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-srggb10dpcm8.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-srggb10p.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-srggb12.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-srggb12p.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-srggb14p.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-srggb16.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-srggb8.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-tch-td08.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-tch-td16.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-tch-tu08.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-tch-tu16.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-uv8.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-uyvy.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-v4l2-mplane.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-v4l2.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-vyuy.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-y10.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-y10b.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-y10p.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-y12.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-y12i.rst (95%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-y16-be.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-y16.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-y41p.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-y8i.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-yuv410.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-yuv411p.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-yuv420.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-yuv420m.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-yuv422m.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-yuv422p.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-yuv444m.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-yuyv.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-yvyu.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt-z16.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/pixfmt.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/planar-apis.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/querycap.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/rw.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/sdr-formats.rst (92%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/selection-api-configuration.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/selection-api-examples.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/selection-api-intro.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/selection-api-targets.rst (92%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/selection-api-vs-crop-api.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/selection-api.rst (92%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/selection.svg (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/selections-common.rst (94%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/standard.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/streaming-par.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/subdev-formats.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/subdev-image-processing-crop.svg (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/subdev-image-processing-full.svg (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/subdev-image-processing-scaling-multi-source.svg (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/tch-formats.rst (91%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/tuner.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/user-func.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/userp.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/v4l2-selection-flags.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/v4l2-selection-targets.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/v4l2.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/v4l2grab-example.rst (93%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/v4l2grab.c.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vbi_525.svg (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vbi_625.svg (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vbi_hsync.svg (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/video.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/videodev.rst (91%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-create-bufs.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-cropcap.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-dbg-g-chip-info.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-dbg-g-register.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-decoder-cmd.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-dqevent.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-dv-timings-cap.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-encoder-cmd.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-enum-dv-timings.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-enum-fmt.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-enum-frameintervals.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-enum-framesizes.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-enum-freq-bands.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-enumaudio.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-enumaudioout.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-enuminput.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-enumoutput.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-enumstd.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-expbuf.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-audio.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-audioout.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-crop.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-ctrl.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-dv-timings.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-edid.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-enc-index.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-ext-ctrls.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-fbuf.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-fmt.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-frequency.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-input.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-jpegcomp.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-modulator.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-output.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-parm.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-priority.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-selection.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-sliced-vbi-cap.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-std.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-g-tuner.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-log-status.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-overlay.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-prepare-buf.rst (96%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-qbuf.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-query-dv-timings.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-querybuf.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-querycap.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-queryctrl.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-querystd.rst (97%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-reqbufs.rst (99%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-s-hw-freq-seek.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-streamon.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-subdev-enum-frame-interval.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-subdev-enum-frame-size.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-subdev-enum-mbus-code.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-subdev-g-crop.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-subdev-g-fmt.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-subdev-g-frame-interval.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-subdev-g-selection.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/vidioc-subscribe-event.rst (98%)
rename Documentation/{media/uapi => userspace-api/media}/v4l/yuv-formats.rst (97%)
rename Documentation/{ => userspace-api}/media/video.h.rst.exceptions (100%)
rename Documentation/{ => userspace-api}/media/videodev2.h.rst.exceptions (100%)
--
2.21.1
^ permalink raw reply [flat|nested] 4+ messages in thread* [PATCH RFC 2/2] docs: media kAPI docs: move them to driver-api 2020-03-04 10:51 [PATCH RFC 0/2] Move media uAPI and kAPI docs to a better place Mauro Carvalho Chehab @ 2020-03-04 10:51 ` Mauro Carvalho Chehab 2020-03-06 22:48 ` [PATCH RFC 0/2] Move media uAPI and kAPI docs to a better place Jonathan Corbet 1 sibling, 0 replies; 4+ messages in thread From: Mauro Carvalho Chehab @ 2020-03-04 10:51 UTC (permalink / raw) To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab, linux-kernel, Jonathan Corbet, linux-media All those documents describe the media driver API. So, move them to the right place within the Kernel documentation. Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> --- .../{media/kapi => driver-api/media}/cec-core.rst | 0 .../{media/kapi => driver-api/media}/csi2.rst | 0 .../{media/kapi => driver-api/media}/dtv-ca.rst | 0 .../{media/kapi => driver-api/media}/dtv-common.rst | 0 .../{media/kapi => driver-api/media}/dtv-core.rst | 0 .../{media/kapi => driver-api/media}/dtv-demux.rst | 0 .../kapi => driver-api/media}/dtv-frontend.rst | 0 .../{media/kapi => driver-api/media}/dtv-net.rst | 0 .../media_kapi.rst => driver-api/media/index.rst} | 12 ++++++------ .../{media/kapi => driver-api/media}/mc-core.rst | 0 .../{media/kapi => driver-api/media}/rc-core.rst | 0 .../{media/kapi => driver-api/media}/v4l2-async.rst | 0 .../{media/kapi => driver-api/media}/v4l2-clocks.rst | 0 .../{media/kapi => driver-api/media}/v4l2-common.rst | 0 .../kapi => driver-api/media}/v4l2-controls.rst | 0 .../{media/kapi => driver-api/media}/v4l2-core.rst | 0 .../{media/kapi => driver-api/media}/v4l2-dev.rst | 0 .../{media/kapi => driver-api/media}/v4l2-device.rst | 0 .../kapi => driver-api/media}/v4l2-dv-timings.rst | 0 .../{media/kapi => driver-api/media}/v4l2-event.rst | 0 .../{media/kapi => driver-api/media}/v4l2-fh.rst | 0 .../media}/v4l2-flash-led-class.rst | 0 .../{media/kapi => driver-api/media}/v4l2-fwnode.rst | 0 .../{media/kapi => driver-api/media}/v4l2-intro.rst | 0 .../{media/kapi => driver-api/media}/v4l2-mc.rst | 0 .../kapi => driver-api/media}/v4l2-mediabus.rst | 0 .../kapi => driver-api/media}/v4l2-mem2mem.rst | 0 .../{media/kapi => driver-api/media}/v4l2-rect.rst | 0 .../{media/kapi => driver-api/media}/v4l2-subdev.rst | 0 .../{media/kapi => driver-api/media}/v4l2-tuner.rst | 0 .../kapi => driver-api/media}/v4l2-tveeprom.rst | 0 .../kapi => driver-api/media}/v4l2-videobuf.rst | 0 .../kapi => driver-api/media}/v4l2-videobuf2.rst | 0 Documentation/media/index.rst | 2 +- Documentation/media/v4l-drivers/max2175.rst | 2 +- .../zh_CN/video4linux/v4l2-framework.txt | 2 +- MAINTAINERS | 4 +++- 37 files changed, 12 insertions(+), 10 deletions(-) rename Documentation/{media/kapi => driver-api/media}/cec-core.rst (100%) rename Documentation/{media/kapi => driver-api/media}/csi2.rst (100%) rename Documentation/{media/kapi => driver-api/media}/dtv-ca.rst (100%) rename Documentation/{media/kapi => driver-api/media}/dtv-common.rst (100%) rename Documentation/{media/kapi => driver-api/media}/dtv-core.rst (100%) rename Documentation/{media/kapi => driver-api/media}/dtv-demux.rst (100%) rename Documentation/{media/kapi => driver-api/media}/dtv-frontend.rst (100%) rename Documentation/{media/kapi => driver-api/media}/dtv-net.rst (100%) rename Documentation/{media/media_kapi.rst => driver-api/media/index.rst} (89%) rename Documentation/{media/kapi => driver-api/media}/mc-core.rst (100%) rename Documentation/{media/kapi => driver-api/media}/rc-core.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-async.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-clocks.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-common.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-controls.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-core.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-dev.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-device.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-dv-timings.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-event.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-fh.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-flash-led-class.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-fwnode.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-intro.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-mc.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-mediabus.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-mem2mem.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-rect.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-subdev.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-tuner.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-tveeprom.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-videobuf.rst (100%) rename Documentation/{media/kapi => driver-api/media}/v4l2-videobuf2.rst (100%) diff --git a/Documentation/media/kapi/cec-core.rst b/Documentation/driver-api/media/cec-core.rst similarity index 100% rename from Documentation/media/kapi/cec-core.rst rename to Documentation/driver-api/media/cec-core.rst diff --git a/Documentation/media/kapi/csi2.rst b/Documentation/driver-api/media/csi2.rst similarity index 100% rename from Documentation/media/kapi/csi2.rst rename to Documentation/driver-api/media/csi2.rst diff --git a/Documentation/media/kapi/dtv-ca.rst b/Documentation/driver-api/media/dtv-ca.rst similarity index 100% rename from Documentation/media/kapi/dtv-ca.rst rename to Documentation/driver-api/media/dtv-ca.rst diff --git a/Documentation/media/kapi/dtv-common.rst b/Documentation/driver-api/media/dtv-common.rst similarity index 100% rename from Documentation/media/kapi/dtv-common.rst rename to Documentation/driver-api/media/dtv-common.rst diff --git a/Documentation/media/kapi/dtv-core.rst b/Documentation/driver-api/media/dtv-core.rst similarity index 100% rename from Documentation/media/kapi/dtv-core.rst rename to Documentation/driver-api/media/dtv-core.rst diff --git a/Documentation/media/kapi/dtv-demux.rst b/Documentation/driver-api/media/dtv-demux.rst similarity index 100% rename from Documentation/media/kapi/dtv-demux.rst rename to Documentation/driver-api/media/dtv-demux.rst diff --git a/Documentation/media/kapi/dtv-frontend.rst b/Documentation/driver-api/media/dtv-frontend.rst similarity index 100% rename from Documentation/media/kapi/dtv-frontend.rst rename to Documentation/driver-api/media/dtv-frontend.rst diff --git a/Documentation/media/kapi/dtv-net.rst b/Documentation/driver-api/media/dtv-net.rst similarity index 100% rename from Documentation/media/kapi/dtv-net.rst rename to Documentation/driver-api/media/dtv-net.rst diff --git a/Documentation/media/media_kapi.rst b/Documentation/driver-api/media/index.rst similarity index 89% rename from Documentation/media/media_kapi.rst rename to Documentation/driver-api/media/index.rst index 1389998c90f7..d2842f300bbd 100644 --- a/Documentation/media/media_kapi.rst +++ b/Documentation/driver-api/media/index.rst @@ -30,9 +30,9 @@ For more details see the file COPYING in the source distribution of Linux. :maxdepth: 5 :numbered: - kapi/v4l2-core - kapi/dtv-core - kapi/rc-core - kapi/mc-core - kapi/cec-core - kapi/csi2 + v4l2-core + dtv-core + rc-core + mc-core + cec-core + csi2 diff --git a/Documentation/media/kapi/mc-core.rst b/Documentation/driver-api/media/mc-core.rst similarity index 100% rename from Documentation/media/kapi/mc-core.rst rename to Documentation/driver-api/media/mc-core.rst diff --git a/Documentation/media/kapi/rc-core.rst b/Documentation/driver-api/media/rc-core.rst similarity index 100% rename from Documentation/media/kapi/rc-core.rst rename to Documentation/driver-api/media/rc-core.rst diff --git a/Documentation/media/kapi/v4l2-async.rst b/Documentation/driver-api/media/v4l2-async.rst similarity index 100% rename from Documentation/media/kapi/v4l2-async.rst rename to Documentation/driver-api/media/v4l2-async.rst diff --git a/Documentation/media/kapi/v4l2-clocks.rst b/Documentation/driver-api/media/v4l2-clocks.rst similarity index 100% rename from Documentation/media/kapi/v4l2-clocks.rst rename to Documentation/driver-api/media/v4l2-clocks.rst diff --git a/Documentation/media/kapi/v4l2-common.rst b/Documentation/driver-api/media/v4l2-common.rst similarity index 100% rename from Documentation/media/kapi/v4l2-common.rst rename to Documentation/driver-api/media/v4l2-common.rst diff --git a/Documentation/media/kapi/v4l2-controls.rst b/Documentation/driver-api/media/v4l2-controls.rst similarity index 100% rename from Documentation/media/kapi/v4l2-controls.rst rename to Documentation/driver-api/media/v4l2-controls.rst diff --git a/Documentation/media/kapi/v4l2-core.rst b/Documentation/driver-api/media/v4l2-core.rst similarity index 100% rename from Documentation/media/kapi/v4l2-core.rst rename to Documentation/driver-api/media/v4l2-core.rst diff --git a/Documentation/media/kapi/v4l2-dev.rst b/Documentation/driver-api/media/v4l2-dev.rst similarity index 100% rename from Documentation/media/kapi/v4l2-dev.rst rename to Documentation/driver-api/media/v4l2-dev.rst diff --git a/Documentation/media/kapi/v4l2-device.rst b/Documentation/driver-api/media/v4l2-device.rst similarity index 100% rename from Documentation/media/kapi/v4l2-device.rst rename to Documentation/driver-api/media/v4l2-device.rst diff --git a/Documentation/media/kapi/v4l2-dv-timings.rst b/Documentation/driver-api/media/v4l2-dv-timings.rst similarity index 100% rename from Documentation/media/kapi/v4l2-dv-timings.rst rename to Documentation/driver-api/media/v4l2-dv-timings.rst diff --git a/Documentation/media/kapi/v4l2-event.rst b/Documentation/driver-api/media/v4l2-event.rst similarity index 100% rename from Documentation/media/kapi/v4l2-event.rst rename to Documentation/driver-api/media/v4l2-event.rst diff --git a/Documentation/media/kapi/v4l2-fh.rst b/Documentation/driver-api/media/v4l2-fh.rst similarity index 100% rename from Documentation/media/kapi/v4l2-fh.rst rename to Documentation/driver-api/media/v4l2-fh.rst diff --git a/Documentation/media/kapi/v4l2-flash-led-class.rst b/Documentation/driver-api/media/v4l2-flash-led-class.rst similarity index 100% rename from Documentation/media/kapi/v4l2-flash-led-class.rst rename to Documentation/driver-api/media/v4l2-flash-led-class.rst diff --git a/Documentation/media/kapi/v4l2-fwnode.rst b/Documentation/driver-api/media/v4l2-fwnode.rst similarity index 100% rename from Documentation/media/kapi/v4l2-fwnode.rst rename to Documentation/driver-api/media/v4l2-fwnode.rst diff --git a/Documentation/media/kapi/v4l2-intro.rst b/Documentation/driver-api/media/v4l2-intro.rst similarity index 100% rename from Documentation/media/kapi/v4l2-intro.rst rename to Documentation/driver-api/media/v4l2-intro.rst diff --git a/Documentation/media/kapi/v4l2-mc.rst b/Documentation/driver-api/media/v4l2-mc.rst similarity index 100% rename from Documentation/media/kapi/v4l2-mc.rst rename to Documentation/driver-api/media/v4l2-mc.rst diff --git a/Documentation/media/kapi/v4l2-mediabus.rst b/Documentation/driver-api/media/v4l2-mediabus.rst similarity index 100% rename from Documentation/media/kapi/v4l2-mediabus.rst rename to Documentation/driver-api/media/v4l2-mediabus.rst diff --git a/Documentation/media/kapi/v4l2-mem2mem.rst b/Documentation/driver-api/media/v4l2-mem2mem.rst similarity index 100% rename from Documentation/media/kapi/v4l2-mem2mem.rst rename to Documentation/driver-api/media/v4l2-mem2mem.rst diff --git a/Documentation/media/kapi/v4l2-rect.rst b/Documentation/driver-api/media/v4l2-rect.rst similarity index 100% rename from Documentation/media/kapi/v4l2-rect.rst rename to Documentation/driver-api/media/v4l2-rect.rst diff --git a/Documentation/media/kapi/v4l2-subdev.rst b/Documentation/driver-api/media/v4l2-subdev.rst similarity index 100% rename from Documentation/media/kapi/v4l2-subdev.rst rename to Documentation/driver-api/media/v4l2-subdev.rst diff --git a/Documentation/media/kapi/v4l2-tuner.rst b/Documentation/driver-api/media/v4l2-tuner.rst similarity index 100% rename from Documentation/media/kapi/v4l2-tuner.rst rename to Documentation/driver-api/media/v4l2-tuner.rst diff --git a/Documentation/media/kapi/v4l2-tveeprom.rst b/Documentation/driver-api/media/v4l2-tveeprom.rst similarity index 100% rename from Documentation/media/kapi/v4l2-tveeprom.rst rename to Documentation/driver-api/media/v4l2-tveeprom.rst diff --git a/Documentation/media/kapi/v4l2-videobuf.rst b/Documentation/driver-api/media/v4l2-videobuf.rst similarity index 100% rename from Documentation/media/kapi/v4l2-videobuf.rst rename to Documentation/driver-api/media/v4l2-videobuf.rst diff --git a/Documentation/media/kapi/v4l2-videobuf2.rst b/Documentation/driver-api/media/v4l2-videobuf2.rst similarity index 100% rename from Documentation/media/kapi/v4l2-videobuf2.rst rename to Documentation/driver-api/media/v4l2-videobuf2.rst diff --git a/Documentation/media/index.rst b/Documentation/media/index.rst index 8118c2d001ff..308f6a396d1c 100644 --- a/Documentation/media/index.rst +++ b/Documentation/media/index.rst @@ -13,7 +13,7 @@ Linux Media Subsystem Documentation :maxdepth: 2 ../userspace-api/media/index - media_kapi + ../driver-api/media/index dvb-drivers/index v4l-drivers/index cec-drivers/index diff --git a/Documentation/media/v4l-drivers/max2175.rst b/Documentation/media/v4l-drivers/max2175.rst index a5e35059d98d..35d3c4b41fc7 100644 --- a/Documentation/media/v4l-drivers/max2175.rst +++ b/Documentation/media/v4l-drivers/max2175.rst @@ -9,7 +9,7 @@ The MAX2175 driver implements the following driver-specific controls: ------------------------------- Enable/Disable I2S output of the tuner. This is a private control that can be accessed only using the subdev interface. - Refer to Documentation/media/kapi/v4l2-controls.rst for more details. + Refer to Documentation/driver-api/media/v4l2-controls.rst for more details. .. flat-table:: :header-rows: 0 diff --git a/Documentation/translations/zh_CN/video4linux/v4l2-framework.txt b/Documentation/translations/zh_CN/video4linux/v4l2-framework.txt index 9c39ee58ea50..6a41023b7d60 100644 --- a/Documentation/translations/zh_CN/video4linux/v4l2-framework.txt +++ b/Documentation/translations/zh_CN/video4linux/v4l2-framework.txt @@ -777,7 +777,7 @@ v4l2 核心 API 提供了一个处理视频缓冲的标准方法(称为“videob 线性 DMA(videobuf-dma-contig)以及大多用于 USB 设备的用 vmalloc 分配的缓冲(videobuf-vmalloc)。 -请参阅 Documentation/media/kapi/v4l2-videobuf.rst,以获得更多关于 videobuf +请参阅 Documentation/driver-api/media/v4l2-videobuf.rst,以获得更多关于 videobuf 层的使用信息。 v4l2_fh 结构体 diff --git a/MAINTAINERS b/MAINTAINERS index 0ce0a1c93961..b5af1feb5ba1 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -3853,7 +3853,7 @@ L: linux-media@vger.kernel.org T: git git://linuxtv.org/media_tree.git W: http://linuxtv.org S: Supported -F: Documentation/media/kapi/cec-core.rst +F: Documentation/driver-api/media/cec-core.rst F: Documentation/userspace-api/media/cec F: drivers/media/cec/ F: drivers/media/rc/keymaps/rc-cec.c @@ -5109,6 +5109,7 @@ X: Documentation/devicetree/ X: Documentation/i2c/ X: Documentation/media/ X: Documentation/userspace-api/media/ +X: Documentation/driver-api/media/ X: Documentation/power/ X: Documentation/spi/ T: git git://git.lwn.net/linux.git docs-next @@ -10489,6 +10490,7 @@ S: Maintained F: Documentation/devicetree/bindings/media/ F: Documentation/media/ F: Documentation/userspace-api/media/ +F: Documentation/driver-api/media/ F: drivers/media/ F: drivers/staging/media/ F: include/linux/platform_data/media/ -- 2.21.1 ^ permalink raw reply related [flat|nested] 4+ messages in thread
* Re: [PATCH RFC 0/2] Move media uAPI and kAPI docs to a better place 2020-03-04 10:51 [PATCH RFC 0/2] Move media uAPI and kAPI docs to a better place Mauro Carvalho Chehab 2020-03-04 10:51 ` [PATCH RFC 2/2] docs: media kAPI docs: move them to driver-api Mauro Carvalho Chehab @ 2020-03-06 22:48 ` Jonathan Corbet 2020-03-07 9:20 ` Mauro Carvalho Chehab 1 sibling, 1 reply; 4+ messages in thread From: Jonathan Corbet @ 2020-03-06 22:48 UTC (permalink / raw) To: Mauro Carvalho Chehab; +Cc: Linux Doc Mailing List, linux-kernel, linux-media On Wed, 4 Mar 2020 11:51:01 +0100 Mauro Carvalho Chehab <mchehab+huawei@kernel.org> wrote: > This is something that you always wanted: move uAPI and kAPI to > separate books. Oh goodie...Christmas is coming early this year...:) > This RFC series start doing it for the media docs. > > For now, this is just a RFC, being only an initial step for it. I'm sending > it on this early stage just to rise some discussions. > > This changeset basically moves: > > - the media kAPI files to be under driver-api/media; > - the media uAPI files to be under userspace-api/media. > > This version keeps including both inside Documentation/media/index.rst. The moves make sense to me. The including part I'm not so sure about. It seems kind of strange to have the structure of the rendered docs be different from that of the plain-text docs; it suggests that one of the two placements is wrong. My own choice (as you suggest later) would be to keep the structure the same in both domains, and to use cross-references to create paths where they are needed. > The driver-specific information is messy, as each file there may contain > either one or more of the following items: > > - driver-development information; > - on a few drivers, drivers-specific uAPI. > - modprobe parameters; > - List of devices supported by each driver; > > The last two are probably contents for the admin-guide, but not sure > where to place driver-specific development information. Does it > belong to "driver-api" book too? > > I guess that driver-specific uAPI could fit at the userspace-api, but I > don't want them to be at the same place as the core media API stuff. > > Suggestions? That is a good question. I've wondered for a bit if we need a separate hardware manual for documentation specific to a given device. In cases like this, it could perhaps consist mostly of cross-references to the relevant documentation in the other manuals. It's hard to argue, for example, that "modprobe parameters" should be somewhere other than with all the other command-line parameters... Thanks, jon ^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH RFC 0/2] Move media uAPI and kAPI docs to a better place 2020-03-06 22:48 ` [PATCH RFC 0/2] Move media uAPI and kAPI docs to a better place Jonathan Corbet @ 2020-03-07 9:20 ` Mauro Carvalho Chehab 0 siblings, 0 replies; 4+ messages in thread From: Mauro Carvalho Chehab @ 2020-03-07 9:20 UTC (permalink / raw) To: Jonathan Corbet; +Cc: Linux Doc Mailing List, linux-kernel, linux-media Em Fri, 6 Mar 2020 15:48:53 -0700 Jonathan Corbet <corbet@lwn.net> escreveu: > On Wed, 4 Mar 2020 11:51:01 +0100 > Mauro Carvalho Chehab <mchehab+huawei@kernel.org> wrote: > > > This is something that you always wanted: move uAPI and kAPI to > > separate books. > > Oh goodie...Christmas is coming early this year...:) :-) > > > This RFC series start doing it for the media docs. > > > > For now, this is just a RFC, being only an initial step for it. I'm sending > > it on this early stage just to rise some discussions. > > > > This changeset basically moves: > > > > - the media kAPI files to be under driver-api/media; > > - the media uAPI files to be under userspace-api/media. > > > > This version keeps including both inside Documentation/media/index.rst. > > The moves make sense to me. The including part I'm not so sure about. It > seems kind of strange to have the structure of the rendered docs be > different from that of the plain-text docs; it suggests that one of the two > placements is wrong. > > My own choice (as you suggest later) would be to keep the structure the > same in both domains, and to use cross-references to create paths where > they are needed. Ok. So, I would keep a Documentation/media/index.rst that will just have cross-references for the documentation elsewhere, right? Makes sense to me. > > > The driver-specific information is messy, as each file there may contain > > either one or more of the following items: > > > > - driver-development information; > > - on a few drivers, drivers-specific uAPI. > > - modprobe parameters; > > - List of devices supported by each driver; > > > > The last two are probably contents for the admin-guide, but not sure > > where to place driver-specific development information. Does it > > belong to "driver-api" book too? > > > > I guess that driver-specific uAPI could fit at the userspace-api, but I > > don't want them to be at the same place as the core media API stuff. > > > > Suggestions? > > That is a good question. I've wondered for a bit if we need a separate > hardware manual for documentation specific to a given device. In cases > like this, it could perhaps consist mostly of cross-references to the > relevant documentation in the other manuals. There are a large number of Kernel drivers (not only on media) that have "hardware manuals" inside Documentation. - Btw, I finished yesterday the split: https://git.linuxtv.org/mchehab/experimental.git/log/?h=media-docs So, we can now see more concrete examples about how such change would like. I still intend to add some cross-references and toadd some extra entries at MAINTAINERS for the newer files and do some cleanups (on this series, I kept the contents pretty much untouched), but we can see already the big picture. > It's hard to argue, for > example, that "modprobe parameters" should be somewhere other than with all > the other command-line parameters... Well, on media, several modprobe parameters require a long explanation, as they're used to overcome some limitations of probing devices that don't have any BIOSes and share a common PCI ID (or USB ID) for completely different hardware. So, just blindly adding them at Documentation/admin-guide/kernel-parameters.txt may not be the best (yet, we should do some efforts to place a short summary of them there, as I'm pretty sure that some of those aren't refleced there). One of the bad things on keeping kernel-parameters.txt as a text file (and having a .rst including it as a literal doc) is that we can't have cross-references there. - On this series, what I did with the driver information is that I placed: 1) drivers release notes: - https://git.linuxtv.org/mchehab/experimental.git/tree/Documentation/admin-guide/media?h=media-docs The stuff there are all focused on explaining users about some device-specific thing (supported cards, known problems, how to use drivers, etc). Those include modprobe parameters, and also other user-facing stuff, like command line examples about how to do some things. Some still include some (probably outdated) instructions about how to build a Kernel with such driver. 2) Development-specific documentation: - https://git.linuxtv.org/mchehab/experimental.git/tree/Documentation/driver-api/media/drivers?h=media-docs A large part of that are related to things that the drivers' develpers seem to had figured out themselves. Only useful if someone would need to touch the source code. They work as some sort of "Hardware manuals". The name "driver-api" is not really appropriate for it, as they don't define any API. They're pure "hardware API docs". Yet, developers needing such info also needs to know media kAPI. So, while not a perfect fit, it sounded better than placing them elsewhere. 3) Driver-specific uAPI: - https://git.linuxtv.org/mchehab/experimental.git/tree/Documentation/userspace-api/media/drivers?h=media-docs It covers extensions of the media API to cover driver-specific stuff that can't be generalized. This incudes some driver-specific formats, some extra controls to control some hardware-specific parameters and meta-data streaming (used by some image-enhancing algorithms for cellphone cameras). Btw, I'm very happy on having a separate session with all driver-specific APIs. As a maintainer, now I have a centralized place at the docs where I can see all device-specific userpace APIs, with is a good thing. Yet, for someone developing an application to work with some of those hardware it may now need to read on two separate places. For example, see the IMX driver documentation split: https://git.linuxtv.org/mchehab/experimental.git/commit/?h=media-docs&id=da5a18aa27c564cdb4fa6f84026be1c72c1a877c Anyone working with such driver will need to be able to setup the hardware pipelines, via the standard media controller API. This is done using existing applications. So, the command line instructions and pipeline examples are at the driver's release notes: https://git.linuxtv.org/mchehab/experimental.git/tree/Documentation/admin-guide/media/imx.rst?h=media-docs Also, to fully control the hardware, the userspace application will need to implement support for some device-specific controls and receive some events. This is covered at: https://git.linuxtv.org/mchehab/experimental.git/tree/Documentation/userspace-api/media/drivers/imx-uapi.rst?h=media-docs On this specific split[1], I added cross-references at the admin-guide to the API documentation. Not sure if this is enough or if we would need more things to cross-reference the docs that got split. [1] I should do something similar to it with the other split documents. Comments? Regards, Mauro ^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2020-03-07 9:20 UTC | newest] Thread overview: 4+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2020-03-04 10:51 [PATCH RFC 0/2] Move media uAPI and kAPI docs to a better place Mauro Carvalho Chehab 2020-03-04 10:51 ` [PATCH RFC 2/2] docs: media kAPI docs: move them to driver-api Mauro Carvalho Chehab 2020-03-06 22:48 ` [PATCH RFC 0/2] Move media uAPI and kAPI docs to a better place Jonathan Corbet 2020-03-07 9:20 ` Mauro Carvalho Chehab
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).