git: 8790fe3058c8 - main - Fix confusing example in paste(1)

Warner Losh imp at FreeBSD.org
Mon May 31 22:14:27 UTC 2021


The branch main has been updated by imp:

URL: https://cgit.FreeBSD.org/src/commit/?id=8790fe3058c83f624ca2155fb0dbaac23c641237

commit 8790fe3058c83f624ca2155fb0dbaac23c641237
Author:     jocki84 <jocki84 at googlemail.com>
AuthorDate: 2018-07-12 17:22:29 +0000
Commit:     Warner Losh <imp at FreeBSD.org>
CommitDate: 2021-05-31 22:12:44 +0000

    Fix confusing example in paste(1)
    
    Paste's man page contains an example for a reimplementation of
    nl(1). This example uses the command line
        sed = myfile | paste -s -d '\t\n' - -
    in order to concatenate consecutive lines with an intervening tab.
    
    However, the way the example uses the switches -s and -d and two `dash`
    input files is redundant. There are in fact two equivalent but simpler
    ways to achieve the desired result:
        sed = myfile | paste -s -d '\t\n' -
    uses the same style as the previous example, while
        sed = myfile | paste - -
    is arguably even simpler and illustrates the final sentence of the
    DESCRIPTION.
    
    Reviewed by:            imp@
    Pull Request:           https://github.com/freebsd/freebsd-src/pull/163
---
 usr.bin/paste/paste.1 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/usr.bin/paste/paste.1 b/usr.bin/paste/paste.1
index 8bd02dd47097..73b10fcd79b7 100644
--- a/usr.bin/paste/paste.1
+++ b/usr.bin/paste/paste.1
@@ -120,7 +120,7 @@ Combine pairs of lines from a file into single lines:
 Number the lines in a file, similar to
 .Xr nl 1 :
 .Pp
-.Dl "sed = myfile | paste -s -d '\et\en' - -"
+.Dl "sed = myfile | paste - -"
 .Pp
 Create a colon-separated list of directories named
 .Pa bin ,


More information about the dev-commits-src-all mailing list