.\" 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