From nobody Wed Jul 1 22:15:36 2026 X-Original-To: freebsd-pkgbase@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 4grDqQ3Dthz6kjk3 for ; Wed, 01 Jul 2026 22:15:46 +0000 (UTC) (envelope-from marklmi@yahoo.com) Received: from sonic303-25.consmr.mail.gq1.yahoo.com (sonic303-25.consmr.mail.gq1.yahoo.com [98.137.64.206]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 4grDqP5hWZz3NQD for ; Wed, 01 Jul 2026 22:15:45 +0000 (UTC) (envelope-from marklmi@yahoo.com) Authentication-Results: mx1.freebsd.org; none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1782944140; bh=lPHCK5gqebusVQ6UIn0Au1zgU00z1Fb93We1nB03JQE=; h=Date:Subject:To:Cc:References:From:In-Reply-To:From:Subject:Reply-To; b=tDUQXpNOnvebIRiBqNA7HUuQQhy51R4md4NovCLZcR0hWM72ncvl1MISUl4dFFKJXVSaFAjptnAmTl7Z3US9EEhoENcsJpU0EnaAP0VXJA8XUYi7bQ6YLwQAWf3WZfucP0emadOUl4p63MOG1IcQxy62CXqBIAtlVK1aQEsOeGNEWQqZxiXs/C331I0J42SAXRD2654brEbJmiSb7503/HK5OaEgx2M3msePkF4YVyQzzYR5Xzi70X495b6nDXknj3qal4R7WEtLoBaegeVSL3glYgJVmK/BlzHiYg8kC0mGbksll3aW7emvcK7M5gldqOKPibkU0rv2rI1MaJE9zg== X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1782944140; bh=KZnzNtn81Xj/dQdKJtLP93iEogP0Sd0DRV2ZLz7W0zM=; h=X-Sonic-MF:Date:Subject:To:From:From:Subject; b=F9WunbPKwIKN0X+ZHT9Criyfo59NDTDK4PzDkXp8+kG/twNOWcJ12g97QaOx8oTN/kXbsJoe0+l81Z753n0AQFRRoE18zVxCcaU6Z2cCutpUkBHCUmU1TVXa4yvzQ/jyhJyccPpPysUhR0aJrIZab8lhNZmxMgfwszKGT21ShIYS3ODGJCMH8bqlCyI4N7chIlA0+3rvh5zkU3vjZoJNbKmU8XUOTPwisop68JezT4ubfkP8gNRLKY5WDZ3v+LGwJMelgDKX9rvr/254B7tAcOtx3jXPwC44vxPYw7/uHj7E8jiHwrbrqGLQTtHYgvFPeVKsCPwj95w9vBYnys/SAQ== X-YMail-OSG: x0gta0MVM1nEc1DR7DkKaG4q2Dx7b5g6k97cvt0x2wHHiPszuJL1K9Tugiskl9c ZBzZhjHGtLE_5X.3V2tIEsWCnBVw2VOQyIlSCO8.L30WhXC_CiuLBr.4xhS.A6LOS.EyRbZ126F6 jgjdcEaaFEv5kEDNGQDJspY6NC.g1jrYHx8rRhdDxT_7b23E5tX3JC6ysYy1nGWxE3.ueA9kOEgH Ye1pXE10Bd0MgnLqtknUwwwSisf9luc5Gf8SgRUFpnPEpyS_pU4l18MU1H.TogfngnAn01G.EeZM .Ep.FxrobfLLAk4QcJZn8ofaZdzlHfPnNAlFK.wPJjNm3nyO7VhwyXokq2XM1gheMuGMYdqQjiZK MjYoKHQLLjgkv_y4_vJBdbfHMZv4QNEHp6UiXcKWf3U8ff5WKqouyzFXXRNHMZzWqF2RMoDdWHpA zAqRselAlu4EwkMF7MYTAhni5QGqYPhf4jjrOZlKkyNf6hWDl1Gc2j_AsQE2N.WphePJWweBo9Yc YWKYtVs0CYZAAuekODWqzygnuCmNCxJEAtfUB5h8AecKuSCSzeznkhDWeOoTNq6ELdOmiU9oQBVZ u.X3WlsZSEKWKtbj0FeesqJ106yATytVX1x4Lj5Z4i974op_QgIrMxJDjSnYlffWCA8D7xIqkTVd 3mhbOdS_9SMF6FK5R8847FTlxIgpVZI7_K9Ak2SqvJsfuV7DNw0WMEsvw5uy489Jm3A.ISYXnTUj 1m_K9PRaRe_Mtaw38RuYiasDS9C_rjoxRCz_qxO8zs3SW5N8l4H2BBkBkvIdvlQyKL.QRL1dsI7h cBnrX7miub0JYe0TOynWOyJouF7f.bJbvgQeaSIL8vvXJLI884vUkywA60r5x4d8GQs2XVhDaIhC HWgC9n4VzJExmEy.rgLpOQxt3J8nF5WHJKctBIWkY1ppRbpLVxPcg3Q4PQsg9L5JyzgYiuV.tWXO 1FvKyrlFSTVtL9Z9CraOw5aQyx3jsJaH6jxC2Dr3bS7Wus2ZGtWYarfQTdUnIxN.W_.DxdVjhihC mYEDiUDTTscemJTzgy6R3j_kDezccb54QgQHT.vgR4xIBwHAFoglT2TMy5K9FbPC.mUUUB_F1Mfg 3nxlv62A0Mp396_vTX.bT8QcUGPl3UQS39zK6Clva30G59J1PuNA094wO6CorpM7JT2dthmDdjJh HDgHf1__gOrbokz0.E_XmsgeJcIXsVKBnHDTah4AEz3oIimxkgSTuD5N8gycXNOu4U_SlnM6oLdh mvBFnhq8A4I3ZO9DjN0u0yG4l1JF1Lsf2VjxNtPdeNToIIZWlGhOQndIW0r3_DPqTwQVSZfdscQI zH.y86hYBKhKPhgD7W9O8rfY4wGtnyZvjrYvD1aDsdzH59ZHAVoYxqRiLTRMVZzwrKhg3JTFeQ8u yGpdLcR1YrdfmksGAPOl37NDiFaDyzEPmlMhvbiw73evoEGfHLifNrUoGXmG4W2E3NWpxjzM_eiW 2KCAm2n9d1.DvGJ9Zb8edr1McwUMyTvbbtIVontoSLerZ784PMzURAuVvXQt6Ms2or9D8IjZmLOU MaTk4s3WAupCHeLzE5cGelmGIVn_Fbs311_nzHDV4nNU6VgeuGtazA9bJcPfWWo0UiwDaNmDFxph hi5TCgpKmGldq9lmBxYMLbumwNB3NiXqWhFe3rBH2.YX_B1aVzv0_OdOAH.GgRk7cFbCGYKGL6Kt WSfWYXOLpxVZo54b3mUXLfsrQ8HusL.2OifuWPSpALSy87wqwEY36apOxfheb85Px3e8vhlPmERZ IuZrs7ekd4LQ3YeE6BUHePsYGHt7viSBzZYkqvEyGQ0mPaOQCHjeakKBclsR8LY00iWxjJQuhx.t E_yE9C95MFlqi5eX.tZ41F1y_SzuRs1iC0gFraIfUPTuhOAkB1.V2IdVXcL06hLrr9xM4Cj.OTk4 EJ_lyeF3F1ln7IWVBB7iOkOLyfkzKjUxEwbtQFRDo2lw0gUEvCjE7vBI6xOQu2CxkLh_muFH.oPj B6FkpSdO6MadWw.WQ14GfRPqXoftyTUsvftgCrD6tz1qDuzqaX8xXWjeAHLxscBdCw5eVR3YMk64 A9gQHR7a.9JXA_sx89R.bC3jpaeBoyzA6PV.Oz7Wub1qo7mIk_ls7TyBlzQ2ZGW3owoe7krNp3EV FDnSB5l8DgC15Njyc_aXCeysVTf._s2v.AOW9SVs54bpiTb_EUrG2zs.5A2noxUp0vzu3hT_5OdO FEMvIm_vBlVwgU0i6Gk3nAXX.SL4roDBtTJoQQwWgusS74KhKckeRQX9G_p_7CNVN2pqI9UENwzh p.w2_5ILupqILfJzUTFCiGTcBlPy5AVSFZXEuahmZUnAcxsoX7CYItwUA8A-- X-Sonic-MF: X-Sonic-ID: 4a79e3e7-bbd2-446b-9832-5183a9c78cd6 Received: from sonic.gate.mail.ne1.yahoo.com by sonic303.consmr.mail.gq1.yahoo.com with HTTP; Wed, 1 Jul 2026 22:15:40 +0000 Received: by hermes--production-gq1-6dc558886b-4lp5m (Yahoo Inc. Hermes SMTP Server) with ESMTPA ID 86171fe158788ec31c8b531e84ac1341; Wed, 01 Jul 2026 22:15:37 +0000 (UTC) Message-ID: Date: Wed, 1 Jul 2026 15:15:36 -0700 List-Id: Packaging the FreeBSD base system List-Archive: https://lists.freebsd.org/archives/freebsd-pkgbase List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-pkgbase@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: None of "man freebsd-base" (or "man pkgbase"), "man pkg-upgrade", or "man pkg-install" deal with documenting .pkgsave and/or .pkgnew behavior or how to handle such To: Alexander Ziaee , Larry Fahnoe Cc: Roger Marquis , freebsd-pkgbase References: Content-Language: en-US From: Mark Millard In-Reply-To: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Mailer: WebService/1.1.26086 mail.backend.jedi.jws.acl:role.jedi.acl.token.atz.jws.hermes.yahoo X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; ASN(0.00)[asn:36647, ipnet:98.137.64.0/20, country:US] X-Rspamd-Queue-Id: 4grDqP5hWZz3NQD X-Spamd-Bar: ---- X-Rspamd-Pre-Result: action=no action; module=replies; Message is reply to one we originated On 7/1/26 09:17, Alexander Ziaee wrote: > On 2026-07-01 08:57 -04:00 EDT, "Larry Fahnoe" wrote: >> My bringing up my own sysadmin experience on other operating systems did not add meaningfully to the conversation and has needlessly stirred the pot. > > I think your words really added meaningfully to the conversation, it brought 3 important ideas to light. From my end as a writer I learned that people are interpreting the information landscape to mean that FreeBSD has a unique issue, when actually VMS and Linux operate the exact same way. Long ago I used VAX/VMS and so was familiar with the likes of ;2 file name suffixes in that context. I never thought that the general type of issue is unique to FreeBSD or to pkg . > So I have a lot more context to reflect on needed improvements to our information landscape. Second, it shows that actually we have the opportunity to solve an unsolved problem in operating systems right now. That is particularly exciting to me because I really love it when we have one of the oldest continuously maintained codebases in the world and are still in places on the bleeding edge working on unsolved problems. Third, I think this was informative for many of our readers who administer mixed environments (which is probably most of us, including me) who may now know that they have and should seek to resolve failed configuration merges in their other environments. > > Plus, the thread didn't catch fire, so w/rt stirring the pot, its all good. > >> I believe this to be a pkg issue, and downstream of that a documentation issue. > > I shared the concerns I'm trying to balance, do you have any ideas how we can make the docs better? > Currently, I've documented these in the 15.1 upgrading guide, and the pkg(8) manual. I do not automatically (re)read the pkg(8) manual to learn about or remind myself of the specifics of what pkg install and pkg upgrade do or requires-of-me for aspects that the command output is silent about. So far as I know, no other pkg commands generate such files. In my view each of those 2 man pages for should at least explicitly indicate to where to look up information about the 3 types of files at issue, including use of notation that allows one to be able to identify the naming conventions involved. But I also think that the command output should explicitly indicate if the results happen to have generated files to go looking for. That allows knowing one can avoid looking when no such file was actually generated --and when one needs to consider looking otherwise (for each type with a positive count). The man pages can not cover such command instance information that guides later actions. >I don't want to duplicate information because it makes an unsustainable maintenance burden, but we can link to these, or if it makes more sense we can move them, and we can also link to them. Further, the descriptions themselves can always be improved. > > Best, > Alex > -- === Mark Millard marklmi at yahoo.com