Browse code

Update release.8

Jaidyn Levesque authored on 2019-10-16 12:32:06
Showing 2 changed files
... ...
@@ -1,4 +1,4 @@
1
-.\"	$OpenBSD: release.8,v 1.93 2018/02/15 19:01:39 tb Exp $
1
+.\"	$OpenBSD: release.8,v 1.94 2018/06/23 23:19:11 rob Exp $
2 2
 .\"
3 3
 .\"	Copyright (c) 2000 Marco S. Hyman
4 4
 .\"	Copyright (c) 2016 Theo Buehler <tb@openbsd.org>
... ...
@@ -10,12 +10,12 @@
10 10
 .\"	LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
11 11
 .\"	FOR A PARTICULAR PURPOSE.
12 12
 .\"
13
-.Dd $Mdocdate: February 15 2018 $
13
+.Dd $Mdocdate: June 23 2018 $
14 14
 .Dt RELEASE 8
15 15
 .Os
16 16
 .Sh NAME
17 17
 .Nm release
18
-.Nd building an LibertyBSD release
18
+.Nd building a LibertyBSD release
19 19
 .Sh DESCRIPTION
20 20
 There are several steps necessary to build a release:
21 21
 .Pp
... ...
@@ -38,6 +38,15 @@ Make the third party packages.
38 38
 Create boot and installation disk images.
39 39
 .El
40 40
 .Pp
41
+This manual describes the steps for the
42
+.Em release
43
+and
44
+.Em stable
45
+branches.
46
+To build a
47
+.Em current
48
+release, additional steps may be required.
49
+.Pp
41 50
 Commands to be run as a user are preceded by a dollar sign
42 51
 .Sq $ .
43 52
 Commands that must be run as the superuser are preceded by a hash mark
... ...
@@ -50,7 +59,7 @@ Most of the defaults can be overridden by setting
50 59
 the appropriate variables in
51 60
 .Xr mk.conf 5 .
52 61
 .Ss 1. Fetch sources
53
-You can fetch sources from 
62
+You can fetch sources from
54 63
 .Lk https://ftp.libertybsd.net/pub/LibertyBSD/x.y/ ,
55 64
 .Lk ftp://ftp.libertybsd.net/pub/LibertyBSD/x.y/ ,
56 65
 or from a mirror.
... ...
@@ -63,7 +72,7 @@ The files you'll need are
63 72
 .Pa sys.tar.gz ,
64 73
 and
65 74
 .Pa xenocara.tar.gz .
66
-.Pp
75
+.Pp 
67 76
 As for dealing with these tarballs:
68 77
 .Bl -compact -offset indent
69 78
 .It
... ...
@@ -130,7 +139,7 @@ and
130 139
 # cd /dev && ./MAKEDEV all
131 140
 .Ed
132 141
 .Pp
133
-At this point, the base system is up to date and running the code
142
+At this point, the base system is up to date with the code
134 143
 that will be made into a release.
135 144
 .Ss 4. Make and validate the base system release
136 145
 The base system release consists of at least one generic kernel,
... ...
@@ -157,7 +166,7 @@ On this filesystem, create a
157 166
 .Va DESTDIR
158 167
 directory.
159 168
 This will be the root of a complete
160
-.Ox
169
+LibertyBSD
161 170
 installation.
162 171
 .Pp
163 172
 .Sy Warning :
... ...
@@ -221,7 +230,7 @@ The steps to build and validate the Xenocara release are:
221 230
 .Ed
222 231
 .Pp
223 232
 At this point,
224
-.Ox
233
+LibertyBSD
225 234
 base system and X Window System tarballs are in
226 235
 .Va RELEASEDIR .
227 236
 .Ss 7. Make the third party packages
228 237
new file mode 100644
... ...
@@ -0,0 +1,91 @@
1
+18c18
2
+< .Nd building an OpenBSD release
3
+---
4
+> .Nd building a LibertyBSD release
5
+24c24
6
+< Update sources.
7
+---
8
+> Fetch sources.
9
+49,51d48
10
+< See
11
+< .Lk https://www.openbsd.org/faq/current.html
12
+< for any needed workarounds.
13
+64,82c61,65
14
+< .Ss 1. Update sources
15
+< A
16
+< .Nm
17
+< should use sources that were checked out using the same
18
+< .Xr cvs 1
19
+< tag.
20
+< There are two families of tags:
21
+< .Bl -tag -width OPENBSD_x_y_BASE
22
+< .It OPENBSD_x_y_BASE
23
+< The sources for the
24
+< .Ox x.y
25
+< release.
26
+< .It OPENBSD_x_y
27
+< The sources for the
28
+< .Ox x.y
29
+< stable branch.
30
+< It contains the patches described in
31
+< .Lk https://www.openbsd.org/stable.html .
32
+< .El
33
+---
34
+> .Ss 1. Fetch sources
35
+> You can fetch sources from
36
+> .Lk https://ftp.libertybsd.net/pub/LibertyBSD/x.y/ ,
37
+> .Lk ftp://ftp.libertybsd.net/pub/LibertyBSD/x.y/ ,
38
+> or from a mirror.
39
+84,86c67,68
40
+< See
41
+< .Lk https://www.openbsd.org/anoncvs.html
42
+< for instructions on fetching the sources for the first time.
43
+---
44
+> You can find a list of mirrors at
45
+> .Lk https://libertybsd.net/download.shtml .
46
+88,94c70,90
47
+< To update existing sources to the versions identified by one of the above
48
+< tags, use the commands:
49
+< .Bd -literal -offset indent
50
+< $ cd /usr/src && cvs up -r TAG -Pd
51
+< $ cd /usr/xenocara && cvs up -r TAG -Pd
52
+< $ cd /usr/ports && cvs up -r TAG -Pd
53
+< .Ed
54
+---
55
+> The files you'll need are
56
+> .Pa src.tar.gz ,
57
+> .Pa sys.tar.gz ,
58
+> and
59
+> .Pa xenocara.tar.gz .
60
+> .Pp 
61
+> As for dealing with these tarballs:
62
+> .Bl -compact -offset indent
63
+> .It
64
+> .Pa src.tar.gz
65
+> should be extracted to
66
+> .Pa /usr/src
67
+> .It
68
+> .Pa sys.tar.gz
69
+> should be extracted to
70
+> .Pa /usr/src/sys
71
+> .It
72
+> .Pa xenocara.tar.gz
73
+> should be extracted to
74
+> .Pa /usr/xenocara
75
+> .El
76
+96,102d91
77
+< .Sy Warning :
78
+< .Xr cvs 1
79
+< tags are
80
+< .Sq sticky .
81
+< See
82
+< .Xr cvs 1
83
+< for more information.
84
+180c169
85
+< .Ox
86
+---
87
+> LibertyBSD
88
+244c233
89
+< .Ox
90
+---
91
+> LibertyBSD