b47530b9fe
This allows the `acid` debugger on plan9 to be used to debug a zig source file without patching `acid`! The patch adds a second `z` symbol. This z symbol has a value of 0, which means that it pops the history stack. We put a very large number for the value of the second symbol because it has to be at least as large as the linecount of the file. The debuginfo format is meant to be used with c files, where the stack would look something like this: ``` -> Line: 0x1 (1) Name: 0x1/0x2/0x3/0xe/0x13/0x1b (/sys/src/libc/port/malloc.c) -> Line: 0x2 (2) Name: 0x1/0x6/0x7/0x8 (/amd64/include/u.h) -> Line: 0x4f (79) Name: () -> Line: 0x50 (80) Name: 0x1/0x2/0x7/0x9 (/sys/include/libc.h) -> Line: 0x358 (856) Name: () -> Line: 0x359 (857) Name: 0x1/0x2/0x7/0x1c (/sys/include/pool.h) -> Line: 0x392 (914) Name: () -> Line: 0x393 (915) Name: 0x1/0x2/0x7/0x1d (/sys/include/tos.h) -> Line: 0x3ab (939) Name: () -> Line: 0x4eb (1259) Name: () ``` however in zig, we do not use includes and .h files, so we only need the first and last items in the stack: the source file that the symbols belong to, and the pop symbol with a null name and a value of the total linecount of the preprocessed source. Since there is no preprocessing in zig, we just make the linecount very large. There do not appear to be any downsides to this approach. If this causes a bug in the future, a simple fix would be to make the pop symbol just have the value of how many newlines are in the source file.
A general-purpose programming language and toolchain for maintaining robust, optimal, and reusable software.
Resources
- Introduction
- Download & Documentation
- Chapter 0 - Getting Started | ZigLearn.org
- Community
- Contributing
- Code of Conduct
- Frequently Asked Questions
- Community Projects
Installation
- download a pre-built binary
- install from a package manager
- build from source
- bootstrap zig for any target
License
The ultimate goal of the Zig project is to serve users. As a first-order effect, this means users of the compiler, helping programmers to write better software. Even more important, however, are the end-users.
Zig is intended to be used to help end-users accomplish their goals. Zig should be used to empower end-users, never to exploit them financially, or to limit their freedom to interact with hardware or software in any way.
However, such problems are best solved with social norms, not with software licenses. Any attempt to complicate the software license of Zig would risk compromising the value Zig provides.
Therefore, Zig is available under the MIT (Expat) License, and comes with a humble request: use it to make software better serve the needs of end-users.
This project redistributes code from other projects, some of which have other licenses besides MIT. Such licenses are generally similar to the MIT license for practical purposes. See the subdirectories and files inside lib/ for more details.