git: d688971744 - main - porters-handbook: Remove shar(1) file submission

From: Muhammad Moinur Rahman <>
Date: Thu, 06 Apr 2023 16:46:03 UTC
The branch main has been updated by bofh:


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:
 .../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
-go to the directory above where the port directory is located, and use `tar` to create the shar archive:
-% 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.