GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — Bug: macOS build instructions use unavailable `nproc` command · Issue #1959 · python/devguide

Bug: macOS build instructions use unavailable nproc command #1959

New issue
Copy link
New issue
Copy link
Open
#1964
Open
Bug: macOS build instructions use unavailable nproc command#1959
#1964
Copy link
Labels
type-bugEditing of existing content neededEditing of existing content needed

Description

@lokeshsahu2804-korba
lokeshsahu2804-korba
opened on Nov 3, 2026
Issue body actions

Describe the bug

Problem

The CPython Developer's Guide currently instructs contributors to compile CPython using the following command in getting-started/setup-building.rst, under the Unix build instructions:

make -s -j $(nproc)

However, nproc is a GNU coreutils utility that is not available by default on macOS.

When a contributor follows these instructions on a standard macOS installation, the shell reports:

zsh: command not found: nproc

As a result, the command substitution produces an empty string, effectively executing:

make -s -j

Without an explicit job count, GNU Make allows unlimited parallel jobs. This can result in excessive resource consumption during compilation.

Expected Behaviour

The build instructions should provide a macOS-compatible command that determines the available logical CPU count without requiring additional utilities.

Proposed Solution

Introduce separate Unix and macOS tabs for the compilation command, following the existing documentation conventions in:

  • getting-started/quick-reference.rst
  • development-tools/sanitizers.rst

Keep the existing Unix command:

make -s -j $(nproc)

For macOS, use:

make -s -j $(sysctl -n hw.logicalcpu)

This would allow macOS contributors to build CPython using the available logical CPU count without installing GNU coreutils.

Additional Context

A similar macOS compatibility issue was previously addressed in PR #1545, where nproc was replaced with a fixed job count in another section of the documentation.

However, the primary compilation instructions still contain the incompatible command.

This issue proposes applying the existing macOS-specific approach consistently to the main build instructions.

Screenshots

No response

Additional context

No response

Activity

  1. lokeshsahu2804-korba
    added
    type-bugEditing of existing content neededEditing of existing content needed
    on Nov 3, 2026
  2. lokeshsahu2804-korba commented on Nov 4, 2026

    @lokeshsahu2804-korba
    lokeshsahu2804-korba
    on Nov 4, 2026
    Author
    More actions

    Thanks to everyone who has worked on this issue.

    I noticed that PR #1964 is currently under review. I'm also interested in contributing a fix for this issue and would be happy to take it forward if the current PR becomes inactive or if an alternative implementation is needed.

    I'll avoid submitting a duplicate PR while #1964 is being reviewed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    type-bugEditing of existing content neededEditing of existing content needed

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      You are visitor 01402503 — GeezerVison does not store the pages you look up.
      Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.