From nobody Thu Jul 2 00:45:24 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 4grJ8J65wGz6kxGd for ; Thu, 02 Jul 2026 00:45:36 +0000 (UTC) (envelope-from marklmi@yahoo.com) Received: from sonic308-8.consmr.mail.gq1.yahoo.com (sonic308-8.consmr.mail.gq1.yahoo.com [98.137.68.32]) (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 4grJ8J37PGz3bBt for ; Thu, 02 Jul 2026 00:45:36 +0000 (UTC) (envelope-from marklmi@yahoo.com) Authentication-Results: mx1.freebsd.org; dkim=pass header.d=yahoo.com header.s=s2048 header.b=sKwLwskV; dmarc=pass (policy=reject) header.from=yahoo.com; spf=pass (mx1.freebsd.org: domain of marklmi@yahoo.com designates 98.137.68.32 as permitted sender) smtp.mailfrom=marklmi@yahoo.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1782953129; bh=3vDoFVjDSmcRna6loE5GBy0b9OxW9QmzF3SwVNSF//g=; h=Date:Subject:From:To:Cc:References:In-Reply-To:From:Subject:Reply-To; b=sKwLwskV9xEGKisAjCG+f76Ts0zbYhePanccf+/5UIM7U+iU3kzp4ZykwxjQm20zuF7YpT96v4p5L3R9GeBv5zpAykMWxWq0Z+cBTJfmT9asoCy8uzzQKZgLdApVO5FchcbiMuTY/8kGJw+EtyLA40dQIeMD4zvJjA0uGrKUtA+4q9TaWlU4c9sakAS2fKZ2Lq9jqUg604XDS/Z1QvglJNMoGFRGLnxP+1RekiJTFyF+VpZ2L97YYesENwv5e0OUeGRUhA+qmqn4UzxF5iLBVX25Br5Cq11XeRPGgQwh4Aq67uDVN2JdgMDLXrzFvG2dDmIm8gbyW7U8x6MOw/JG3g== X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1782953129; bh=ot3oLTChntEvknxah/9xIBzK5SgMs3gZqLp/Zzy1Ac0=; h=X-Sonic-MF:Date:Subject:From:To:From:Subject; b=jJGYL0QPruor4f8Mhfjeo6G7VF4yvpn94xGKvl1aRi/tm8NDZlXqw/jHbn/XF0HFdCgjONvh3lXRWK2eE8scpoRkHYncV/HqG7U1AB1A3Jpts5C3BPW2vvlt90xY/74xlZuX0LtuY8aTiiAeJQysqLrQqSTVXlGql9OqwqebFLXVWebPY8xCc3wNRfR0qB7zZUum5BFNjDDOD8k8SVyKsL5JaB9+TmPSmLwYHjoaTdTGdNAzI0OTfWqirL3HTybSeG6de60uQyGRcbL/nPUHrOvAmo0ZhrwFhmcR0y+UGW/mmhnZaEIFyAOb3W8JGhef3x3pFdyjvB8sDtTwUqYozA== X-YMail-OSG: 2eQG58IVM1m1fvY7wCluDmKhuURnrQxY0ukK_hJQp2P6Rjsn0mC21G7uyFg5Plg SClVO1oP1tJnTiyE0_46Iu0QwjmyJU5xoprcMAT6VFn0IHluJqPhcKfGK8hIB.HMngOfv4XPWGoQ NBy5sw95HX0bwRTowREqxx.s2rzhR2N_2dHKUt0LVf5zTHs3KPtkKdsTbqUngc.Dk6nl4E__92XP 0Dl8Y0KTCjhwuLv69bT4CZgzVDsX4YLV.taFGMgo9W8QP6TX4CfANaTDFD2PtzRuZzgmOx.JJM9h X5wPLDCqUFGcBQrjVCc_UsoQo4L8_eFcoFrGeR_MRO.CBtbxBOZ.wTRb_SP.mMv.gf_JBRLPzqAB H8mXR0TZI0AL7STjmsgyL542O3wjZTGq0Lbienm8AqkHyXEHtVmhH88DdKF3111uFNPqkgS1u9qL IdAkVZMEsN6WPzc.FTMFRy0xfnfqcId1lPXDskMmtpHz5GOjJPEvO_8ux6SPJgmnjtD3pAOYMN6c wfV.Udm0npavQm7Xws7FqEIjLi2_g3CPxBcWrBigX9aWDv5cedgPw_VMJF_bA5Jq6mf13UN8Xdj9 lG3wu_NV3n.4es8ryvGwuYzYqnXBFn4VEb36059uDepy6NY10fRy1kQKnLM0USUSDgCcmY9mXw4N hCSpjTxaojOVurvE8B33pXeG6JWQmCMZhoXmBKG1lZXeA2aGEi9ABB0Ty8mtCmvWTSrcVueFeTgX NTAXTdCcr5rv2g9vEDtpZ48e9W7wZ2.6qGihcT5ORJHkMIXSU8J_dAi2sjuIzb1FZ2Y99djyYc1z Rml8tU3HVPpI3baDNwyItiM3vGaYnF4n8TZRMIbi0oj24yw_hvWlbzZG2Ymomc9TXADjWT7oZuEd 2QFha9TO1OmRL1RphHfaFI_DWu6Z5jMJHCuu5grSTOl.B2FsuR.fUVy3YPYi6NcKFVGrtXvawoIw b7Ir8kc8KuMOA98C9LDEWoyiXrDvnAvj2fsQDPQtA8vHgoOhKNxt5NaJJnj84KJR5ZaejkiIHkhp BhtJzmUm7PP3zh6ppBdgYfHcql1dNpLY1CBQa6JeDp7KWYf2IF7Yfan7yBVanyhChe4T0KrwnQX9 5AW46zHZgmNumvYoEHTDknXiA.hkJG7Tu.tz_bzDGXItqlMDCYRcIP4mjC0tZ3AncLndXuNGeo5D .Oi82nhx...QreFa.oHPkWM.XYfMuTxTEKRn0K1ib5bgAzLyq0f0RfxnoEzsM49denQjEyAD2IyM o85f5u0W_eZTIkKqdrAI8rzrv7AmCE3lBV8Kk8wTknV3eoCGKfT4AxiEunyUdObIwCP69RLInh49 afbBBd89DAOcJUm8C8hL2E39HBQDQZ6SL5MB3jgQbEoj6XXAo3hkB3Z5C5J15L4QysKlQEP0W3jx KkHgUh0KJdIwOunRplI_bRSIBnrugQyFyUHxXepK7qcvKGpQZYJS14Yb_9goGOndx_ja5Q_CGMkW GUz1zaFmBQPuitVySUAPfA2CNPuqthH373IXf7VOywMvyug0w60xZG6RPrhnzktK4f_d1akXldmI 8QJL0Yb7UnP_Gb_eqVegxqNG3h9DBMDADSKHuuR_BmpgmVD9vaoIGa4m_GipDfB.rx_MyTo.X77z _5XqV7WmY8j3wyT5gg_6Y9q2O3pDQA50BpYcbMr.eqK_CjS5HD3oTPAhk4rHPTWv1u_68WYplcUP jmOy5x41zSqYlnlWkBkPj2aXYpRQU8Q8R5n3Yh9jMyIn6Ne8cQajiy0nCeDbqXgnKOd2RCvyNfnt DdadhzmjLTbi1j6ZlAyiiC9PZfYGoC_bkpNrVPKKAMAkzP4SEWLPrmlX2Hvspti9M2OU__v0RUkV jT3TlvTDtaj5Ko9WOUoRjeKBQS2pOR.Mz6bLdy5to7GRpi_s620UH1yBK1NLi3Gq0CvXOK8JiVpA OsCxG0t0X1mZyaXrXPbeliDme6C8HR4Q85chB6bhxnHsTpsg0NocfCzb3K2aKmPJ3F8InNRC4jt. WlAYKJZWGJnN8JjIvKjqc6EWymovkVcTueiZuP.XlWf3yhrh3ACLu1SkNFHjssO7Eaox6G4dOCyW nXuTgB_1LIDEwfbfXoLJn0vL7OQazJ1LVtPks9U2GAwLebyl2i.imatYHVGBeliPxGj1PRXyhv5N XEURYZdFVtK9mpvquvAy2QY7avSj4NjigUbYqHIv7.kYiuIC3h8039sSAr65dqpGAdMRSfEj1lCG pZO4EWh84Mc0rwZz4DU07ffL70g0qVJatJ.yoMl9YRB0qd8zi47U.Fh1H1v5a3XD5m2yEuzSYOTM kpDPLETh1O0A3G1jayn7jGNINBY3xBiGA7y3zTRJ.1B8BZfkiPSAY26_v X-Sonic-MF: X-Sonic-ID: 0062595f-0569-4bae-9b7f-d0776328a4fb Received: from sonic.gate.mail.ne1.yahoo.com by sonic308.consmr.mail.gq1.yahoo.com with HTTP; Thu, 2 Jul 2026 00:45:29 +0000 Received: by hermes--production-gq1-6dc558886b-w97r4 (Yahoo Inc. Hermes SMTP Server) with ESMTPA ID e327052482a09544dea71d06a19a16a2; Thu, 02 Jul 2026 00:45:24 +0000 (UTC) Message-ID: <41a14bbd-7954-448f-bbce-67ecffa0b4aa@yahoo.com> Date: Wed, 1 Jul 2026 17:45:24 -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 From: Mark Millard To: Alexander Ziaee , Larry Fahnoe Cc: Roger Marquis , freebsd-pkgbase References: Content-Language: en-US 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]; NEURAL_HAM_MEDIUM(-1.00)[-1.000]; NEURAL_HAM_LONG(-1.00)[-1.000]; NEURAL_HAM_SHORT(-1.00)[-0.999]; DMARC_POLICY_ALLOW(-0.50)[yahoo.com,reject]; R_SPF_ALLOW(-0.20)[+ptr:yahoo.com]; R_DKIM_ALLOW(-0.20)[yahoo.com:s=s2048]; MIME_GOOD(-0.10)[text/plain]; TO_DN_ALL(0.00)[]; RCVD_TLS_LAST(0.00)[]; FROM_HAS_DN(0.00)[]; MIME_TRACE(0.00)[0:+]; ARC_NA(0.00)[]; FREEMAIL_ENVFROM(0.00)[yahoo.com]; FREEMAIL_FROM(0.00)[yahoo.com]; DKIM_TRACE(0.00)[yahoo.com:+]; ASN(0.00)[asn:36647, ipnet:98.137.64.0/20, country:US]; RCVD_IN_DNSWL_NONE(0.00)[98.137.68.32:from]; TO_MATCH_ENVRCPT_SOME(0.00)[]; RCVD_COUNT_TWO(0.00)[2]; FROM_EQ_ENVFROM(0.00)[]; RCPT_COUNT_THREE(0.00)[4]; MLMMJ_DEST(0.00)[freebsd-pkgbase@freebsd.org]; RWL_MAILSPIKE_POSSIBLE(0.00)[98.137.68.32:from]; MID_RHS_MATCH_FROM(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; DWL_DNSWL_NONE(0.00)[yahoo.com:dkim] X-Spamd-Bar: --- X-Rspamd-Queue-Id: 4grJ8J37PGz3bBt On 7/1/26 15:15, Mark Millard wrote: > 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. Actually, pkg add might also be a source of one or more of the 3 types of files. Also, pkg delete might generate *.pkgsave files to preserve the content of files that had some non-default/non-upstream content. So: 4 commands, not 2. > 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