Received: by 2002:ac0:8c9a:0:0:0:0:0 with SMTP id r26csp1021707ima; Fri, 1 Feb 2019 15:00:17 -0800 (PST) X-Google-Smtp-Source: ALg8bN7Wlcd/5GSvNhtapmRtpeFiHaMTFtT3ZE9zj171l1nycS9ngEbcSPrdL6N1hw4ynFzc36FV X-Received: by 2002:a17:902:8f83:: with SMTP id z3mr40469802plo.328.1549062017326; Fri, 01 Feb 2019 15:00:17 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1549062017; cv=none; d=google.com; s=arc-20160816; b=B0xXu4GG8n9EbWaaE9AhRMG3YVaz4RVq9BdGQ0kxjNG04OYwyNjFBkJsAB5w0nM05R tU2/6KjpfhPZqsd/POOM48Tix3+GzflHWOPHpcYjqu/C6ETLYihBtgYwlztpR2LfWfJh 2elXLx1IC/SavTnAV8NKqir1TUCngB7NdG1yH97sVJ5Mwzks8L/qgN2wYTh/3Z+YGIPZ xpkpzkP/zcp/Y6CkteAC3vuxm+Ssuqfq+XQLBkDreGMEDW6zVl+xdH+OHdHFT8scdG1P e5rqJjThog4XWmDFV4GDfi5B5HSv5ovktqD9fCJYBSofKWXa3cigQoumfG6qILATJCDp eQrw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :organization:references:in-reply-to:message-id:subject:cc:to:from :date; bh=Wsfk+r3Qu1dfToHglEZkYyr88z/QEoBML1alqQNxNto=; b=O3c7luWKj+aktF0wwuAosAesb3jDa30TUD5WWVTHqFekQ0fXWuFhmLsrAsxKd8EUlq ASLjpETi7RLIcLgZ/XGr+1CkslrVhFPEOAZ30k1PcB/dWsJJ9fE+4GF3qTVqWOar9k2V 0YxoGrvTTx+CTwbicFfp5+sBiSaS8XVaabEw9+3Va2kVhHO7+XlJqgi7AtiBdBR3BrDM sySQc92TkflMpeyUJosQ+JwdqvbHtuDr2NSoSKNJC1gUPQqZ2n0IM0ckQyjvHsYcEwbC Sy6jSOxNkaLNba74GmlZm8qH0uMDq+L249oM9yAtBa2Wuc2a0F3VUqZ9K7T1nMVRA07/ 5QTQ== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id o14si8006364pgi.134.2019.02.01.15.00.02; Fri, 01 Feb 2019 15:00:17 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726615AbfBAW7h (ORCPT + 99 others); Fri, 1 Feb 2019 17:59:37 -0500 Received: from ms.lwn.net ([45.79.88.28]:33416 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726449AbfBAW7h (ORCPT ); Fri, 1 Feb 2019 17:59:37 -0500 Received: from localhost.localdomain (localhost [127.0.0.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 5AEEC2BD; Fri, 1 Feb 2019 22:59:36 +0000 (UTC) Date: Fri, 1 Feb 2019 15:59:35 -0700 From: Jonathan Corbet To: frowand.list@gmail.com Cc: Matthew Wilcox , Mauro Carvalho Chehab , Mike Rapoport , Joris Gutjahr , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] docs: kernel-doc: update commands to generate man page Message-ID: <20190201155935.169d2e15@lwn.net> In-Reply-To: <1549058079-10582-1-git-send-email-frowand.list@gmail.com> References: <1549058079-10582-1-git-send-email-frowand.list@gmail.com> Organization: LWN.net X-Mailer: Claws Mail 3.17.3 (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, 1 Feb 2019 13:54:39 -0800 frowand.list@gmail.com wrote: > (1) The command to generate man pages is truncated in the pdf version > of the document. Reformat the command into multiple lines to prevent > the truncation. > > (2) Older versions of git do not support all variants of pathspec > syntax. Provide commands to generate man pages for various > alternate syntax. Applied, thanks. (Though it would sure be nice if we could document which versions of the syntax should be used with which versions of git...:) jon