Files
Mészáros Gergely 57ad953d7b Doxysphinx docs (#3192)
* Reorganize documenation based on rocm-docs-core

* Move build, install and contributing guides to docs

* Bump readthedocs config to Ubuntu 20.04

* Add more direct links to the API modules

* Pin rocm-docs-core version, add dependabot

- Use the pip package to have rocm-docs-core pinned
- Add dependabot config to update pinned packages (including rocm-docs-core)

* fixup! Add more direct links to the API modules

---------


[ROCm/hip commit: ae5f8714f4]
2023-04-18 20:49:28 -07:00

103 baris
3.0 KiB
Bash
Executable File

#!/bin/bash
# Copyright (C) 2019-2021 Advanced Micro Devices, Inc. All Rights Reserved.
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
# THE SOFTWARE.
## generates documentation about clang options.
clang=/opt/rocm*/llvm/bin/clang
exec > clang_options.md
echo "# Support of Clang options"
echo " Clang version: $($clang --version | head -1|sed 's:\(.*\) (.* \(.*\)).*:\1 \2:')"
echo
echo "|Option|Support|Description|"
echo "|-------|------|-------|"
declare -A db
while read a b; do
if [[ "$a" != "" && "$b" != "" ]]; then
db[$a]="$b"
#echo "db[$a]=${db[$a]}"
fi
done <clang_options.txt
#for K in "${!db[@]}"; do echo $K; done
tmpf=tmp_clang_option.txt
[[ -f $tmpf ]] && rm $tmpf
$clang --help | sed '1,5d'| while read a b; do
if [[ "$a" != "-"* ]]; then
desc="$a $b"
elif [[ "$b" = *'>'* ]]; then
opt=$(echo $a $b| sed -e 's:\(^-[^ ]*[= ]*<[^<>]*>\) *\(.*\):\1:')
desc=$(echo $a $b| sed -e 's:\(^-[^ ]*[= ]*<[^<>]*>\) *\(.*\):\2:')
if [[ "$opt" == "$desc" ]]; then
opt="$a"
desc="$b"
fi
else
opt="$a"
desc="$b"
fi
supp=
key=$(printf "%s" "$opt" |sed 's:\([^ =<]*\).*:\1:')
if [[ "$key" != "" ]]; then
supp="${db[$key]}"
#echo "opt=$opt supp=${db[$opt]}"
fi
if [[ "$supp" == "" ]]; then
if [[ "$desc" = *AArch* ||\
"$desc" = *MIPS* || \
"$desc" = *ARM* || \
"$desc" = *Arm* || \
"$desc" = *SYCL* || \
"$desc" = *PPC* || \
"$desc" = *RISC-V* || \
"$desc" = *WebAssembly* || \
"$desc" = *Objective-C* || \
"$opt" = *xray* \
]]; then
supp="n"
elif [[ "$opt" = *sanity* ]]; then
supp="h"
else
supp="s"
fi
fi
s=$supp
case $supp in
s) supp="Supported";;
n) supp="Unsupported";;
h) supp="Supported on Host only";;
esac
desc=$(echo "$desc"| sed -e 's:^ *::' -e 's:|:\\|:g')
#echo a=$a
#echo b=$b
#echo opt=$opt
#echo desc=$desc
if [[ "$desc" != "" ]]; then
printf "%s %s\n" "$key" "$s" >>$tmpf
echo '|`'$opt'`|'$supp'|`'$desc'`|'
fi
done