linux/Documentation/media/uapi/dvb
Mauro Carvalho Chehab 5bd4bb7817 [media] docs-rst: add tabularcolumns to all tables
LaTeX doesn't handle too well auto-width on tables, and ReST
markup requires an special tag to give it the needed hints.

As we're using A4 paper, we have 17cm of useful spaces. As
most media tables have widths, let's use it to generate the
needed via the following perl script:

my ($line_size, $table_header, $has_cols) = (17.5, 0, 0);
my $out;
my $header = "";
my @widths = ();
sub round { $_[0] > 0 ? int($_[0] + .5) : -int(-$_[0] + .5) }
while (<>) {
	if (!$table_header) {
		$has_cols = 1 if (m/..\s+tabularcolumns::/);
		if (m/..\s+flat-table::/) {
			$table_header = 1;
			$header = $_;
			next;
		}
		$out .= $_;
		next;
	}
	$header .= $_;
	@widths = split(/ /, $1) if (m/:widths:\s+(.*)/);
	if (m/^\n$/) {
		if (!$has_cols && @widths) {
			my ($tot, $t, $i) = (0, 0, 0);
			foreach my $v(@widths) { $tot += $v; };
			$out .= ".. tabularcolumns:: |";
			for ($i = 0; $i < scalar @widths - 1; $i++) {
				my $v = $widths[$i];
				my $w = round(10 * ($v * $line_size) / $tot) / 10;
				$out .= sprintf "p{%.1fcm}|", $w;
				$t += $w;
			}
			my $w = $line_size - $t;
			$out .= sprintf "p{%.1fcm}|\n\n", $w;
		}
		$out .= $header;
		$table_header = 0;
		$has_cols = 0;
		$header = "";
		@widths = ();
	}
}
print $out;

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-08-22 10:07:12 -03:00
..
intro_files
audio_data_types.rst
audio_function_calls.rst
audio_h.rst
audio-bilingual-channel-select.rst
audio-channel-select.rst
audio-clear-buffer.rst
audio-continue.rst
audio-fclose.rst
audio-fopen.rst
audio-fwrite.rst
audio-get-capabilities.rst
audio-get-pts.rst
audio-get-status.rst
audio-pause.rst
audio-play.rst
audio-select-source.rst
audio-set-attributes.rst
audio-set-av-sync.rst
audio-set-bypass-mode.rst
audio-set-ext-id.rst
audio-set-id.rst
audio-set-karaoke.rst
audio-set-mixer.rst
audio-set-mute.rst
audio-set-streamtype.rst
audio-stop.rst
audio.rst
ca_data_types.rst Revert "[media] docs-rst: escape [] characters" 2016-07-13 08:43:30 -03:00
ca_function_calls.rst
ca_h.rst
ca-fclose.rst
ca-fopen.rst
ca-get-cap.rst
ca-get-descr-info.rst
ca-get-msg.rst
ca-get-slot-info.rst
ca-reset.rst
ca-send-msg.rst
ca-set-descr.rst
ca-set-pid.rst
ca.rst
demux.rst
dmx_fcalls.rst
dmx_h.rst
dmx_types.rst
dmx-add-pid.rst
dmx-fclose.rst
dmx-fopen.rst
dmx-fread.rst
dmx-fwrite.rst
dmx-get-caps.rst
dmx-get-event.rst
dmx-get-pes-pids.rst Revert "[media] docs-rst: escape [] characters" 2016-07-13 08:43:30 -03:00
dmx-get-stc.rst
dmx-remove-pid.rst
dmx-set-buffer-size.rst
dmx-set-filter.rst
dmx-set-pes-filter.rst
dmx-set-source.rst
dmx-start.rst
dmx-stop.rst
dtv-fe-stats.rst
dtv-properties.rst
dtv-property.rst Revert "[media] docs-rst: escape [] characters" 2016-07-13 08:43:30 -03:00
dtv-stats.rst
dvb-fe-read-status.rst [media] docs-rst: better use the .. note:: tag 2016-08-22 10:02:29 -03:00
dvb-frontend-event.rst
dvb-frontend-parameters.rst
dvbapi.rst [media] docs-rst: better use the .. note:: tag 2016-08-22 10:02:29 -03:00
dvbproperty-006.rst
dvbproperty.rst [media] docs-rst: better use the .. note:: tag 2016-08-22 10:02:29 -03:00
examples.rst [media] docs-rst: better use the .. note:: tag 2016-08-22 10:02:29 -03:00
fe_property_parameters.rst [media] doc-rst: improve DTV_BANDWIDTH_HZ notes 2016-07-10 09:50:07 -03:00
fe-bandwidth-t.rst
fe-diseqc-recv-slave-reply.rst [media] docs-rst: add tabularcolumns to all tables 2016-08-22 10:07:12 -03:00
fe-diseqc-reset-overload.rst
fe-diseqc-send-burst.rst
fe-diseqc-send-master-cmd.rst [media] docs-rst: add tabularcolumns to all tables 2016-08-22 10:07:12 -03:00
fe-dishnetwork-send-legacy-cmd.rst [media] doc-rst: improve display of notes and warnings 2016-07-10 12:06:28 -03:00
fe-enable-high-lnb-voltage.rst
fe-get-event.rst
fe-get-frontend.rst
fe-get-info.rst [media] docs-rst: add tabularcolumns to all tables 2016-08-22 10:07:12 -03:00
fe-get-property.rst
fe-read-ber.rst
fe-read-signal-strength.rst
fe-read-snr.rst
fe-read-status.rst [media] docs-rst: better use the .. note:: tag 2016-08-22 10:02:29 -03:00
fe-read-uncorrected-blocks.rst
fe-set-frontend-tune-mode.rst
fe-set-frontend.rst
fe-set-tone.rst [media] doc-rst: improve display of notes and warnings 2016-07-10 12:06:28 -03:00
fe-set-voltage.rst [media] doc-rst: improve display of notes and warnings 2016-07-10 12:06:28 -03:00
fe-type-t.rst [media] docs-rst: add tabularcolumns to all tables 2016-08-22 10:07:12 -03:00
frontend_f_close.rst
frontend_f_open.rst
frontend_fcalls.rst
frontend_h.rst
frontend_legacy_api.rst
frontend_legacy_dvbv3_api.rst
frontend-property-cable-systems.rst
frontend-property-satellite-systems.rst
frontend-property-terrestrial-systems.rst
frontend-stat-properties.rst
frontend.rst [media] docs-rst: better use the .. note:: tag 2016-08-22 10:02:29 -03:00
intro.rst
legacy_dvb_apis.rst
net_h.rst
net-add-if.rst
net-get-if.rst
net-remove-if.rst
net.rst
query-dvb-frontend-info.rst
video_function_calls.rst
video_h.rst
video_types.rst Revert "[media] docs-rst: escape [] characters" 2016-07-13 08:43:30 -03:00
video-clear-buffer.rst
video-command.rst
video-continue.rst
video-fast-forward.rst
video-fclose.rst
video-fopen.rst
video-freeze.rst
video-fwrite.rst
video-get-capabilities.rst
video-get-event.rst
video-get-frame-count.rst
video-get-frame-rate.rst
video-get-navi.rst
video-get-pts.rst
video-get-size.rst
video-get-status.rst
video-play.rst
video-select-source.rst
video-set-attributes.rst
video-set-blank.rst
video-set-display-format.rst
video-set-format.rst
video-set-highlight.rst
video-set-id.rst
video-set-spu-palette.rst
video-set-spu.rst
video-set-streamtype.rst
video-set-system.rst
video-slowmotion.rst
video-stillpicture.rst
video-stop.rst
video-try-command.rst
video.rst