diff -r 71503088f51b -r f880f219c566 openpkg/rpmtool.8 --- a/openpkg/rpmtool.8 Tue Jul 31 12:12:54 2012 +0200 +++ b/openpkg/rpmtool.8 Tue Jul 31 12:23:42 2012 +0200 @@ -1,15 +1,7 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 +.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.22) .\" .\" Standard preamble: .\" ======================================================================== -.de Sh \" Subsection heading -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp @@ -25,11 +17,11 @@ .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left -.\" double quote, and \*(R" will give a right double quote. | will give a -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' -.\" expand to `' in nroff, nothing in troff, for use with C<>. -.tr \(*W-|\(bv\*(Tr +.\" double quote, and \*(R" will give a right double quote. \*(C+ will +.\" give a nicer C++. Capital omega is used to do unbreakable dashes and +.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, +.\" nothing in troff, for use with C<>. +.tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- @@ -48,22 +40,25 @@ . ds R" '' 'br\} .\" +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" .\" If the F register is turned on, we'll generate index entries on stderr for -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. -.if \nF \{\ +.ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} -.\" -.\" For nroff, turn off justification. Always turn off hyphenation; it makes -.\" way too many mistakes in technical documents. -.hy 0 -.if n .na +.el \{\ +. de IX +.. +.\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. @@ -130,8 +125,12 @@ .\" .IX Title "RPMTOOL 8" .TH RPMTOOL 8 "OpenPKG" "RPMTOOL(8)" "OpenPKG" +.\" For nroff, turn off justification. Always turn off hyphenation; it makes +.\" way too many mistakes in technical documents. +.if n .ad l +.nh .SH "NAME" -\&\fBrpmtool\fR \- RPM Auxiliary Tool +rpmtool \- RPM Auxiliary Tool .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBrpmtool\fR @@ -153,10 +152,10 @@ Example: .Sp .Vb 5 -\& case `rpmtool platform`; in -\& *-freebsd[34].* ) ... ;; -\& *-sunos5.[678] ) ... ;; -\& *-linux2.[24].* ) ... ;; +\& case \`rpmtool platform\`; in +\& *\-freebsd[34].* ) ... ;; +\& *\-sunos5.[678] ) ... ;; +\& *\-linux2.[24].* ) ... ;; \& esac .Ve .IP "\fBmflags\fR [\fB\-O\fR] \fItool\fR" 4 @@ -170,7 +169,7 @@ Example: .Sp .Vb 1 -\& make `rpmtool mflags -O make` +\& make \`rpmtool mflags \-O make\` .Ve .IP "\fBcflags\fR [\fB\-O\fR] \fItool\fR" 4 .IX Item "cflags [-O] tool" @@ -182,9 +181,9 @@ Example: .Sp .Vb 1 -\& CC="$CC" CFLAGS=`rpmtool cflags -O $CC` ./configure ... +\& CC="$CC" CFLAGS=\`rpmtool cflags \-O $CC\` ./configure ... .Ve -.ie n .IP "\fBcppflags\fR [\fB\-p\fR \fIprefix\fR] [[\*(C`+|\-\*(C'\fR\fIsubdir ...]" 4 +.ie n .IP "\fBcppflags\fR [\fB\-p\fR \fIprefix\fR] [[\*(C`+|\-\*(C'\fIsubdir\fR ...]" 4 .el .IP "\fBcppflags\fR [\fB\-p\fR \fIprefix\fR] [[\f(CW\*(C`+|\-\*(C'\fR\fIsubdir\fR ...]" 4 .IX Item "cppflags [-p prefix] [[+|-subdir ...]" This command output \fIcpp\fR\|(1) \f(CW\*(C`\-I\*(C'\fR options for the OpenPKG instance @@ -196,9 +195,9 @@ Example: .Sp .Vb 1 -\& rpmtool cppflags -p /foo bar -baz +quux +\& rpmtool cppflags \-p /foo bar \-baz +quux .Ve -.ie n .IP "\fBldflags\fR [\fB\-p\fR \fIprefix\fR] [[\*(C`+|\-\*(C'\fR\fIsubdir ...]" 4 +.ie n .IP "\fBldflags\fR [\fB\-p\fR \fIprefix\fR] [[\*(C`+|\-\*(C'\fIsubdir\fR ...]" 4 .el .IP "\fBldflags\fR [\fB\-p\fR \fIprefix\fR] [[\f(CW\*(C`+|\-\*(C'\fR\fIsubdir\fR ...]" 4 .IX Item "ldflags [-p prefix] [[+|-subdir ...]" This command output \fIld\fR\|(1) \f(CW\*(C`\-L\*(C'\fR options for the OpenPKG instance @@ -210,7 +209,7 @@ Example: .Sp .Vb 1 -\& rpmtool ldflags -p /foo bar -baz +quux +\& rpmtool ldflags \-p /foo bar \-baz +quux .Ve .IP "\fBfiles\fR [\fB\-v\fR] [\fB\-o\fR \fIoutfile\fR] [\fB\-r\fR \fIbuild-root\fR] [\fIentry\fR ...]" 4 .IX Item "files [-v] [-o outfile] [-r build-root] [entry ...]" @@ -229,7 +228,7 @@ .IX Item "Trailing Tags" \&\s-1RPM\s0 requires that all tags (like \f(CW\*(C`%attr(...)\*(C'\fR or \f(CW%dir\fR) preceed the path in a file list entry. This sometimes leads to ugly and unreadable -file lists, because all paths cannot be left\-aligned. With \fIrpmtool\fR\|(8) +file lists, because all paths cannot be left-aligned. With \fIrpmtool\fR\|(8) tags in the input file list can be at leading and trailing positions. The output file list will nevertheless have all tags in leading positions for \s-1RPM\s0. @@ -262,16 +261,14 @@ .Vb 8 \& %install \& : -\& rpmtool files -o files -r$RPM_BUILD_ROOT \e -\& '%defattr(-,foo,foo)' \e -\& '%{prefix}' \e -\& '%attr(1755,root,foo) %{prefix}/bin/bar' \e -\& '%not %dir {%{prefix},%{prefix}/*,%{prefix}/man/*}' \e -\& '%not %{prefix}/info/dir' -.Ve -.Sp -.Vb 1 -\& %files -f files +\& rpmtool files \-o files \-r$RPM_BUILD_ROOT \e +\& \*(Aq%defattr(\-,foo,foo)\*(Aq \e +\& \*(Aq%{prefix}\*(Aq \e +\& \*(Aq%attr(1755,root,foo) %{prefix}/bin/bar\*(Aq \e +\& \*(Aq%not %dir {%{prefix},%{prefix}/*,%{prefix}/man/*}\*(Aq \e +\& \*(Aq%not %{prefix}/info/dir\*(Aq +\& +\& %files \-f files .Ve .RE .IP "\fBmsg\fR [\fB\-b\fR]" 4