MOUNTAIN VIEW, Calif., January 15, 2026 — A cornerstone of the Linux operating system, the essential Linux manual pages—often called “man-pages”—are getting a second year of dedicated support, ensuring developers continue to have access to critical documentation directly from the command line.
Sustaining a Vital Resource for Linux Developers
The Linux Foundation is renewing sponsorship for the ongoing maintenance of the Linux manual pages project, led by Alejandro (Alex) Colomar.
- The Linux Foundation is providing a second year of sponsorship for the man-pages project.
- Alejandro (Alex) Colomar leads the project, focusing on improving documentation quality and accessibility.
- Google, Hudson River Trading, and Meta are renewing their financial support.
- Recent improvements include enhanced readability, build system updates, and expanded documentation coverage.
Since 2020, Colomar has been the primary maintainer of these vital resources, which detail system calls, library functions, and other core components of the Linux API. While initially a volunteer effort, sponsorship starting in 2024—from Google, Hudson River Trading, and Meta—has allowed him to dedicate more focused time to improving the man-pages.
Modernizing Documentation for a Complex System
Over the past year, Colomar’s work has yielded significant improvements for developers and maintainers throughout the Linux ecosystem. These enhancements span readability, build processes, and documentation coverage.
Specifically, the SYNOPSIS sections of many pages now feature clearer parameter names and array bounds. Large, complex pages—such as those for fcntl(2), futex(2), and keyctl(2)—have been restructured into more manageable and maintainable units. Updates to the build system simplify packaging for various Linux distributions and introduce new diagnostic checks to identify inconsistencies across pages.
The project has also expanded its documentation to include new information on GCC and Clang attributes, reducing the documentation burden on the LLVM project while providing developers with a better understanding of compiler-specific features. Nearly all recent changes from the POSIX.1-2024 and ISO C23 standards have been documented, with further updates underway.
diffman-git(1), mansect(1), and pdfman(1) assist developers in comparing versions, extracting specific sections, and generating printable documentation. Some of these tools are now included by default in major Linux distributions.Beyond immediate usability, the project is focused on long-term preservation. Documentation now includes guidance for creating PDF books of manual pages, and an ongoing effort is underway to recreate original Unix manuals for comparison with modern APIs.
Colomar’s contributions extend beyond the man-pages themselves. He has submitted patches to groff, the Linux kernel, and GCC, and contributed to improving the spatial memory safety of C through the ISO C Committee, including the addition of the new _Countof() operator, which will continue to evolve.
Collaboration Ensures Long-Term Viability
The man-pages project remains a crucial open documentation resource, providing millions of developers with accurate and accessible information directly from the command line. Continued maintenance is essential for the long-term health of Linux and the broader open-source software community.
