From owner-freebsd-doc@freebsd.org Mon Oct 17 13:31:13 2016 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id D60FBC1279C for ; Mon, 17 Oct 2016 13:31:13 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) 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 AC90432F for ; Mon, 17 Oct 2016 13:31:13 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from bugs.freebsd.org ([127.0.1.118]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id u9HDVDZo015403 for ; Mon, 17 Oct 2016 13:31:13 GMT (envelope-from bugzilla-noreply@freebsd.org) From: bugzilla-noreply@freebsd.org To: freebsd-doc@FreeBSD.org Subject: [Bug 213564] [handbook] [patch] clarify Updating FreeBSD chapter to contrast binary-only and source-based upgrade strategies Date: Mon, 17 Oct 2016 13:31:13 +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: patch X-Bugzilla-Severity: Affects Many People X-Bugzilla-Who: linimon@FreeBSD.org X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: freebsd-doc@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status keywords bug_severity priority component assigned_to reporter attachments.created 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 MIME-Version: 1.0 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 17 Oct 2016 13:31:13 -0000 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D213564 Bug ID: 213564 Summary: [handbook] [patch] clarify Updating FreeBSD chapter to contrast binary-only and source-based upgrade strategies Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Keywords: patch Severity: Affects Many People Priority: --- Component: Documentation Assignee: freebsd-doc@FreeBSD.org Reporter: linimon@FreeBSD.org Keywords: patch Created attachment 175861 --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=3D175861&action= =3Dedit patch to handbook/cutting_edge Currently Chapter 23 mixes these two types of content. This may be confusi= ng to new users. In particular, I see recurring questions on the mailing lists about problems using freebsd-update in situations where it is may not be the best strategy. A new Section is introduced, "Choosing a Strategy", which clearly shows what part of the remaining chapter content is relevant to which strategy. This = is introduced right after the Synopsis. The Synopsis grows a reference to this section. In addition, one excellent line is pulled from the top of the FreeBSD Update section and moved the top here. There is some minor rewording to go with that. A disclaimer is added to the FreeBSD Update section about which architectur= es it is available for. This is a hack; that information should be provided elsewhere. Right now the information is correct but misleading. Finally, a minor change to the last section attempts to clarify that it is applicable to source updates and only in certain environments. --=20 You are receiving this mail because: You are the assignee for the bug.=