From nobody Sun Feb 8 03:27:19 2026 Received: from mail-wr1-f48.google.com (mail-wr1-f48.google.com [209.85.221.48]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id D3A1748CFC for ; Sat, 27 Dec 2025 12:55:46 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.48 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1766840148; cv=none; b=clmGPQM7lz9oJAZz5j+iAB2xOcveejwql8kMvB+eqLOJVuQwZqcfRZmD6VYTnt+sECxhxhGW0yg5soTW2mjX/bqlDJnOJI8+zcUTARHRL1QwB+S/zzQeTZUTWG8GXpaPY+tEu9EQjIdjPvvxpXHlExVFRerMpChkCskKUr8eCpo= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1766840148; c=relaxed/simple; bh=a4t4aeiqwYHeKbZFJ8E2uM1R3FbuCHOHNu2himfx/x8=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=q9ZWtJJfu9VvcpJZKBk6ZNNbrTaU51XlC8CcmWcqB5qh+ZjjEFCz6vcJXvjxK+tkS+aDfyOLTxP8k8zaRLjzJlmMzvJ0Aunb8opqLHKtUHoGQzxOElTr0eCn7Tx/bg1Qms021LxdtwmTI+ZuzpsFp+OcTYiIjoEmOm5cb3lQ1eM= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=BytbE5zc; arc=none smtp.client-ip=209.85.221.48 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="BytbE5zc" Received: by mail-wr1-f48.google.com with SMTP id ffacd0b85a97d-431048c4068so4265387f8f.1 for ; Sat, 27 Dec 2025 04:55:46 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1766840145; x=1767444945; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=IueLC0I+lVb6Qbt0ks5icQeQ9Cq2EAoaOypYMEZKv38=; b=BytbE5zcx7GlUJxEUUrRow+nwWkkQZcIP1f7Q4I49nNo+c2uqvB/HGqq9UXPF7mNqq mgNERIjkdFqT0OJjpH+zK0aej+adN0c+onGAENwDFnt2gU+dKmjDSuvN43K0U6EjPBIY YsvaPbgXwJAucRDCnlKYTNU6x84MekT4h+bJgA9D2+yhLQw9pf06X6EoPn1ot2CLQtln /hZ4AW658w/6PWVHGj+/baE660ZDrp4+TOprxOhyXM+nF3saANxWt8N2YINiKxFBUq3W ac3J/0CtHD4k1k30MpHIM3Ots/aK6FhhXPaaUdA1/idmiA2kTJPvxKyUWX3BTTBFEhnO DOTg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1766840145; x=1767444945; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=IueLC0I+lVb6Qbt0ks5icQeQ9Cq2EAoaOypYMEZKv38=; b=YGtopYux7D3qDVlAatAstvet5hP7X3b76sPBoY+sazdxiYF+XnxaycnL3FKUzEU+b6 hPqf3HTgCWT2TNfQIPIQyP8e2OOmw8aJJpNRBEDkueIdhE7KJn6F7oyFflEJNyWEKMAh B2X7cxfKh2btXCwUeceMufEi+Zd8yS3qsooT4uIh30q7C0qtABAX1Zztwlm84t4JbtDf +7s8+D6hOVYB9/YSHWS1eyu92xcZXxtvYB+LgZoiu908aEEgLy02W1cBcVJN/TQi5cAj 6QkMrporbVZbkbCWhWQX7DdaA2p2otD1hAiZ9Y0oTTMFksULDKzMAql+8/GMBWr9B8QC aLyw== X-Forwarded-Encrypted: i=1; AJvYcCU9wT26WQ0qr5KiVmFTd2oMYsioqkx2o768OnHxqvQ0G81XNIxXMu7qiqxI0c9mOnPufbsled+8dZQddOc=@vger.kernel.org X-Gm-Message-State: AOJu0YwLhdw/NF2fg/YKcBB4ke1vbs71h832ytyoJzeSHMujBELK3yKs Pgn3cVPNHIYRdqdj3RcFeTNH34+9iWHGjXCQWZ1b9ixKjYMFc1c/MjZh X-Gm-Gg: AY/fxX42ZYYc0FxQySGAvVEJ3tRR7QRvLXSMf7FBj+iV6D99pGELOY0a16MKnsnH36q 0JKmGEozYy2AxSUo5wqDQeDYcM9l+Wq5Rrx0/K3qHlDN1kiEbGyvjF2OtK0L8hLal5qAEibdAL7 MNUVRiXz8YEHD7DPqLoHTp7NHfcdSjPUbCquq+1gNRpKzI7CylN9GmPKgPeXow4TqNKTnDV/gTH 70UvEUsf2hNXK+E2XYutU1qP6N2nEQxSP3U13RKt4v1Tzt8DZQV+0EDdIgBOcEna/c9N3Rxe0aK 90yUPFE8FG1Qb+JH2qdndGXXMhMDBVuNpiC5zKYlNxQkDbh9D3gxRSGi46A7pXmlEyL18Q+7nlj CEc0O+aMyPx1+vDP32ulkAi2SK8wDdRl6c6vysM9R5kwuTkXgvjOqlZ+m/mBmpnB31Odv1hv3nd SW0JmZmiBU67ML/5D6DkmhuCQd6yQby6Ns X-Google-Smtp-Source: AGHT+IHOEk0Ola8X6xsiCBhyLaJzjrT5S0J18Qc0O5jnYcRHADmYVvfpoRPXZ5oRkSUp1TvFis0x5A== X-Received: by 2002:a05:6000:2dc1:b0:430:f3bd:720a with SMTP id ffacd0b85a97d-432448ca08emr34327091f8f.27.1766840144987; Sat, 27 Dec 2025 04:55:44 -0800 (PST) Received: from localhost.localdomain ([188.51.201.184]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-4324ea830f3sm49548534f8f.22.2025.12.27.04.55.43 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 27 Dec 2025 04:55:44 -0800 (PST) From: mustafaelrasheid@gmail.com To: Randy Dunlap Cc: Jonathan Corbet , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Mustafa Elrasheid Subject: [PATCH v3] docs: Makefile: wrap SPHINXDIRS help text Date: Sat, 27 Dec 2025 15:52:44 +0300 Message-Id: <20251227125244.6407-1-mustafaelrasheid@gmail.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <88fe4b63-13cd-47ce-8408-1e9d6f947b3a@infradead.org> References: <88fe4b63-13cd-47ce-8408-1e9d6f947b3a@infradead.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" From: Mustafa Elrasheid When using `make help`, SPHINXDIR doesn't wrap around 80 characters, causing text to overflow or wrap in incorrect ways, which then makes the text difficult to read Signed-off-by: Mustafa Elrasheid Acked-by: Randy Dunlap Tested-by: Randy Dunlap --- v3: - Moved SPHINXDIRS to a new line for better readability - Added `-g 75` to increase the goal of fmt instead of 93% of `-w 75` v2: - Added '-s' in fmt to prevent word segmenting at the end of lines. - Reduced width in `fmt -w` to account for the added indentation of `sed` Documentation/Makefile | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Documentation/Makefile b/Documentation/Makefile index e96ac6dcac4f..377a449656c8 100644 --- a/Documentation/Makefile +++ b/Documentation/Makefile @@ -98,7 +98,8 @@ dochelp: @echo ' cleandocs - clean all generated files' @echo @echo ' make SPHINXDIRS=3D"s1 s2" [target] Generate only docs of folder= s1, s2' - @echo ' top level values for SPHINXDIRS are: $(_SPHINXDIRS)' + @echo ' top level values for SPHINXDIRS are:' + @echo '$(_SPHINXDIRS)' | fmt -s -w 75 -g 75 | sed 's/^/ /' @echo ' you may also use a subdirectory like SPHINXDIRS=3Duserspace-api= /media,' @echo ' provided that there is an index.rst file at the subdirectory.' @echo --=20 2.39.5