From patchwork Tue Feb 12 09:56:09 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Denton Liu X-Patchwork-Id: 10807563 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 295AB1669 for ; Tue, 12 Feb 2019 09:56:14 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 180AF2B107 for ; Tue, 12 Feb 2019 09:56:14 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 0C0E72B3A7; Tue, 12 Feb 2019 09:56:14 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.0 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id B91292B107 for ; Tue, 12 Feb 2019 09:56:13 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728454AbfBLJ4M (ORCPT ); Tue, 12 Feb 2019 04:56:12 -0500 Received: from mail-pl1-f196.google.com ([209.85.214.196]:39851 "EHLO mail-pl1-f196.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726480AbfBLJ4M (ORCPT ); Tue, 12 Feb 2019 04:56:12 -0500 Received: by mail-pl1-f196.google.com with SMTP id 101so1051586pld.6 for ; Tue, 12 Feb 2019 01:56:12 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to:user-agent; bh=/lNZydNHpdWcdPETe2vNOhGBcXK/RZeXwTWcSDJ7vrw=; b=eraUawqEiCcAmGkFl74Zx5YSJV93yhuxmjKoefLrPrczma5DXZxhqZcFBfPe/jtzJf vCkzADLH5M2OunN0wkfkIvZdEWEabKPH6DlcTfvKTTLu3kNxgN3zap5/DaYYYbNixxgv ReAILtv3ojI59v2z7urvqfPEsSVpx+FyEcG0OSLQkvz3p/CT0lb0p/gYe/GI9g4hUNtW APx5uVFiCtqtWXFqKVEFII4ZqYbnrmda4lI8VV5gSK1U01+e5rSvDzdzY+ETAjHB3wAu 2u9WcKj/RQByLifPfHtQT1Str47dfQ4f7ML5E9YH3HpMAOSYuQiFhV75H90On3UnvkYz R+tg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to:user-agent; bh=/lNZydNHpdWcdPETe2vNOhGBcXK/RZeXwTWcSDJ7vrw=; b=pnoV04vOB9DCaTefdUkFlGOEpktY7PHi21Lcb3nl4GPnPG6xM3lLdEx9Acwi0bOzWG o3xWrLUwWsswOp+t+DJvqUTpY4WHLbcFoV++oiGPWh6+HvRjKAMR6PHsSqm2lwW4FqnY ioRovZBdY6O/YtdKicM3bC0dXeWC+ROO1yNIl2YfW6c23kuCQugV6R6nrDHKYTk/kT5U fI3Hi6k0ByqU+2coY+SPW71c+M9ML7gDuRzyWvrq9vZEsAWv2CVRv8U2shmE2v+lqI49 l8cvW5e2jVfGZeeMbWHTiyvQKbReUyDgsMnQKSPbBbxl80wJ4TK8Rq7RFSdZvUAve9pL 7Vqw== X-Gm-Message-State: AHQUAubHC851SpFYbm8FiWQW3RuRUXxPK6lBPL6zGIMbBgPALK4p2mWK hDvRCXEBplHGInkei58YeiKIxSeI X-Google-Smtp-Source: AHgI3IahNgJg823m4cAYhWBoZm+HRJG4cd9mJEg5J+DDxuFf+whU1YvvrKrJ8fbcBTAg8SNDR7muDw== X-Received: by 2002:a17:902:b681:: with SMTP id c1mr3171297pls.103.1549965371444; Tue, 12 Feb 2019 01:56:11 -0800 (PST) Received: from archbookpro.localdomain (c-73-222-73-77.hsd1.ca.comcast.net. [73.222.73.77]) by smtp.gmail.com with ESMTPSA id h189sm3621966pfb.52.2019.02.12.01.56.10 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 12 Feb 2019 01:56:10 -0800 (PST) Date: Tue, 12 Feb 2019 01:56:09 -0800 From: Denton Liu To: git@vger.kernel.org Cc: pclouds@gmail.com Subject: [PATCH v2 1/3] git-remote.txt: be specific about default behavior Message-ID: <7e7e0dde0495e105bb717418745cc24edd051887.1549965172.git.liu.denton@gmail.com> References: <0b62f65a8016c41b96aa6caead366e1ed9dda333.1549944164.git.liu.denton@gmail.com> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.11.3 (2019-02-01) Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Instead of beating around the bush, we directly specify the subcommand that is called by default when none are provided. This way, a user will know where to look for more information. --- Documentation/git-remote.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/git-remote.txt b/Documentation/git-remote.txt index 0cad37fb81..a2e685818b 100644 --- a/Documentation/git-remote.txt +++ b/Documentation/git-remote.txt @@ -41,8 +41,8 @@ OPTIONS COMMANDS -------- -With no arguments, shows a list of existing remotes. Several -subcommands are available to perform operations on the remotes. +With no arguments, the default command is 'show'. Several subcommands are +available to perform operations on the remotes. 'add':: From patchwork Tue Feb 12 09:56:11 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Denton Liu X-Patchwork-Id: 10807565 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 16CA213B4 for ; Tue, 12 Feb 2019 09:56:17 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 0633B2B107 for ; Tue, 12 Feb 2019 09:56:17 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id EE9882B3A7; Tue, 12 Feb 2019 09:56:16 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.0 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 9E8B22B107 for ; Tue, 12 Feb 2019 09:56:16 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728464AbfBLJ4P (ORCPT ); Tue, 12 Feb 2019 04:56:15 -0500 Received: from mail-pf1-f182.google.com ([209.85.210.182]:39877 "EHLO mail-pf1-f182.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726480AbfBLJ4P (ORCPT ); Tue, 12 Feb 2019 04:56:15 -0500 Received: by mail-pf1-f182.google.com with SMTP id f132so1051662pfa.6 for ; Tue, 12 Feb 2019 01:56:14 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to:user-agent; bh=HRI9dBmXrmuda1KKbAeIPkmU/XwHMdZ/oQ0dQcInFyM=; b=aB3JzSclaLg2O+2tfR18V+9taB3H4qUuCkzB4ZNhQ9vbYx+QjYrEhDja8nUCikcnJ6 Ks85z+enocLMlHKEK3jLDhSVfWk8MaC8crl/2kAeyOqvJN66b1qOrvNw6q/de66IYb8V Nn5otpn+WcUdnoETJ2BikJ4ELRDnKjrNMg9gr1EUgBvnJav6DzHm8daT3OLlwxPeqI58 rwSub4ZedV87NS7k0AwmAwwemEBA0eShU73P4/A4b/EInYuxD+1DSaRmn0lvIn6btFH+ bDqeedeiJYXp/+2GMEfyW4jToQWDGgCZe+f0DjQrjiPtNXy4iD2lngSA9vS5BQGJlZt+ CLiQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to:user-agent; bh=HRI9dBmXrmuda1KKbAeIPkmU/XwHMdZ/oQ0dQcInFyM=; b=DX/rR7woYimfPAXqKvMyUEWn3GKw1COS0Q3i6WwdudHnEIwyoXtt1aCA3mHy7f/l60 SlbMFz7WBhKxmwZyDF1Ib5ulCZOwkmnRONP2mhz5MPy7bt38c3kjgBQ5cYDGQbibpjOU AUM5cWED20+/bJReLjhWRhAxPIeWe3VuVy+ALDd94B3DzdbGqAwkPND14Q8RLEZd2nf/ T5ajrz5eBG9ye8cVrjCAmt1QkpLTgFvT/WOoIN2XFw9WRRBiagHisg9XFI2jYIJFZr0R LxQUw7OOD34iW+6AnrQea/oseFpK05K9OX5SHiXiPGzpdOcUM/gFGIVkneIYhqGrd1jN tHKQ== X-Gm-Message-State: AHQUAuYOx1XcTO/ONFr99ZiMQDt5V948IJfWVnls9ALA3yv7x0fvMbg8 FtkyRJa5fzTV8y/GvduJD8iqobuB X-Google-Smtp-Source: AHgI3IZf3ThCfl9GYwcCcT12Y6xXTFmEem2gggB69Wibc+yUfrw1w9b2kr0eP2vsqU5GAdUZXpCadA== X-Received: by 2002:a63:ea42:: with SMTP id l2mr2756131pgk.213.1549965373706; Tue, 12 Feb 2019 01:56:13 -0800 (PST) Received: from archbookpro.localdomain (c-73-222-73-77.hsd1.ca.comcast.net. [73.222.73.77]) by smtp.gmail.com with ESMTPSA id y21sm17903268pfi.150.2019.02.12.01.56.12 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 12 Feb 2019 01:56:13 -0800 (PST) Date: Tue, 12 Feb 2019 01:56:11 -0800 From: Denton Liu To: git@vger.kernel.org Cc: pclouds@gmail.com Subject: [PATCH v2 2/3] git-submodule.txt: make subcommands underlined Message-ID: References: <0b62f65a8016c41b96aa6caead366e1ed9dda333.1549944164.git.liu.denton@gmail.com> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.11.3 (2019-02-01) Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP In git-remote.txt, the subcommands are underlined. Following that, we also underline the subcommands in git-submodule.txt. --- Documentation/git-submodule.txt | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/Documentation/git-submodule.txt b/Documentation/git-submodule.txt index ba3c4df550..65a952fb96 100644 --- a/Documentation/git-submodule.txt +++ b/Documentation/git-submodule.txt @@ -9,15 +9,15 @@ git-submodule - Initialize, update or inspect submodules SYNOPSIS -------- [verse] -'git submodule' [--quiet] add [] [--] [] -'git submodule' [--quiet] status [--cached] [--recursive] [--] [...] -'git submodule' [--quiet] init [--] [...] -'git submodule' [--quiet] deinit [-f|--force] (--all|[--] ...) -'git submodule' [--quiet] update [] [--] [...] -'git submodule' [--quiet] summary [] [--] [...] -'git submodule' [--quiet] foreach [--recursive] -'git submodule' [--quiet] sync [--recursive] [--] [...] -'git submodule' [--quiet] absorbgitdirs [--] [...] +'git submodule' [--quiet] 'add' [] [--] [] +'git submodule' [--quiet] 'status' [--cached] [--recursive] [--] [...] +'git submodule' [--quiet] 'init' [--] [...] +'git submodule' [--quiet] 'deinit' [-f|--force] (--all|[--] ...) +'git submodule' [--quiet] 'update' [] [--] [...] +'git submodule' [--quiet] 'summary' [] [--] [...] +'git submodule' [--quiet] 'foreach' [--recursive] +'git submodule' [--quiet] 'sync' [--recursive] [--] [...] +'git submodule' [--quiet] 'absorbgitdirs' [--] [...] DESCRIPTION From patchwork Tue Feb 12 09:56:13 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Denton Liu X-Patchwork-Id: 10807567 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 439E113B4 for ; Tue, 12 Feb 2019 09:56:19 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 3385B2B107 for ; Tue, 12 Feb 2019 09:56:19 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 2814A2B3A7; Tue, 12 Feb 2019 09:56:19 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.0 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id C4E242B107 for ; Tue, 12 Feb 2019 09:56:18 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728470AbfBLJ4R (ORCPT ); Tue, 12 Feb 2019 04:56:17 -0500 Received: from mail-pf1-f196.google.com ([209.85.210.196]:42411 "EHLO mail-pf1-f196.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726480AbfBLJ4R (ORCPT ); Tue, 12 Feb 2019 04:56:17 -0500 Received: by mail-pf1-f196.google.com with SMTP id n74so1043882pfi.9 for ; Tue, 12 Feb 2019 01:56:16 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to:user-agent; bh=5Clk+wFX7Wv5eSVRv/iYXBdhhpiY2dDces9vCMo3iIY=; b=CfWlMgIa9Y8nngrY2jYpGAElFeBlkgX3XR6f8BA3dYbSMqc2EeFUqstWabITNCDgL4 V/mpppi9DgflWL3O+CYiWiBuwC96m2blhCEDpMYjT866SdR0n5cOPzVW7AfRgGVtoJ1Y tk47fkaJWoikfLPfIb4CnECprVgP19J+oW9INTvDaaplMyTCtBSW2Tk2fIBvmO0y7kmu aTJqBEDQEs/Wy1L7ZBZlIQocxgUbCNkf6Z5U6Aus/jvit2Iif6Ly06EIDIMppiI0GVzR 1TGfWHzlGcnGObOKxApp/BlFp6mt+73JeSZoLw8HSUskXhkmejketJLzTacVGGMY6wAE 6tFg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to:user-agent; bh=5Clk+wFX7Wv5eSVRv/iYXBdhhpiY2dDces9vCMo3iIY=; b=KeckxqKh8ivp8Y6kQ1UnJ1ynvOpW/g+mP6be3UiA+q+5SvLJhsNy3Ei/3PYSL+eCVs IYFvBJb9bHEAhoa+U9lI+wlx1D/1u8GS3f35fkwKtIJdIk8Ns6qn/KjxRXPVOmc08+b9 pHF/wbey6pCdrlMU7Ef2BPdTDV0eAMZgLkU2gkPvFXS2tX+LHlTMdcJBBcFrluratvD9 NGJstuRb8DPuSwbxyh/nzZGwZdKeS+W5xZ4uMYH1alC3OjmrE4z4gfqvVZi6leCW5Y1J HKbCsreWlu/zedyeFpmyKvm78yNm1C7tgpohg9CpckNwO7h8z1YfQujSckLWMddScyel IFhw== X-Gm-Message-State: AHQUAuaUxiBV1CNro09wL72oITY8+W36qg9Q7u3tZCodXGOD+fOboePS 2qNXw2F5PdNO9rIWrzHX1iiidlWR X-Google-Smtp-Source: AHgI3IZ9gtYsiLwNRnX6CbPwnTd/EsjITSUeEkIjEmM87oh0RJ8W5CkkgoepnB471AWL9MUHLeu7hg== X-Received: by 2002:a65:4049:: with SMTP id h9mr2847620pgp.304.1549965376040; Tue, 12 Feb 2019 01:56:16 -0800 (PST) Received: from archbookpro.localdomain (c-73-222-73-77.hsd1.ca.comcast.net. [73.222.73.77]) by smtp.gmail.com with ESMTPSA id y21sm17903491pfi.150.2019.02.12.01.56.15 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 12 Feb 2019 01:56:15 -0800 (PST) Date: Tue, 12 Feb 2019 01:56:13 -0800 From: Denton Liu To: git@vger.kernel.org Cc: pclouds@gmail.com Subject: [PATCH v2 3/3] submodule: document default behavior Message-ID: References: <0b62f65a8016c41b96aa6caead366e1ed9dda333.1549944164.git.liu.denton@gmail.com> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.11.3 (2019-02-01) Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP This patch documents the default behavior of submodule if no subcommands are given, similar to how remote documents it in both git-remote.txt and in its usage output. Signed-off-by: Denton Liu --- Documentation/git-submodule.txt | 4 ++++ git-submodule.sh | 3 ++- 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/Documentation/git-submodule.txt b/Documentation/git-submodule.txt index 65a952fb96..2fdf9f4cf3 100644 --- a/Documentation/git-submodule.txt +++ b/Documentation/git-submodule.txt @@ -9,6 +9,7 @@ git-submodule - Initialize, update or inspect submodules SYNOPSIS -------- [verse] +'git submodule' [--quiet] [--cached] 'git submodule' [--quiet] 'add' [] [--] [] 'git submodule' [--quiet] 'status' [--cached] [--recursive] [--] [...] 'git submodule' [--quiet] 'init' [--] [...] @@ -28,6 +29,9 @@ For more information about submodules, see linkgit:gitsubmodules[7]. COMMANDS -------- +With no arguments, the default command is 'status'. Several subcommands are +available to perform operations on the submodules. + add [-b ] [-f|--force] [--name ] [--reference ] [--depth ] [--] []:: Add the given repository as a submodule at the given path to the changeset to be committed next to the current diff --git a/git-submodule.sh b/git-submodule.sh index 5e608f8bad..1ccc758e79 100755 --- a/git-submodule.sh +++ b/git-submodule.sh @@ -5,7 +5,8 @@ # Copyright (c) 2007 Lars Hjemli dashless=$(basename "$0" | sed -e 's/-/ /') -USAGE="[--quiet] add [-b ] [-f|--force] [--name ] [--reference ] [--] [] +USAGE="[--quiet] [--cached] + or: $dashless [--quiet] add [-b ] [-f|--force] [--name ] [--reference ] [--] [] or: $dashless [--quiet] status [--cached] [--recursive] [--] [...] or: $dashless [--quiet] init [--] [...] or: $dashless [--quiet] deinit [-f|--force] (--all| [--] ...)