Date: Thu, 6 Apr 2023 16:46:03 GMT From: Muhammad Moinur Rahman <bofh@FreeBSD.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Subject: git: d688971744 - main - porters-handbook: Remove shar(1) file submission Message-ID: <202304061646.336Gk3v5079115@gitrepo.freebsd.org>
next in thread | raw e-mail | index | archive | help
The branch main has been updated by bofh: URL: https://cgit.FreeBSD.org/doc/commit/?id=d68897174497dee7e594e8118a5aec50c3ddfc70 commit d68897174497dee7e594e8118a5aec50c3ddfc70 Author: Muhammad Moinur Rahman <bofh@FreeBSD.org> AuthorDate: 2023-04-06 16:44:43 +0000 Commit: Muhammad Moinur Rahman <bofh@FreeBSD.org> 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.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202304061646.336Gk3v5079115>