1.1 --- a/openpkg/release.8 Tue Jul 31 12:12:54 2012 +0200
1.2 +++ b/openpkg/release.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 "RELEASE 8"
1.73 .TH RELEASE 8 "OpenPKG" "RELEASE(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 -\&\fBopenpkg release\fR \- OpenPKG Release Utility
1.80 +openpkg release \- OpenPKG Release Utility
1.81 .SH "SYNOPSIS"
1.82 .IX Header "SYNOPSIS"
1.83 \&\fBopenpkg release\fR [\fB\-F\fR|\fB\-\-fmt\fR \fIformat\fR]
1.84 @@ -148,19 +147,20 @@
1.85 The output format specification. The argument \fIformat\fR is an arbitrary
1.86 string which can contain the special expansion constructs "\f(CW%t\fR\*(L" for
1.87 expanding the release tag, \*(R"\f(CW%u\fR\*(L" for expanding the distribution \s-1URL\s0
1.88 -and \*(R"\f(CW\*(C`\en\*(C'\fR" for expanding an embedded newline character.
1.89 +and \*(R"\f(CW\*(C`\en\*(C'\fR" for expanding an embedded newline character.
1.90 The instance \s-1UUID\s0 information is also availble by expanding
1.91 \&\f(CW%r\fR to \s-1UUID_REGISTRY\s0, \f(CW%i\fR to \s-1UUID_INSTANCE\s0, \f(CW%p\fR to \s-1UUID_PLATFORM\s0.
1.92 The default \fIformat\fR is "\f(CW\*(C`OpenPKG\-%t %u\*(C'\fR".
1.93 .IP "\fB\-r\fR, \fB\-\-release\fR \fIrelease\fR" 4
1.94 .IX Item "-r, --release release"
1.95 The package "\f(CW\*(C`Release\*(C'\fR" header value to use for deriving the release
1.96 -tag. The values in the \fI@l_prefix@/etc/openpkg/release\fR file and the
1.97 +tag. The values in the \fI\f(CI@l_prefix\fI@/etc/openpkg/release\fR file and the
1.98 "\f(CW\*(C`Release\*(C'\fR" header of the bootstrap package \fBopenpkg\fR are ignored if
1.99 this option is used.
1.100 .SH "FILES"
1.101 .IX Header "FILES"
1.102 -.IP "\fI@l_prefix@/etc/openpkg/release\fR" 4
1.103 +.ie n .IP "\fI\fI@l_prefix\fI@/etc/openpkg/release\fR" 4
1.104 +.el .IP "\fI\f(CI@l_prefix\fI@/etc/openpkg/release\fR" 4
1.105 .IX Item "@l_prefix@/etc/openpkg/release"
1.106 This optional configuration file can be used to explicitly set values
1.107 for the OpenPKG release tag and distribution URLs. It consists of lines
1.108 @@ -178,43 +178,33 @@
1.109 The fully-qualified distribution \s-1URL\s0 based on either the "\f(CW\*(C`ftp\*(C'\fR\*(L",
1.110 \&\*(R"\f(CW\*(C`http\*(C'\fR\*(L" or \*(R"\f(CW\*(C`file\*(C'\fR" \s-1URL\s0 schemes. If \fIurl\fR contains a trailing
1.111 "\f(CW\*(C`/*\*(C'\fR", this is expanded according to the \fItag\fR value of the \fB\s-1TAG\s0\fR
1.112 -variable and the corresponding filesystem layout on \f(CW\*(C`ftp.openpkg.org\*(C'\fR.
1.113 -The default \fIurl\fR is "\f(CW\*(C`ftp://ftp.openpkg.org/*\*(C'\fR".
1.114 +variable and the corresponding filesystem layout on \f(CW\*(C`download.openpkg.org\*(C'\fR.
1.115 +The default \fIurl\fR is "\f(CW\*(C`http://download.openpkg.org/stacks/*\*(C'\fR".
1.116 +.RE
1.117 .RS 4
1.118 .RE
1.119 -.RS 4
1.120 .SH "EXAMPLE"
1.121 .IX Header "EXAMPLE"
1.122 .Vb 2
1.123 \& $ openpkg release
1.124 -\& OpenPKG-CURRENT ftp://ftp.openpkg.org/current/SRC/
1.125 -.Ve
1.126 -.Sp
1.127 -.Vb 2
1.128 -\& $ openpkg release --fmt=%t
1.129 +\& OpenPKG\-CURRENT http://download.openpkg.org/stacks/current/
1.130 +\&
1.131 +\& $ openpkg release \-\-fmt=%t
1.132 \& CURRENT
1.133 -.Ve
1.134 -.Sp
1.135 -.Vb 2
1.136 -\& $ openpkg release --fmt=%u
1.137 -\& ftp://ftp.openpkg.org/current/SRC/
1.138 -.Ve
1.139 -.Sp
1.140 -.Vb 3
1.141 -\& $ openpkg release --fmt="OpenPKG %t is located at:\e\en%u"
1.142 +\&
1.143 +\& $ openpkg release \-\-fmt=%u
1.144 +\& http://download.openpkg.org/stacks/current/
1.145 +\&
1.146 +\& $ openpkg release \-\-fmt="OpenPKG %t is located at:\e\en%u"
1.147 \& OpenPKG CURRENT is located at:
1.148 -\& ftp://ftp.openpkg.org/current/SRC/
1.149 -.Ve
1.150 -.Sp
1.151 -.Vb 2
1.152 -\& $ openpkg release --release=2.5.4 --fmt=%t
1.153 -\& 2.5-RELEASE
1.154 -.Ve
1.155 -.Sp
1.156 -.Vb 3
1.157 +\& http://download.openpkg.org/stacks/current/
1.158 +\&
1.159 +\& $ openpkg release \-\-release=2.5.4 \-\-fmt=%t
1.160 +\& 2.5\-RELEASE
1.161 +\&
1.162 \& $ cat /openpkg/etc/openpkg/release
1.163 -\& TAG=2-STABLE-20060622
1.164 -\& URL=ftp://ftp.example.com/mirror/openpkg.org/*
1.165 +\& TAG=CURRENT
1.166 +\& URL=http://download.example.com/stack/current/
1.167 .Ve
1.168 .SH "SEE ALSO"
1.169 .IX Header "SEE ALSO"
