From nobody Thu Apr 6 16:46:03 2023 X-Original-To: dev-commits-doc-all@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 4PsnSW6mDDz44ZM8 for ; Thu, 6 Apr 2023 16:46:03 +0000 (UTC) (envelope-from git@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 "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4PsnSW3YdHz3qK6; Thu, 6 Apr 2023 16:46:03 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1680799563; 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; bh=+rWFfQ4wvmgvuh92qjpM6E97uqbdbj6GN9kc3Pb4OIY=; b=yvx8gWhuc5K37C6Jux4bM1Oyg5TvgNt46nLVsq9O8QDKedFkqL8zR3t5O71+TT9pKfg206 GizqfzC+hWAJL0wObzApSZH+zWVlceT/fG6B2A4tmmBnh4lbz1xfr9xjFlalcntM3jZsU4 PskQcrj9zZK0ltQobFCyz9kR5XcM3M499f1+oVMPVPC7OjuOQqsLochTTM2LO1355t1hyT 8SXJvEITA/kJgPC37EH9mZWiM9deVITf85q1wJEDzYb5viFpXM/JlZ3stQPJrFidSh0aI8 ADbyMXGlqZmySLj1cN/1kY5tCD4fkk0fED+zWvXIv/wKkl27W102uPvzpOwriw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1680799563; 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; bh=+rWFfQ4wvmgvuh92qjpM6E97uqbdbj6GN9kc3Pb4OIY=; b=P1BMKcCIThOkzMXul36PcGknXIzmrvDrvM1f0d7MxnWA6+YkC8yiHC+oABT/k1sVwrc54R XRD2BlLz+LgfX/kvYRFlBgY8HJlvnpNonPpfH3jZFYtfVvlhHMwr0PpPunVJPcJShrty69 UL+vLXvYpfxsjurUsLSlFNlL36DRkFGXOGBEoay5TSCtJ9z3UylT0lfvRXCRHKt25jzHoc lPyE+feG/3Nmg1Ui5ZBJNfR6zkqV+2gsVOdReZoEm0K1C+tMmN6TBsTz4qMyGDyvEdhNVm DpYWTwGuhrFrN1aWY/ixQBzynJ3qqI7VWV3SyVaAP4jY5IGrakh5spP4WoEIqQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1680799563; a=rsa-sha256; cv=none; b=U0xBlv1oGEgMJhFO9T4WT1c5Mcy7ggl/MDXbAzcjcr+CSngaLDVJ/LlDP1lSmQiCZ5Wri/ EY/P4NVrx2y3ISpHpIZ50fkURnWcNUuW2S0vCzhmcOmKZOqL5DQxRRcrf+m7TmbLmRIInb aVbZd9M+/Vbs7WMeSATmMchzJpeN2p+1+ZZNfWfW/94fgXzgXEDgOXN0J73PQ3/yIZydSY 6G0N+KpQPcCbAEk3EU1CXcr39ERxsA63Pl7n4zi0fKw5UCKKoRvJshdzUlkre90YU9tHdh H/uJxmk0NDBSv7K2AX1MUH5fO+aHcbyEPqC4NFa87IqOpY7KfreTUjd3MjPaWg== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 4PsnSW2TPnz1B2Q; Thu, 6 Apr 2023 16:46:03 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 336Gk3GP079116; Thu, 6 Apr 2023 16:46:03 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 336Gk3v5079115; Thu, 6 Apr 2023 16:46:03 GMT (envelope-from git) Date: Thu, 6 Apr 2023 16:46:03 GMT Message-Id: <202304061646.336Gk3v5079115@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Muhammad Moinur Rahman Subject: git: d688971744 - main - porters-handbook: Remove shar(1) file submission List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bofh X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: d68897174497dee7e594e8118a5aec50c3ddfc70 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by bofh: URL: https://cgit.FreeBSD.org/doc/commit/?id=d68897174497dee7e594e8118a5aec50c3ddfc70 commit d68897174497dee7e594e8118a5aec50c3ddfc70 Author: Muhammad Moinur Rahman AuthorDate: 2023-04-06 16:44:43 +0000 Commit: Muhammad Moinur Rahman CommitDate: 2023-04-06 16:45:55 +0000 porters-handbook: Remove shar(1) file submission In contrast to the evolution of git there is no point in entertaining shar files anymore. It was a good solution during the days of cvs/svn but with git workflow this is counter productive for committers and often the cause of INDEX break as the committers forget to add in the relevant categories Makefile. Approved by: carlavilla(mentor) portmgr Differential Revision: https://reviews.freebsd.org/D39425 --- .../books/porters-handbook/quick-porting/_index.adoc | 18 +++--------------- 1 file changed, 3 insertions(+), 15 deletions(-) diff --git a/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc b/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc index b296b2bdcd..ac331adb2b 100644 --- a/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc +++ b/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc @@ -308,20 +308,8 @@ To get a listing of _open_ port PRs, select _Open_ and _Ports & Packages_ in the After looking at the new port, we will reply if necessary, and commit it to the tree. The submitter's name will also be added to the list of extref:{contributors}[Additional FreeBSD Contributors, contrib-additional] and other files. -It is also possible to submit ports using a man:shar[1] file. -Using the previous example with the `oneko` port above. - -.Creating a [.filename]#.shar# for a New Port -[[porting-submitting-shar]] -[example] +[IMPORTANT] ==== -go to the directory above where the port directory is located, and use `tar` to create the shar archive: - -[source,shell] -.... -% cd .. -% tar cf oneko.shar --format shar oneko -.... +In previous it was possible to submit patches for new ports using man:shar[1] file which is no longer the case with the evolution of man:git[1]. +Committers no longer entertain man:shar[1] files as it is prone to mistake and does not add the relevant entry in the categories [.filename]#Makefile#. ==== - -[.filename]#oneko.shar# can then be submitted in the same way as [.filename]#oneko.diff# above.