1.1 --- a/openpkg/rpmtool.8 Tue Jul 31 12:12:54 2012 +0200 1.2 +++ b/openpkg/rpmtool.8 Tue Jul 31 12:23:42 2012 +0200 1.3 @@ -1,15 +1,7 @@ 1.4 -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 1.5 +.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.22) 1.6 .\" 1.7 .\" Standard preamble: 1.8 .\" ======================================================================== 1.9 -.de Sh \" Subsection heading 1.10 -.br 1.11 -.if t .Sp 1.12 -.ne 5 1.13 -.PP 1.14 -\fB\\$1\fR 1.15 -.PP 1.16 -.. 1.17 .de Sp \" Vertical space (when we can't use .PP) 1.18 .if t .sp .5v 1.19 .if n .sp 1.20 @@ -25,11 +17,11 @@ 1.21 .. 1.22 .\" Set up some character translations and predefined strings. \*(-- will 1.23 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left 1.24 -.\" double quote, and \*(R" will give a right double quote. | will give a 1.25 -.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to 1.26 -.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' 1.27 -.\" expand to `' in nroff, nothing in troff, for use with C<>. 1.28 -.tr \(*W-|\(bv\*(Tr 1.29 +.\" double quote, and \*(R" will give a right double quote. \*(C+ will 1.30 +.\" give a nicer C++. Capital omega is used to do unbreakable dashes and 1.31 +.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, 1.32 +.\" nothing in troff, for use with C<>. 1.33 +.tr \(*W- 1.34 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' 1.35 .ie n \{\ 1.36 . ds -- \(*W- 1.37 @@ -48,22 +40,25 @@ 1.38 . ds R" '' 1.39 'br\} 1.40 .\" 1.41 +.\" Escape single quotes in literal strings from groff's Unicode transform. 1.42 +.ie \n(.g .ds Aq \(aq 1.43 +.el .ds Aq ' 1.44 +.\" 1.45 .\" If the F register is turned on, we'll generate index entries on stderr for 1.46 -.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index 1.47 +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index 1.48 .\" entries marked with X<> in POD. Of course, you'll have to process the 1.49 .\" output yourself in some meaningful fashion. 1.50 -.if \nF \{\ 1.51 +.ie \nF \{\ 1.52 . de IX 1.53 . tm Index:\\$1\t\\n%\t"\\$2" 1.54 .. 1.55 . nr % 0 1.56 . rr F 1.57 .\} 1.58 -.\" 1.59 -.\" For nroff, turn off justification. Always turn off hyphenation; it makes 1.60 -.\" way too many mistakes in technical documents. 1.61 -.hy 0 1.62 -.if n .na 1.63 +.el \{\ 1.64 +. de IX 1.65 +.. 1.66 +.\} 1.67 .\" 1.68 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). 1.69 .\" Fear. Run. Save yourself. No user-serviceable parts. 1.70 @@ -130,8 +125,12 @@ 1.71 .\" 1.72 .IX Title "RPMTOOL 8" 1.73 .TH RPMTOOL 8 "OpenPKG" "RPMTOOL(8)" "OpenPKG" 1.74 +.\" For nroff, turn off justification. Always turn off hyphenation; it makes 1.75 +.\" way too many mistakes in technical documents. 1.76 +.if n .ad l 1.77 +.nh 1.78 .SH "NAME" 1.79 -\&\fBrpmtool\fR \- RPM Auxiliary Tool 1.80 +rpmtool \- RPM Auxiliary Tool 1.81 .SH "SYNOPSIS" 1.82 .IX Header "SYNOPSIS" 1.83 \&\fBrpmtool\fR 1.84 @@ -153,10 +152,10 @@ 1.85 Example: 1.86 .Sp 1.87 .Vb 5 1.88 -\& case `rpmtool platform`; in 1.89 -\& *-freebsd[34].* ) ... ;; 1.90 -\& *-sunos5.[678] ) ... ;; 1.91 -\& *-linux2.[24].* ) ... ;; 1.92 +\& case \`rpmtool platform\`; in 1.93 +\& *\-freebsd[34].* ) ... ;; 1.94 +\& *\-sunos5.[678] ) ... ;; 1.95 +\& *\-linux2.[24].* ) ... ;; 1.96 \& esac 1.97 .Ve 1.98 .IP "\fBmflags\fR [\fB\-O\fR] \fItool\fR" 4 1.99 @@ -170,7 +169,7 @@ 1.100 Example: 1.101 .Sp 1.102 .Vb 1 1.103 -\& make `rpmtool mflags -O make` 1.104 +\& make \`rpmtool mflags \-O make\` 1.105 .Ve 1.106 .IP "\fBcflags\fR [\fB\-O\fR] \fItool\fR" 4 1.107 .IX Item "cflags [-O] tool" 1.108 @@ -182,9 +181,9 @@ 1.109 Example: 1.110 .Sp 1.111 .Vb 1 1.112 -\& CC="$CC" CFLAGS=`rpmtool cflags -O $CC` ./configure ... 1.113 +\& CC="$CC" CFLAGS=\`rpmtool cflags \-O $CC\` ./configure ... 1.114 .Ve 1.115 -.ie n .IP "\fBcppflags\fR [\fB\-p\fR \fIprefix\fR] [[\*(C`+|\-\*(C'\fR\fIsubdir ...]" 4 1.116 +.ie n .IP "\fBcppflags\fR [\fB\-p\fR \fIprefix\fR] [[\*(C`+|\-\*(C'\fIsubdir\fR ...]" 4 1.117 .el .IP "\fBcppflags\fR [\fB\-p\fR \fIprefix\fR] [[\f(CW\*(C`+|\-\*(C'\fR\fIsubdir\fR ...]" 4 1.118 .IX Item "cppflags [-p prefix] [[+|-subdir ...]" 1.119 This command output \fIcpp\fR\|(1) \f(CW\*(C`\-I\*(C'\fR options for the OpenPKG instance 1.120 @@ -196,9 +195,9 @@ 1.121 Example: 1.122 .Sp 1.123 .Vb 1 1.124 -\& rpmtool cppflags -p /foo bar -baz +quux 1.125 +\& rpmtool cppflags \-p /foo bar \-baz +quux 1.126 .Ve 1.127 -.ie n .IP "\fBldflags\fR [\fB\-p\fR \fIprefix\fR] [[\*(C`+|\-\*(C'\fR\fIsubdir ...]" 4 1.128 +.ie n .IP "\fBldflags\fR [\fB\-p\fR \fIprefix\fR] [[\*(C`+|\-\*(C'\fIsubdir\fR ...]" 4 1.129 .el .IP "\fBldflags\fR [\fB\-p\fR \fIprefix\fR] [[\f(CW\*(C`+|\-\*(C'\fR\fIsubdir\fR ...]" 4 1.130 .IX Item "ldflags [-p prefix] [[+|-subdir ...]" 1.131 This command output \fIld\fR\|(1) \f(CW\*(C`\-L\*(C'\fR options for the OpenPKG instance 1.132 @@ -210,7 +209,7 @@ 1.133 Example: 1.134 .Sp 1.135 .Vb 1 1.136 -\& rpmtool ldflags -p /foo bar -baz +quux 1.137 +\& rpmtool ldflags \-p /foo bar \-baz +quux 1.138 .Ve 1.139 .IP "\fBfiles\fR [\fB\-v\fR] [\fB\-o\fR \fIoutfile\fR] [\fB\-r\fR \fIbuild-root\fR] [\fIentry\fR ...]" 4 1.140 .IX Item "files [-v] [-o outfile] [-r build-root] [entry ...]" 1.141 @@ -229,7 +228,7 @@ 1.142 .IX Item "Trailing Tags" 1.143 \&\s-1RPM\s0 requires that all tags (like \f(CW\*(C`%attr(...)\*(C'\fR or \f(CW%dir\fR) preceed the 1.144 path in a file list entry. This sometimes leads to ugly and unreadable 1.145 -file lists, because all paths cannot be left\-aligned. With \fIrpmtool\fR\|(8) 1.146 +file lists, because all paths cannot be left-aligned. With \fIrpmtool\fR\|(8) 1.147 tags in the input file list can be at leading and trailing positions. 1.148 The output file list will nevertheless have all tags in leading 1.149 positions for \s-1RPM\s0. 1.150 @@ -262,16 +261,14 @@ 1.151 .Vb 8 1.152 \& %install 1.153 \& : 1.154 -\& rpmtool files -o files -r$RPM_BUILD_ROOT \e 1.155 -\& '%defattr(-,foo,foo)' \e 1.156 -\& '%{prefix}' \e 1.157 -\& '%attr(1755,root,foo) %{prefix}/bin/bar' \e 1.158 -\& '%not %dir {%{prefix},%{prefix}/*,%{prefix}/man/*}' \e 1.159 -\& '%not %{prefix}/info/dir' 1.160 -.Ve 1.161 -.Sp 1.162 -.Vb 1 1.163 -\& %files -f files 1.164 +\& rpmtool files \-o files \-r$RPM_BUILD_ROOT \e 1.165 +\& \*(Aq%defattr(\-,foo,foo)\*(Aq \e 1.166 +\& \*(Aq%{prefix}\*(Aq \e 1.167 +\& \*(Aq%attr(1755,root,foo) %{prefix}/bin/bar\*(Aq \e 1.168 +\& \*(Aq%not %dir {%{prefix},%{prefix}/*,%{prefix}/man/*}\*(Aq \e 1.169 +\& \*(Aq%not %{prefix}/info/dir\*(Aq 1.170 +\& 1.171 +\& %files \-f files 1.172 .Ve 1.173 .RE 1.174 .IP "\fBmsg\fR [\fB\-b\fR]" 4