Skip to content

doc: refine gnu/llvm known issues and link them from changelog - #83

Merged
fanghuaqi merged 4 commits into
masterfrom
nuclei/toolchain_doc
Nov 9, 2026
Merged

fanghuaqi merged 4 commits into
masterfrom
nuclei/toolchain_doc

Conversation

@bigmagic123

@bigmagic123 bigmagic123 commented Nov 5, 2026 •

Copy link
Copy Markdown
Contributor
  • Drop the P1 bug mark from the known issue titles, they are known issues/limitations rather than bugs, keep the affected version annotations (2026.10/2025.10/2025.02)
  • Add references to the detailed description issues (#60 sscanf, #61 address 0 ebreak, #62 naked with varargs)
  • Remove the -Wa,-adhlns frame unwind issue entry, refer to the detailed description elsewhere instead
  • Point the changelog top note to the GNU/LLVM Known Issues doc sections, and mention issue Nuclei Tools Known Issues #18 for more bug issues in both gnu and llvm known issues sections

- `Known Issues <https://github.com/riscv-mcu/riscv-gnu-toolchain/issues/18>`_
- GNU Known Issues: :ref:`Known Issues <toolchain_gnu_known_issues>`

- LLVM Known Issues: :ref:`Known Issues <toolchain_llvm_known_issues>`

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

补一下 libncrt 的 链接

Comment thread source/toolchain/gnu/intro.rst Outdated

Access to Address 0 Is Compiled Into ``ebreak``
-----------------------------------------------
Access to Address 0 Is Compiled Into ``ebreak`` (Affects 2026.10/2025.10/2025.02)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

不用在标题里面写,在下面开个引用块,在里面写 影响哪些版本,在哪些版本里面修复

@fanghuaqi

Copy link
Copy Markdown
Member

@bigmagic123 我们这个版本不是新增了一些选项么,把新增的选项注明下是 2026.10增加进去的,然后也删掉了一些选项,删掉的选项也注明下是2026.10删掉的

@fanghuaqi

Copy link
Copy Markdown
Member

@bigmagic123 这个请更新下哈

- Drop the P1 bug mark from the known issue titles, they are known
  issues/limitations rather than bugs, keep the affected version
  annotations (2026.10/2025.10/2025.02)
- Add references to the detailed description issues (#60 sscanf,
  #61 address 0 ebreak, #62 naked with varargs)
- Remove the -Wa,-adhlns frame unwind issue entry, refer to the
  detailed description elsewhere instead
- Point the changelog top note to the GNU/LLVM Known Issues doc
  sections, and mention issue #18 for more bug issues in both
  gnu and llvm known issues sections
- Move the affected/fixed version annotations of the known issues
  from the titles into note blocks below each entry
- Describe the -maddibne/-mno-addibne option lifecycle: added in
  2025.10, removed in 2026.10, replaced by -mautogen-xxlcz
- Add a Nuclei Custom Options section to the llvm intro for the new
  -mautovec-rvv/-mautovec-dsp/-mautogen-xxlcz options (functionality
  not implemented yet, clang only accepts them without errors)
- Link the libncrt 2026.10 known issues (_libncrt_202610_knownissues)
  from the changelog top note
Remove the -dev suffix from the sphinx version/release, and drop the
under development warning banner from the overview introduction page,
since the 2026.10 documentation is now released formally.
Replace the bare known issues link with a structured note, which
points to the all-tools known issues index (nuclei-tool-guide#18)
and the per-component known issues sections of GNU toolchain, LLVM
toolchain and libncrt, following the same pattern as the toolchain
changelog.
@fanghuaqi
fanghuaqi merged commit 88d10cd into master Nov 9, 2026
1 check passed
@fanghuaqi
fanghuaqi deleted the nuclei/toolchain_doc branch November 9, 2026 09:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants