From nobody Tue Jul 15 01:11:33 2025 X-Original-To: bugs@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4bh1Nk0nNsz61h3C for ; Tue, 15 Jul 2025 01:11:34 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R10" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4bh1Nk02MKz3YP5 for ; Tue, 15 Jul 2025 01:11:34 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1752541894; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=vSRFQaHsS4zWm+1nAW5ZDp1ZmYg1xmi4B457487sVH0=; b=XVFdJxekSi90Km0rsB7o+pV4CtTUUk6oup3riyCu29oOIm56Uo8yhC65mwZiV4KdAdlEyT 9DLoSeHkJt7WkvzbW6mOIYjx8MNcgyCqC35GHxO1qHJtork8TbWZDonENf7k0XjaX5OqEk E52i2HkaRIIP03GDkHVuateXxrxflhfiwNWETpG/5OrtTYhaVh/OYyNc7MwYdIvZQCrwKH ywQFsKzqGR3RSANxW/TcndNa/caWRpKgRSnLpFQwh+WwGZg/8UDehDKTL9EU37hXrlDfL6 DDEwDG0InyhRhBfvwS7AxRduzI7q4Cuq1nF7v8RsuBaFZ8D3gZoayvKWrq+q4A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1752541894; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=vSRFQaHsS4zWm+1nAW5ZDp1ZmYg1xmi4B457487sVH0=; b=nLVZhnJ9+sH9Bhywnc2cEGZtQM0Vee2aVq/88n13g2W0l8+MVnLQIeP4lmJqFC+gDYVMvR 9MHNMq4WZcdsa+OgYJ9+RMLk+IPuxsJy4dW+Pvmww17IH2vWuquBXZ2gC2ha8qIVSdzreX MxaydzvfQFHDGDhnYSlHHzHNmWJIFravicX9LapM2WgYQv1BbLtWpAeVNjdho1urypFOxq INDFeBc5y4bxyzY1p3q/N2B/vDoV9Sx6KIn/o5rNcF/pGa3H0AvdesR/GSg4qdnb4aUSfd dQ75Pbly+g2di6ab/YxfK6vkTH74qaIRpAdC9RDMC5Iy8F4HgrU6VJfg+WRhug== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1752541894; a=rsa-sha256; cv=none; b=RcCfLj3mxG2S9wiPc61QzfwVBFhgWRiKb+/3snCy8kplof0BswRqpOy7tYwnzmayUW+uQg ft1d57qcw5OsdbS7YxseHW3GP+AyfDNl/c5NVHHg8FIjoE3owOYlRrP7OxkB3lj4RMSDiA 9kwV1zuw36ZJXNf3PcvBkOVudJXufXU2qN8H3YCREHjSCzHpNUFO3ad9Ydmm4XXX2bXXP1 1uV0M2KSLG1IBQqEO5HQD0xhvz6wCxfK2jYmYBLPvkSVxPbzZIJLrvTWZWDr3q1bml5e4O mBkylAnB5n3qkRSJ4F7/b8fzx7/FOTNB5cYEfBEFNJlssT8NIsAy0V6+5qeMpQ== Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4bh1Nj6lmKz2sS for ; Tue, 15 Jul 2025 01:11:33 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 56F1BXfG085813 for ; Tue, 15 Jul 2025 01:11:33 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 56F1BXPe085812 for bugs@FreeBSD.org; Tue, 15 Jul 2025 01:11:33 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: bugs@FreeBSD.org Subject: [Bug 211948] make(1): various corrections and edits Date: Tue, 15 Jul 2025 01:11:33 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Manual Pages X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Many People X-Bugzilla-Who: ziaee@FreeBSD.org X-Bugzilla-Status: Open X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: bugs@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: Message-ID: In-Reply-To: References: Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="UTF-8" X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Bug reports List-Archive: https://lists.freebsd.org/archives/freebsd-bugs List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-bugs@FreeBSD.org MIME-Version: 1.0 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D211948 --- Comment #4 from Alexander Ziaee --- make(1) is maintained in NetBSD, so improvements need to be made there. Thi= s is a very large and very old manual with a lot of tech debt actually, someone could easily spend a week just cleaning it up from a technical standpoint. > The project doesn't have a standard for American vs British English, Yes it does. The standard is American English. See FDP section 12.2 [0]. Lo= t of layers of docs, so it takes some time to just have a map of where everything is. Normally things for manuals are not in the FDP primer, and there is some conflicting differences between Good Style in the handbook (FDP) and manual pages. > or whether to use single or double quotes. The spec there is to keep it consistent in the specific doc. In manual page= s, the macro for Quoted Literals uses single quotes, so those are preferred for consistency, except in old pages that predate the deprecation of "Dq Li". [0]: https://docs.freebsd.org/en/books/fdp-primer/book/ --=20 You are receiving this mail because: You are the assignee for the bug.=