From owner-freebsd-doc@FreeBSD.ORG Sat Feb 28 15:52:01 2015 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 4B2C3330 for ; Sat, 28 Feb 2015 15:52:01 +0000 (UTC) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2001:1900:2254:206a::16:76]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 17CBC3EF for ; Sat, 28 Feb 2015 15:52:01 +0000 (UTC) Received: from bugs.freebsd.org ([127.0.1.118]) by kenobi.freebsd.org (8.14.9/8.14.9) with ESMTP id t1SFq0IW033151 for ; Sat, 28 Feb 2015 15:52:00 GMT (envelope-from bugzilla-noreply@freebsd.org) From: bugzilla-noreply@freebsd.org To: freebsd-doc@FreeBSD.org Subject: [Bug 198097] pkg-install -R ... description is confusing Date: Sat, 28 Feb 2015 15:52:01 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Documentation X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Only Me X-Bugzilla-Who: mike.543@comcast.net X-Bugzilla-Status: New X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: freebsd-doc@FreeBSD.org X-Bugzilla-Target-Milestone: --- 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: 7bit X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated MIME-Version: 1.0 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 28 Feb 2015 15:52:01 -0000 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=198097 Bug ID: 198097 Summary: pkg-install -R ... description is confusing Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Severity: Affects Only Me Priority: --- Component: Documentation Assignee: freebsd-doc@FreeBSD.org Reporter: mike.543@comcast.net I just updated php5 via pkg. I wanted to assure that pkgs dependent upon the php5 pkg were also updated. So I read the man page for pkg-install and saw the option -R, --from-root When used with -f, reinstalls any packages that require the given package. When I saw the mention of -f, I scratched my head, what was the man page trying to tell me. Not liking to force anything, I ran the command without -f. Here's what I saw: # pkg install -R php5 Updating FreeBSD repository catalogue... FreeBSD repository is up-to-date. All repositories are up-to-date. The following 8 packages will be affected (of 0 checked): Installed packages to be UPGRADED: php5: 5.4.30 -> 5.4.37 php5-gettext: 5.4.30 -> 5.4.37 squirrelmail: 20140420 -> 20141107 php5-session: 5.4.30 -> 5.4.37 php5-xml: 5.4.30 -> 5.4.37 php5-openssl: 5.4.30 -> 5.4.37 php5-hash: 5.4.30 -> 5.4.37 php5-mbstring: 5.4.30 -> 5.4.37 The process will require 14 KiB more space. 3 MiB to be downloaded. Proceed with this action? [y/N]: y [lots of installation output removed] That is exactly what I wanted to happen, i.e., install php5 and install all the pkgs that are dependent upon it. So now I wonder, what is the purpose of the -f option, if I the dependent packages were installed by just specifying -R. Obviously, I'm confused and may not have read the intent of the -R documentation correctly. Maybe it can be clarified to better explain what happens with and without the -f being specified? -- You are receiving this mail because: You are the assignee for the bug.