ziglang/zig

Fork 771

Code Issues 706 Pull requests 291 Activity Actions 25

autodoc claims functions available in `std.leb128` when they are actually only available in `std.leb` #31123

New issue

Open

opened 2026年02月05日 04:22:32 +01:00 by mark-rushakoff · 1 comment

mark-rushakoff commented

2026年02月05日 04:22:32 +01:00

Copy link

Zig Version

0.15.2, master

Steps to Reproduce and Observed Behavior

https://ziglang.org/documentation/master/std/#std.leb128
https://ziglang.org/documentation/0.15.2/std/#std.leb128

My code needed to read a uleb128, so I found std.leb128.readUleb128 in the standard library in my project using 0.15.2.

Upon trying to call std.leb128.readUleb128 I got the compile error root source file struct 'std' has no member named 'leb128'. Changing it to std.leb.readUleb128 works.

I would guess this has something to do with lib/std/std.zig's assignment pub const leb = @import("leb128.zig"); where the name of the constant is different from the filename.

This is mentioned in the issue comment at https://github.com/ziglang/zig/issues/17334#issuecomment-2156206541 but I'm not sure if that issue is actually focused on this general problem or something else.

Expected Behavior

Expected the namespace at the top of the docs page to match compilable code.

### Zig Version 0.15.2, master ### Steps to Reproduce and Observed Behavior https://ziglang.org/documentation/master/std/#std.leb128 https://ziglang.org/documentation/0.15.2/std/#std.leb128 My code needed to read a uleb128, so I found `std.leb128.readUleb128` in the standard library in my project using 0.15.2. Upon trying to call `std.leb128.readUleb128` I got the compile error `root source file struct 'std' has no member named 'leb128'`. Changing it to `std.leb.readUleb128` works. I would guess this has something to do with `lib/std/std.zig`'s assignment `pub const leb = @import("leb128.zig");` where the name of the constant is different from the filename. This is mentioned in the issue comment at https://github.com/ziglang/zig/issues/17334#issuecomment-2156206541 but I'm not sure if that issue is actually focused on this general problem or something else. ### Expected Behavior Expected the namespace at the top of the docs page to match compilable code.

mark-rushakoff added the

bug

label

2026年02月05日 04:22:49 +01:00

nektro commented

2026年02月05日 09:44:40 +01:00

Contributor

Copy link

this is a known behavior and happening because the file is at /lib/std/leb128.zig
dupe of https://github.com/ziglang/zig/issues/19262

this is a known behavior and happening because the file is at `/lib/std/leb128.zig` dupe of https://github.com/ziglang/zig/issues/19262

alexrp added the

autodoc

label

2026年02月05日 17:51:19 +01:00

No Branch/Tag specified

Branches Tags

master

elfv2

spork8

restricted

0.16.x

panic-rewrite

parking-futex-lockfree

windows-Io-cleanup

Io-watch

ParseCommandLineOptions

windows-async-files

poll-ring

debug-file-leaks-differently

debug-file-leaks

ProcessPrng

elfv2-dyn

jobserver

threadtheft

io-threaded-no-queue

0.15.x

Io.net

comptime-allocator

restricted-function-pointers

cli

wasm-linker-writer

wrangle-writer-buffering

sha1-stream

async-await-demo

fixes

0.14.x

ast-node-methods

macos-debug-info

make-vs-configure

fuzz-macos

sans-aro

ArrayList-reserve

incr-bug

llvm-ir-nosanitize-metadata

ci-tarballs

ci-scripts

threadpool

0.12.x

new-pkg-hash

json-diagnostics

more-doctests

rework-comptime-mutation

0.11.x

ci-perf-comment

stage2-async

0.10.x

autofix

0.9.x

aro

hcs

0.8.x

0.7.x

Labels

Clear labels

This proposal is planned.

The web application for interactive documentation and generation of its assets.

backend/c

The C backend outputs C source code.

backend/llvm

The LLVM backend outputs an LLVM bitcode module.

backend/self-hosted

The self-hosted backends produce machine code directly.

binutils

Zig's included binary utilities: zig ar, zig dlltool, zig lib, zig ranlib, zig objcopy, and zig rc.

breaking

Implementing this issue could cause existing code to no longer compile or have different behavior.

build system

The Zig build system - zig build, std.Build, the build runner, and package management.

debug info

docs

An issue with documentation, e.g. the language reference or standard library doc comments.

error message

This issue points out an error message that is unhelpful and should be improved.

frontend

Tokenization, parsing, AstGen, ZonGen, Sema, Legalize, and Liveness.

fuzzing

incremental

Reuse of internal compiler state for faster compilation.

lib/c

This issue relates to Zig's libc implementation and/or vendored libcs.

lib/compiler-rt

This issue relates to Zig's compiler-rt library.

lib/cxx

This issue relates to Zig's vendored libc++ and/or libc++abi.

lib/std

This issue relates to Zig's standard library.

lib/tsan

This issue relates to Zig's vendored libtsan.

lib/ubsan-rt

This issue relates to Zig's ubsan-rt library.

lib/unwind

This issue relates to Zig's vendored libunwind.

linking

Zig's integrated object file and incremental linker.

miscompilation

The compiler reports success but produces semantically incorrect code.

This issue suggests language modifications. If it also has the "accepted" label then it is planned.

release notes

This issue or pull request should be mentioned in the release notes.

testing

This issue is related to testing the compiler, standard library, or other parts of Zig.

zig cc

Zig as a drop-in C-family compiler.

zig fmt

The Zig source code formatter.

zig reduce

The Zig source code reduction tool.

bounty

https://ziglang.org/news/announcing-donor-bounties

bug

Observed behavior contradicts documented or intended behavior.

contributor-friendly

This issue is limited in scope and/or knowledge of project internals.

downstream

An issue with a third-party project that uses this project.

enhancement

Solving this issue will likely involve adding new logic or components to the codebase.

infra

optimization

A task to improve performance and/or resource usage.

question

No questions on the issue tracker; use a community space instead.

regression

Something that used to work in a previous version stopped working

upstream

An issue with a third-party project that this project uses.

use case

Describes a real use case that is difficult or impossible, but does not propose a solution.

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

2 participants

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

ziglang/zig#31123

No description provided.

Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?

autodoc claims functions available in std.leb128 when they are actually only available in std.leb #31123

Zig Version

Steps to Reproduce and Observed Behavior

Expected Behavior

autodoc claims functions available in `std.leb128` when they are actually only available in `std.leb` #31123