From owner-freebsd-doc@FreeBSD.ORG Tue Apr 17 10:50:02 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id D01DC1065672 for ; Tue, 17 Apr 2012 10:50:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 8FD1B8FC17 for ; Tue, 17 Apr 2012 10:50:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q3HAo2V9006774 for ; Tue, 17 Apr 2012 10:50:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q3HAo2qH006773; Tue, 17 Apr 2012 10:50:02 GMT (envelope-from gnats) Resent-Date: Tue, 17 Apr 2012 10:50:02 GMT Resent-Message-Id: <201204171050.q3HAo2qH006773@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Björn Heidotting Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 97C691065670 for ; Tue, 17 Apr 2012 10:45:08 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 82D348FC08 for ; Tue, 17 Apr 2012 10:45:08 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q3HAj8Bp078036 for ; Tue, 17 Apr 2012 10:45:08 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id q3HAj8eO078035; Tue, 17 Apr 2012 10:45:08 GMT (envelope-from nobody) Message-Id: <201204171045.q3HAj8eO078035@red.freebsd.org> Date: Tue, 17 Apr 2012 10:45:08 GMT From: Björn Heidotting To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/167020: Bad command-line example in handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 17 Apr 2012 10:50:02 -0000 >Number: 167020 >Category: docs >Synopsis: Bad command-line example in handbook >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Apr 17 10:50:02 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Björn Heidotting >Release: 8.2-RELEASE >Organization: >Environment: >Description: In Chapter 19.12 (Backup Basics) there is a bad command-line example. The handbooks shows the following: Example 19-2. Using dump over ssh with RSH set # RSH=/usr/bin/ssh /sbin/dump -0uan -f targetuser@targetmachine.example.com:/dev/sa0 /usr This won´t work, because this are two commands which are not separated. >How-To-Repeat: fgrep 'RSH' /usr/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml >Fix: Insert a control operator between the commands like: # RSH=/usr/bin/ssh && /sbin/dump -0uan -f targetuser@targetmachine.example.com:/dev/sa0 /usr OR List the commands, each on a separate line: # RSH=/usr/bin/ssh # /sbin/dump -0uan -f targetuser@targetmachine.example.com:/dev/sa0 /usr >Release-Note: >Audit-Trail: >Unformatted: