Skip to content

L
linux
An error occurred fetching the project authors.
Switch branch/tag
  1. 14 Sep, 2020 1 commit
  3. 19 Jul, 2020 1 commit
  5. 23 Jun, 2020 1 commit
  7. 14 Apr, 2020 1 commit
  9. 24 Feb, 2020 1 commit
  11. 21 Oct, 2019 1 commit
  13. 30 Mar, 2019 1 commit
  15. 25 Mar, 2019 1 commit
  17. 07 Jan, 2019 1 commit
  19. 14 Dec, 2018 1 commit
  21. 05 Dec, 2018 2 commits
  23. 11 Sep, 2018 4 commits
  25. 31 Aug, 2018 1 commit
  27. 26 Feb, 2018 1 commit
  29. 15 Apr, 2017 3 commits
  31. 22 Sep, 2016 1 commit
    • Laurent Pinchart's avatar
      [media] v4l: doc: Remove row numbers from tables · c2b66caf
      Laurent Pinchart authored 
      Shorten the tables by removing row numbers in comments, allowing for
later insertion of rows with minimal diffs.

All changes have been generated by the following script.

import io
import re
import sys

def process_table(fname, data):
	if fname.endswith('hist-v4l2.rst'):
		data = re.sub(u'\n{1,2}\t( ?)  -( ?) ?', u'\n\t\\1 -\\2', data, flags = re.MULTILINE)
		data = re.sub(u'\n(\t|       )-  \.\. row [0-9]+\n\t  ?-( ?) ?', u'\\1* -\\2', data, flags = re.MULTILINE)
	else:
		data = re.sub(u'\n{1,2}       -( ?) ?', u'\n      -\\1', data, flags = re.MULTILINE)
		data = re.sub(u'(\n?)(\n\n    -  \.\. row 1\n)', u'\n\\2', data, flags = re.MULTILINE)
		data = re.sub(u'\n    -  \.\. row [0-9]+\n      -( ?) ?', u'    * -\\1', data, flags = re.MULTILINE)
		data = re.sub(u'\n    -  \.\. row [0-9]+\n       \.\. (_[A-Z0-9_`-]*:)', u'\n    -  .. \\1', data, flags = re.MULTILINE)
		data = re.sub(u'\n    -  \.\. (_[A-Z0-9_`-]*:)\n      -', u'    * .. \\1\n\n      -', data, flags = re.MULTILINE)
		data = re.sub(u'^       - ', u'      -', data, flags = re.MULTILINE)
		data = re.sub(u'^(\t{1,2})  ', u'\\1', data, flags = re.MULTILINE)

	return data

def process_file(fname, data):
	buf = io.StringIO(data)
	output = ''
	in_table = False
	table_separator = 0

	for line in buf.readlines():
		if line.find('.. flat-table::') != -1:
			in_table = True
			table = ''
		elif in_table and not re.match('^[\t\n]|(    )', line):
			in_table = False
			output += process_table(fname, table)

		if in_table:
			table += line
		else:
			output += line

	if in_table:
		in_table = False
		output += process_table(fname, table)

	return output

fname = sys.argv[1]

data = file(fname, 'rb').read().decode('utf-8')
data = process_file(fname, data)
file(fname, 'wb').write(data.encode('utf-8'))
Signed-off-by: default avatarLaurent Pinchart <laurent.pinchart@ideasonboard.com>
      c2b66caf
  33. 09 Sep, 2016 5 commits
    • Mauro Carvalho Chehab's avatar
      [media] docs-rst: fix cross-references for videodev2.h · 56683d7d
      Mauro Carvalho Chehab authored 
      There are several broken references there, due to the conversion to
C domain. Fix them using this shell script and manually adjust what's
broken:

	# funcs is a file with the broken functions/references
	for i in $(cat funcs|sort|uniq|perl -ne 'print "$1\n" if (m/(\S+)$/)'); do
		i=${i//-/_}
		echo $i
		j=${i//_/-}
		for k in $(git grep -l "_$j:" Documentation/); do
			sed s,\_$j\:,"c\:type\:\: $i", <$k >a && mv a $k
		done
		for k in $(git grep -l "$j" Documentation/media/*.exceptions); do
			sed s,$j,":c\:type\:\`$i\`", <$k >a && mv a $k
		done
		for k in $(git grep -l "$j" Documentation/); do
			sed "s,:ref:\`$i <$j>\`,:c:type:\`$i\`," <$k >a && mv a $k
			sed "s,:ref:\`$j\`,:c:type:\`$i\`," <$k >a && mv a $k
			sed -E "s,:ref:\`(.*)<$j>\`,:c:type:\`\1<$i>\`," <$k >a && mv a $k
		done
		for k in $(git grep -l "<$j>" include/media); do
			sed -E "s,:ref:\`(.*)<$j>\`,enum \&$i," <$k >a && mv a $k
		done
	done
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
      56683d7d
    • Mauro Carvalho Chehab's avatar
      [media] fix clock_gettime cross-references · 39b6b900
      Mauro Carvalho Chehab authored 
      Fix those warnings:

	Documentation/media/uapi/cec/cec-ioc-dqevent.rst:124: WARNING: c:func reference target not found: clock_gettime(2)

By replacing it with the right function name, using this shell script:

	for i in `find Documentation/media -type f`; do sed 's,clock_gettime(2),clock_gettime,' <$i >a && mv a $i; done

Please notice that this will make the nitpick mode to shut up
complaining about that, becasue clock_gettime is on its exclude list,
but the cross reference will be undefined until someone documents
this function at the core documentation.
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
      39b6b900
    • Mauro Carvalho Chehab's avatar
      [media] docs-rst: fix some broken struct references · a17a954e
      Mauro Carvalho Chehab authored 
      The :c:type: references point to the structure name, and not to
struct foo.

Fixed via this shell script:

	for i in `find Documentation/media -type f`; do perl -ne 'if (s/\:c\:type\:\`struct\s*(\S+)\`/struct :c:type:`$1`/) { s/struct\s+struct/struct/;  s/(struct\s+\:c\:type\:\`\S+\`)\s+structure/$1/;  } print $_' <$i >a && mv a $i; done
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
      a17a954e
    • Mauro Carvalho Chehab's avatar
      [media] docs-rst: simplify c:type: cross references · fc78c7c7
      Mauro Carvalho Chehab authored 
      Instead of using c:type:`struct foo <foo>`, use:
	struct c:type:`foo`

This patch was generated via this shell script:

	for i in `find Documentation/media -type f`; do perl -ne 'if (m/\:c\:type\:\`struct\s+(\S+)\s*\<(\S+)\>\`/) { $s=$1; $r=$2; if ($s eq $r) { s/\:c\:type\:\`struct\s+(\S+)\s*\<(\S+)\>\`/struct :c:type:`$2`/; s/struct\s+struct/struct/;  s/(struct\s+\:c\:type\:\`\S+\`)\s+structure/$1/;  }} print $_' <$i >a && mv a $i; done
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
      fc78c7c7
    • Mauro Carvalho Chehab's avatar
      [media] docs-rst: convert uAPI structs to C domain · e8be7e97
      Mauro Carvalho Chehab authored 
      instead of declaring the uAPI structs using usual refs, e. g.:
	.. _foo-struct:

Use the C domain way:
	.. c:type:: foo_struct

This way, the kAPI documentation can use cross-references to
point to the uAPI symbols.

That solves about ~100 undefined warnings like:
	WARNING: c:type reference target not found: foo_struct
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
      e8be7e97
  35. 22 Aug, 2016 4 commits
  37. 13 Jul, 2016 1 commit
  39. 12 Jul, 2016 2 commits
  41. 10 Jul, 2016 1 commit
  43. 08 Jul, 2016 1 commit
  45. 04 Jul, 2016 2 commits
  47. 03 Jul, 2016 2 commits
GitLab Nexedi Edition | About GitLab | About Nexedi | 沪ICP备2021021310号-2 | 沪ICP备2021021310号-7