aboutsummaryrefslogtreecommitdiff
path: root/sysutils/moreutils/files/sponge.1
diff options
context:
space:
mode:
Diffstat (limited to 'sysutils/moreutils/files/sponge.1')
-rw-r--r--sysutils/moreutils/files/sponge.176
1 files changed, 41 insertions, 35 deletions
diff --git a/sysutils/moreutils/files/sponge.1 b/sysutils/moreutils/files/sponge.1
index 75e31d474d96..3f74fe959c7d 100644
--- a/sysutils/moreutils/files/sponge.1
+++ b/sysutils/moreutils/files/sponge.1
@@ -1,39 +1,45 @@
-.\" -*- coding: us-ascii -*-
-.if \n(.g .ds T< \\FC
-.if \n(.g .ds T> \\F[\n[.fam]]
-.de URL
-\\$2 \(la\\$1\(ra\\$3
-..
-.if \n(.g .mso www.tmac
-.TH sponge 1 2006-02-19 "" ""
-.SH NAME
-sponge \- soak up standard input and write to a file
-.SH SYNOPSIS
-'nh
-.fi
+'\" t
+.\" Title: sponge
+.\" Author: Joey Hess
+.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
+.\" Date: 2006-02-19
+.\" Manual: moreutils
+.\" Source: moreutils
+.\" Language: English
+.\"
+.TH "SPONGE" "1" "2006\-02\-19" "moreutils" "moreutils"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
.ad l
-\fBsed '...' file | grep '...' | sponge file\fR \kx
-.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
-'in \n(.iu+\nxu
-'in \n(.iu-\nxu
-.ad b
-'hy
-.SH DESCRIPTION
-\fBsponge\fR reads standard input and
-writes it out to the specified file. Unlike a shell
-redirect, sponge soaks up all its input before
-opening the output file. This allows constructing
-pipelines that read from and write to
-the same file.
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+sponge \- soak up standard input and write to a file
+.SH "SYNOPSIS"
+.HP \w'\fBsed\ \*(Aq\&.\&.\&.\*(Aq\ file\ |\ grep\ \*(Aq\&.\&.\&.\*(Aq\ |\ sponge\ file\fR\ 'u
+\fBsed \*(Aq\&.\&.\&.\*(Aq file | grep \*(Aq\&.\&.\&.\*(Aq | sponge file\fR
+.SH "DESCRIPTION"
+.PP
+\fBsponge\fR
+reads standard input and writes it out to the specified file\&. Unlike a shell redirect, sponge soaks up all its input before opening the output file\&. This allows constructing pipelines that read from and write to the same file\&.
+.PP
+It also creates the output file atomically by renaming a temp file into place, and preserves the permissions of the output file if it already exists\&. If the output file is a special file or symlink, the data will be written to it\&.
.PP
-It also creates the output file
-atomically by renaming a temp file into place,
-and preserves the permissions of the output file
-if it already exists.
-If the output file is a special file or symlink,
-the data will be written to it.
+If no output file is specified, sponge outputs to stdout\&.
+.SH "AUTHOR"
.PP
-If no output file is specified, sponge outputs to
-stdout.
-.SH AUTHOR
Colin Watson and Tollef Fog Heen