rocm for Debian
---------------

When generating the doc we use: 
ROCM_DOCS_REMOTE_DETAILS="$url,$branch" ;

url=https://github.com/ROCm/rocm
branch=latest

When using non github provider:
 
url=https://salsa.debian.org/rocm/rocm
branch=master

# you need to add some parameter for custom provider in docs/conf.py

cat >> docs/conf.py <<-EOF
# Specify that you are using a custom provider
html_theme_options = {
    "repository_provider": "custom",
    # Common options for rocm_docs_theme and sphinx_book_theme
    "repository_url": "$url",
    "repository_branch": "$branch",
    "path_to_docs": "docs",

    # Specific options for rocm_docs_theme
    "header_name": "ROCm Documentation", # Displayed project name
    "show_version": True, # Display project version
    "show_branch": True, # Display current branch
    "sidebar_main_pages": "index", # Make file for navigation

    # Other options can apply with theme update
}
# The linkcode_resolve function is now handled by the theme
# So you don't need to write one unless you want more custom links
EOF

drwxr-xr-x root/root         0 2025-11-22 00:02 ./
drwxr-xr-x root/root         0 2025-11-22 00:02 ./usr/
drwxr-xr-x root/root         0 2025-11-22 00:02 ./usr/share/
drwxr-xr-x root/root         0 2025-11-22 00:02 ./usr/share/doc/
drwxr-xr-x root/root         0 2025-11-22 00:02 ./usr/share/doc/rocm-dev/
-rw-r--r-- root/root       449 2025-11-22 00:02 ./usr/share/doc/rocm-dev/changelog.Debian.gz
-rw-r--r-- root/root     91371 2025-11-21 23:29 ./usr/share/doc/rocm-dev/changelog.gz
-rw-r--r-- root/root      1367 2025-11-21 23:29 ./usr/share/doc/rocm-dev/copyright

Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: ROCm
Source: https://github.com/ROCm/ROCm

Files: *
Copyright: 2023-2025, Advanced Micro Devices, Inc. All rights reserved.
License: Expat

Files: debian/*
Copyright: 2025 Cordell Bloor <cgmb@debian.org>
License: Expat

License: Expat
 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.

drwxr-xr-x root/root         0 2025-11-22 00:02 ./
drwxr-xr-x root/root         0 2025-11-22 00:02 ./usr/
drwxr-xr-x root/root         0 2025-11-22 00:02 ./usr/libexec/
drwxr-xr-x root/root         0 2025-11-22 00:02 ./usr/libexec/rocm/
drwxr-xr-x root/root         0 2025-11-22 00:02 ./usr/libexec/rocm/rocm-tests/
-rwxr-xr-x root/root      1027 2025-11-21 23:29 ./usr/libexec/rocm/rocm-tests/run-tests
drwxr-xr-x root/root         0 2025-11-22 00:02 ./usr/share/
drwxr-xr-x root/root         0 2025-11-22 00:02 ./usr/share/doc/
drwxr-xr-x root/root         0 2025-11-22 00:02 ./usr/share/doc/rocm-tests/
-rw-r--r-- root/root       449 2025-11-22 00:02 ./usr/share/doc/rocm-tests/changelog.Debian.gz
-rw-r--r-- root/root     91371 2025-11-21 23:29 ./usr/share/doc/rocm-tests/changelog.gz
-rw-r--r-- root/root      1367 2025-11-21 23:29 ./usr/share/doc/rocm-tests/copyright

NOTE: Copyright is the same as rocm-dev (rocm-dev_6.4.3-4~exp1_amd64.deb).

Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: ROCm
Source: https://github.com/ROCm/ROCm

Files: *
Copyright: 2023-2025, Advanced Micro Devices, Inc. All rights reserved.
License: Expat

Files: debian/*
Copyright: 2025 Cordell Bloor <cgmb@debian.org>
License: Expat

License: Expat
 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.