From owner-freebsd-ports@freebsd.org Wed Apr 28 18:59:22 2021 Return-Path: Delivered-To: freebsd-ports@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id ACF255FDAD3 for ; Wed, 28 Apr 2021 18:59:22 +0000 (UTC) (envelope-from portmaster@bsdforge.com) Received: from udns.ultimatedns.net (static-24-113-41-81.wavecable.com [24.113.41.81]) (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 "ultimatedns.net", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FVnx63F5Zz3FJ5; Wed, 28 Apr 2021 18:59:21 +0000 (UTC) (envelope-from portmaster@bsdforge.com) Received: from ultimatedns.net (localhost [127.0.0.1]) by udns.ultimatedns.net (8.16.1/8.16.1) with ESMTP id 13SIxXN9092140; Wed, 28 Apr 2021 11:59:40 -0700 (PDT) (envelope-from portmaster@bsdforge.com) MIME-Version: 1.0 Date: Wed, 28 Apr 2021 11:59:33 -0700 From: Chris To: Li-Wen Hsu Cc: Kurt Jaeger , freebsd-ports Subject: Re: When will git be supported for ports? In-Reply-To: References: <08eb32f6fb033f8590a6f2b181436119@bsdforge.com> User-Agent: UDNSMS/17.0 Message-ID: X-Sender: portmaster@bsdforge.com Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit X-Rspamd-Queue-Id: 4FVnx63F5Zz3FJ5 X-Spamd-Bar: ---- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[] X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 28 Apr 2021 18:59:22 -0000 On 2021-04-28 11:25, Li-Wen Hsu wrote: > On Thu, Apr 29, 2021 at 2:15 AM Kurt Jaeger wrote: >> >> Hi! >> >> > Maintainer for some ~160 ports, and attempting to fix some >> > bugs. But as I understand it 'git' is supposed to be the new >> > source of truth. While I know svn by heart. I have near zero >> > understanding of git, or for that matter, why anyone would >> > rather use it. >> >> The 'why' was explained here: >> >> https://github.com/bsdimp/freebsd-git-docs/ >> >> But, unfortunatly, that text moved somewhere. It's a good >> first test to find out how to recover that text from the git repo 8} >> Any hints ? > > That was a draft repository used before the document migrated to use > AsciiDoc. > > In the README of that repository: > > """ > These changes have been pushed into the FreeBSD tree. See the committer’s > guide. > https://docs.freebsd.org/en/articles/committers-guide/#git-primer > """ > >> > That said; as I try to discover the new >> > procedures for maintaining ports under git. I see there isn't >> > anything in the porters-handbook regarding the acquisition >> > of the ports tree in order to get started. > > I guess that was because the porter's handbook was mainly about > porting, like writing the Makefile and pkg-plist. The VCS thing was > mainly in the committer's guide. But it's nice to mention some simple > git usages which will help people submit patches. After all that's one > of the reasons and possible benefit to use git. A HUGE thank you for your reply. I know this probably seems simplistic. But in order to get involved with ports, you're going to need a ports tree. Not everyone who starts using FreeBSD will have a source tree, or even build from source. So getting the ports tree as a necessary first step IMHO should be noted. As everyone seems to be telling everyone the proper git workflow, and they all vary. Maybe FreeBSD might show a 'ports git workflow'. Much the same as the build/install world/kernel workflow in /src/UPDATING at the top of the porters-handbook? It's not that I don't know how to 'git clone'. It's that there's a preferred procedure/protocol to becoming/being a FreeBSD ports Maintainer, and I simply want to get it right the first time. Thereby saving committers a good deal of time and effort. ;-) Thanks again! :-) --Chris > >> > Shouldn't this be at the very beginning of the ports doc? >> >> This below should work, and I agree with you: It was hard to find out. >> >> mkdir -p somedir/ports >> cd somedir >> git clone -o freebsd \ >> --config remote.freebsd.fetch='+refs/notes/*:refs/notes/*' \ >> https://git.freebsd.org/ports.git ports >> >> I'm also trying to learn more git to be able to work on the >> ports tree, but my time is limited and somehow, I still do >> not see the forest for the trees 8-(