From nobody Sat Jul 29 12:47:24 2023 X-Original-To: doc@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 4RCkmX4tk2z4p4Ty for ; Sat, 29 Jul 2023 12:47:24 +0000 (UTC) (envelope-from bugzilla-noreply@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 4RCkmX1Swdz3hR6 for ; Sat, 29 Jul 2023 12:47:24 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1690634844; 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=bF2+Jzk/oP8Ter5msA08XlaNkkS/XG2iDERUckSBPIA=; b=L/MYmtGpIZKgXtumOvPGyff//Vn7I6M51W3AwpyiSswbA7/rsawxcLLBWSarl43AVKpEpj 07yY3WC832KmHlIuz0FYbViHbn1hH1bwEOn3pYpfuWRXGIX9NFH8qsSpEyjujCUvBZzvTI gohKaDflMmxwuBUgxQ+8y2As0rrY/Xd6APm8N3J29M3oxM306B2yggA9C6R+BMdZLYo1p2 0cOsofeyIS52eYUqetUQctxk8vscwfzpnxNlL7x/Ta/CBvNSxMWoEcFQ+4XwRdDvdZ3bCu y12OdKIzEzDghVEs40HGR4734aQ4BMBRJqnNXyShMK6yX0X7zk6VGoojPPH2Cg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1690634844; a=rsa-sha256; cv=none; b=lIRmKbgnASBPwaWLOqrJ6RM+HC32aa90S3e7K1Vm7w18wEna9HChrjwVzTD7Ugvkoy9tBV zn1e+7/PhDWGrBsu4pJRibyqSvF+R2/vs4iL9xXTiq+2W015Gu2/Plla9M2eLqKvGWF5wl c2oRF+xRPkJpFnwYRN2OJWV0wRx6RysHunI2V6H0rWeH8f9WjwObrEchfi03TV+eI69Chv n1iOZGmYVUnFRA3uiZhhFXWMJCUuuS4t3yR24wG4vCs9GWK9LAZ8UwdQZ6Psf60WhTWXyJ wNo5aXPUIASzvzJuUyCf/QHdNGXWsGFjhd7FA1c4TZD86xB2fibANO9oBG3bLQ== Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (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 4RCkmX0XJSzYBQ for ; Sat, 29 Jul 2023 12:47:24 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 36TClNM1002215 for ; Sat, 29 Jul 2023 12:47:23 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 36TClNLW002214 for doc@FreeBSD.org; Sat, 29 Jul 2023 12:47:23 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 272795] FreeBSD Handbook section 4.5.1 could be better. Date: Sat, 29 Jul 2023 12:47:24 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Website X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Many People X-Bugzilla-Who: bicknell@ufp.org X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: doc@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status bug_severity priority component assigned_to reporter Message-ID: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@freebsd.org MIME-Version: 1.0 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D272795 Bug ID: 272795 Summary: FreeBSD Handbook section 4.5.1 could be better. Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Severity: Affects Many People Priority: --- Component: Website Assignee: doc@FreeBSD.org Reporter: bicknell@ufp.org I gather portsnap has been deprecated and docs updated recently, however th= at has left some confusing bits: 1) Under https://docs.freebsd.org/en/books/handbook/ports/#ports-using, sec= tion 4.5.1: - "use one of the following methods to install it", but then only a single method (git) follows. 2) There is no instruction on what users who previously used portsnap or svn should do to convert to the newly supported git method. If it is as simple= as blow away /usr/ports and check out via git that should be spelled out in a "migrating" section. 3) Perhaps a doc bug, perhaps a feature request: `pkg` defaults to quarterly branches, but does not seem to output which quarterly branch it is on. See example pkg -d output below. git seems to need a specific year + quarter (= e.g. 2023Q2) tag. I'm not seeing a simple programatic way to keep the two in sy= nc. - Maybe the git repo could have a tag "quarterly" like packages do that is moved forward once a quarter so the checkout can always just be of quarterl= y? - Maybe pkg can emit the quarter it is tracking (e.g. new command `pkg quarter`), ideally in the same format that git needs it (e.g. "git clone https://git.FreeBSD.org/ports.git -b `pkg quarter` /usr/ports" would work). - Maybe `pkg update` could have an option in the config file of "keep ports= in sync" where it spawns an update to the ports tree if a quarterly boundary is crossed? - Maybe the daily/weekly/monthly periodic could have a new option of "keep ports and packages in sync" where the periodic script automatically updates= the ports tree to match the pkg quarter. Use case: I prefer to install from packages, but from time to time I need to build a single bit of software from ports either because there is no packag= e or because I need to customize a build time option. I suspect there are many = like me, and today we have to manage two update methods and hope to keep the tre= es in sync. With the new quarterly thing it should be much easier for softwar= e to just do the right thing and not have humans have to run around and remember this stuff. Output below, which quarter is it updating to? I dunno! (From FreeBSD 13.2-RELEASE with pkg-1.19.2.) # pkg -d update DBG(1)[6448]> pkg initialized Updating FreeBSD repository catalogue... DBG(1)[6448]> PkgRepo: verifying update for FreeBSD DBG(1)[6448]> Pkgrepo, begin update of '/var/db/pkg/repo-FreeBSD.sqlite' DBG(1)[6448]> Request to fetch pkg+http://pkg.FreeBSD.org/FreeBSD:13:amd64/quarterly/meta.conf DBG(1)[6448]> opening libfetch fetcher DBG(1)[6448]> Fetch > libfetch: connecting DBG(1)[6448]> Fetch: fetching from: http://pkgmir.geo.freebsd.org/FreeBSD:13:amd64/quarterly/meta.conf with opts "i" DBG(1)[6448]> Request to fetch pkg+http://pkg.FreeBSD.org/FreeBSD:13:amd64/quarterly/packagesite.pkg DBG(1)[6448]> opening libfetch fetcher DBG(1)[6448]> Fetch > libfetch: connecting DBG(1)[6448]> Fetch: fetching from: http://pkgmir.geo.freebsd.org/FreeBSD:13:amd64/quarterly/packagesite.pkg wi= th opts "i" DBG(1)[6448]> Request to fetch pkg+http://pkg.FreeBSD.org/FreeBSD:13:amd64/quarterly/packagesite.txz DBG(1)[6448]> opening libfetch fetcher DBG(1)[6448]> Fetch > libfetch: connecting DBG(1)[6448]> Fetch: fetching from: http://pkgmir.geo.freebsd.org/FreeBSD:13:amd64/quarterly/packagesite.txz wi= th opts "i" FreeBSD repository is up to date. All repositories are up to date. --=20 You are receiving this mail because: You are the assignee for the bug.=