89a66d7610
This script uses pandoc to convert existing DocBook template files to RST templates. A couple of sed scripts are need to massage things both before and after the conversion, but the result is then usable with no hand editing. [Jani: Change usage to tmplcvt <in> <out>. Fix escaping for docproc directives. Add support the new kernel-doc extension.] Signed-off-by: Jonathan Corbet <corbet@lwn.net> Signed-off-by: Jani Nikula <jani.nikula@intel.com>
20 lines
596 B
Sed
20 lines
596 B
Sed
#
|
|
# pandoc thinks that both "_" needs to be escaped. Remove the extra
|
|
# backslashes. Also put in proper backquotes now that pandoc won't quote
|
|
# them.
|
|
#
|
|
s/$bq/`/g
|
|
s/\\_/_/g
|
|
#
|
|
# Unwrap docproc directives.
|
|
#
|
|
s/^``DOCPROC: !E\(.*\)``$/.. kernel-doc:: \1\n :export:/
|
|
s/^``DOCPROC: !I\(.*\)``$/.. kernel-doc:: \1\n :internal:/
|
|
s/^``DOCPROC: !F\([^ ]*\) \(.*\)``$/.. kernel-doc:: \1\n :functions: \2/
|
|
s/^``DOCPROC: !P\([^ ]*\) \(.*\)``$/.. kernel-doc:: \1\n :doc: \2/
|
|
s/^``DOCPROC: \(!.*\)``$/.. WARNING: DOCPROC directive not supported: \1/
|
|
#
|
|
# Trim trailing whitespace.
|
|
#
|
|
s/[[:space:]]*$//
|