.\" Copied from from Pod::Man template\r
-.\" Wed, 23 Mar 2005 11:51:08 +0100\r
+.\" Wed, 14 Mar 2006 21:15:00 +0100\r
.\"\r
.\" Standard preamble:\r
.\" ======================================================================\r
.if n .na\r
.\"
.IX Title "cp-update 1"
-.TH cp-update 1 "March 2005" CARNet "CARNet Packaging Tools"
+.TH cp-update 1 "March 2006" CARNet "CARNet Packaging Tools"
.SH NAME\r
cp-update \- versatile line-based file updating tool\r
.\"
Remove entry \fIpackage\fR from \fIfile\fR. Default is to add lines \r
from stdin.\r
.TP\r
+\fB\-x\fR | \fB\-\-change\fR\r
+Modify existing block, or add it if it does not exist but the begin \r
+mark can be found. Does basically the same as regular insert without\r
+\-\-allow\-multiple but on other way (in-place). Thus those two options\r
+are mutually exclusive.\r
+.TP\r
\fB\-m\fR | \fB\-\-allow\-multiple\fR\r
Allow multiple blocks of the same type. By default, old blocks are \r
replaced with the new one.\r
-.TP\r
-\fB\-h\fR | \fB\-\-help\fR\r
-Print usage reference and exit.\r
-.TP\r
- \fB\-\-version\fR
-Print title, version, copyright message, and exit.\r
.SS Placement control\r
.TP\r
\fB\-t\fR | \fB\-\-insert\-on\-top\fR\r
.TP\r
\fB\-f\fR | \fB\-\-insert\-before\fR \fIpattern\fR\r
Insert before the first line that matches given pattern.\r
-.TP\r
-\fB\-R\fR | \fB\-\-regexp\-match\fR | \fB\-\-regexp\fR\r
-Use regexp mode for line matching.\r
+.PP\r
+Line-matching patterns are PCREs (Perl-compatible regular expressions).\r
.SS Manipulating block marks\r
.TP\r
\fB\-c\fR | \fB\-\-comment\fR \fIstring\fR\r
\fB\-n\fR | \fB\-\-no\-close\fR\r
Do not close and reopen file when editing it in place.\r
Slightly optimized version of the above.\r
+.SS Support modes\r
+.TP\r
+\fB\-h\fR | \fB\-\-help\fR\r
+Print usage reference and exit.\r
+.TP\r
+ \fB\-\-version\fR
+Print title, version, copyright message, and exit.\r
.\"
.SH "EXIT STATUS"
Upon successful execution of given operation, program returns
.RS
.Sp
.Vb 4\r
-\& cp-update --regexp --insert-before '</Controls>' \\\r
+\& cp-update --insert-before '</Controls>' \\\r
\& --comment '<!--' --comment-end ' -->' \\\r
\& gentoo-cn /etc/gentoorc < gentoo-cn.ins
.Ve\r
.RS
.Sp
.Vb 4\r
-\& cp-update -r --regexp --insert-before '</Controls>' \\\r
-\& --comment '<!--' --comment-end ' -->' \\\r
-\& gentoo-cn /etc/gentoorc
+\& cp-update -r --insert-before '</Controls>' \\\r
+\& --comment '<!--' --comment-end ' -->' \\\r
+\& gentoo-cn /etc/gentoorc
.Ve\r
.RE\r
.\"
.\"
.SH "REPORTING BUGS"
If you find any, we encourage you to send them to CARNet packaging group\r
-at SRCE <paketi@srce.hr>.
+<paketi-team@CARNet.hr>.
.PP
When sending bug reports, please try to run program in diagnostic mode
and try to send us quality feedback so we could easily locate and
correct the problem.\r
.\"
.SH "SEE ALSO"\r
-.BR carnet-tools(8),\r
-.BR dpkg-divert(8).
+\fBcarnet-tools\fR(7).\r
.\" End