Add some useful examples to the sed man page.

Reviewed by:	wblock, bcr
MFC after:	1 week
Differential Revision:	https://reviews.freebsd.org/D9958
This commit is contained in:
Brad Davis 2017-03-27 16:01:44 +00:00
parent 5868914ed4
commit d09b527f96
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=316030

View File

@ -31,7 +31,7 @@
.\" @(#)sed.1 8.2 (Berkeley) 12/30/93
.\" $FreeBSD$
.\"
.Dd May 10, 2016
.Dd March 27, 2017
.Dt SED 1
.Os
.Sh NAME
@ -586,6 +586,36 @@ as described in
.Xr environ 7 .
.Sh EXIT STATUS
.Ex -std
.Sh EXAMPLES
Replace
.Ql bar
with
.Ql baz
when piped from another command:
.Bd -literal -offset indent
echo "An alternate word, like bar, is sometimes used in examples." | sed 's/bar/baz/'
.Ed
.Pp
Using backlashes can sometimes be hard to read and follow:
.Bd -literal -offset indent
echo "/home/example" | sed 's/\\/home\\/example/\\/usr\\/local\\/example/'
.Ed
.Pp
Using a different separator can be handy when working with paths:
.Bd -literal -offset indent
echo "/home/example" | sed 's#/home/example#/usr/local/example#'
.Ed
.Pp
Replace all occurances of
.Ql foo
with
.Ql bar
in the file
.Pa test.txt ,
without creating a backup of the file:
.Bd -literal -offset indent
sed -i '' -e 's/foo/bar/' test.txt
.Ed
.Sh SEE ALSO
.Xr awk 1 ,
.Xr ed 1 ,