Source-Changes-HG archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[src/trunk]: src/distrib/notes Modernize release notes:



details:   https://anonhg.NetBSD.org/src/rev/09218cb7e941
branches:  trunk
changeset: 461370:09218cb7e941
user:      martin <martin%NetBSD.org@localhost>
date:      Sun Nov 24 11:15:31 2019 +0000

description:
Modernize release notes:
 - use https where possible
 - adapt to cdn/nycdn and our current auto-build conventions
 - automate where possible
Many thanks to uwe for lots of *roff help.

diffstat:

 distrib/notes/Makefile.inc             |   24 +++++-
 distrib/notes/acorn32/contents         |    5 +-
 distrib/notes/alpha/contents           |    5 +-
 distrib/notes/amd64/contents           |    5 +-
 distrib/notes/amiga/contents           |    5 +-
 distrib/notes/arc/contents             |    5 +-
 distrib/notes/arc/prep                 |    4 +-
 distrib/notes/atari/contents           |    5 +-
 distrib/notes/bebox/contents           |    5 +-
 distrib/notes/cats/contents            |    5 +-
 distrib/notes/cats/prep                |    4 +-
 distrib/notes/common/contents          |    7 +-
 distrib/notes/common/main              |  134 ++++++++++++++++++++------------
 distrib/notes/common/postinstall       |    8 +-
 distrib/notes/common/sysinst           |    6 +-
 distrib/notes/common/upgrade           |    3 +-
 distrib/notes/emips/contents           |    5 +-
 distrib/notes/evbarm/contents          |    5 +-
 distrib/notes/evbppc/contents          |    5 +-
 distrib/notes/ews4800mips/contents     |    5 +-
 distrib/notes/hp300/contents           |    5 +-
 distrib/notes/hpcarm/contents          |    5 +-
 distrib/notes/hpcmips/contents         |    5 +-
 distrib/notes/hpcsh/contents           |    5 +-
 distrib/notes/hppa/contents            |    5 +-
 distrib/notes/i386/contents            |    5 +-
 distrib/notes/landisk/contents         |    5 +-
 distrib/notes/mac68k/contents          |    5 +-
 distrib/notes/macppc/contents          |    5 +-
 distrib/notes/macppc/prep.OPENFIRMWARE |   14 +-
 distrib/notes/mmeye/contents           |    5 +-
 distrib/notes/mvme68k/contents         |    5 +-
 distrib/notes/news68k/contents         |    5 +-
 distrib/notes/newsmips/contents        |    5 +-
 distrib/notes/next68k/contents         |    5 +-
 distrib/notes/ofppc/contents           |    5 +-
 distrib/notes/pmax/contents            |    5 +-
 distrib/notes/prep/contents            |    5 +-
 distrib/notes/rs6000/contents          |    5 +-
 distrib/notes/sandpoint/contents       |    5 +-
 distrib/notes/sandpoint/xfer           |    8 +-
 distrib/notes/sgimips/contents         |    5 +-
 distrib/notes/shark/contents           |    5 +-
 distrib/notes/sparc/contents           |    5 +-
 distrib/notes/sparc64/contents         |    7 +-
 distrib/notes/sparc64/upgrade          |    3 +-
 distrib/notes/sun2/contents            |    5 +-
 distrib/notes/sun3/contents            |    5 +-
 distrib/notes/vax/contents             |    5 +-
 distrib/notes/x68k/contents            |    5 +-
 50 files changed, 210 insertions(+), 202 deletions(-)

diffs (truncated from 1233 to 300 lines):

diff -r 9a776f91dabd -r 09218cb7e941 distrib/notes/Makefile.inc
--- a/distrib/notes/Makefile.inc        Sun Nov 24 11:10:12 2019 +0000
+++ b/distrib/notes/Makefile.inc        Sun Nov 24 11:15:31 2019 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile.inc,v 1.44 2019/11/21 19:23:16 martin Exp $
+#      $NetBSD: Makefile.inc,v 1.45 2019/11/24 11:15:31 martin Exp $
 #
 
 # Ross Harvey <ross%NetBSD.org@localhost>
@@ -27,11 +27,33 @@
 whatis: .OPTIONAL
 
 PRESET=        ${GFLAGS} -U -dM=${M} -dV=${DISTRIBVER} -d.CURDIR=${.CURDIR} -r${M}=1
+PRESET+=       -rmajor=${DISTRIBVER:C/\..*$//}
 .if ${USE_XZ_SETS}
 PRESET+=       -dsetsuffix=tar.xz
 .else
 PRESET+=       -dsetsuffix=tgz
 .endif
+.if ${NETBSD_OFFICIAL_RELEASE:Uno} == "yes"
+PRESET+=       -rFOR_RELEASE=1
+.else
+PRESET+=       -rFOR_RELEASE=0
+.endif
+.if (${DISTRIBVER:M*.99.*})
+PRESET+=       -rRELEASE_BRANCH=0
+.elif (${DISTRIBVER:M*.[0-9]*})
+PRESET+=       -rRELEASE_BRANCH=1
+PRESET+=       -rminor=${DISTRIBVER:C/^[0-9]+\.([0-9])+.*$/\1/}
+nextmin!=      expr ${DISTRIBVER:C/^[0-9]+\.([0-9])+.*$/\1/} + 1
+.if exists(${.CURDIR}/../../../doc/CHANGES-${DISTRIBVER:C/\..*$//}.${nextmin})
+PRESET+=       -rnextminor=${nextmin}
+.endif
+.endif
+.if defined(BUILDID) && "${BUILDID:M20*Z}" != ""
+curdate!=      env LANG="C" date -d "${BUILDID:C/[0-9][0-9][0-9][0-9]Z$//}" "+%b %d, %Y"
+.else
+curdate!=      env LANG="C" date "+%b %d, %Y"
+.endif
+PRESET+=       -dcur_date="${curdate}"
 
 POST_PLAIN= -P-b -P-u -P-o
 
diff -r 9a776f91dabd -r 09218cb7e941 distrib/notes/acorn32/contents
--- a/distrib/notes/acorn32/contents    Sun Nov 24 11:10:12 2019 +0000
+++ b/distrib/notes/acorn32/contents    Sun Nov 24 11:15:31 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: contents,v 1.5 2019/11/21 19:23:16 martin Exp $
+.\"    $NetBSD: contents,v 1.6 2019/11/24 11:15:31 martin Exp $
 .\"
 .\" Copyright (c) 1999-2005 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -31,8 +31,7 @@
 \*V release is found in the
 .Pa \*M
 subdirectory of the distribution:
-.ie \n[FOR_RELEASE] .Pa \&.../NetBSD-\*V/\*M/ .
-.el .Pa Pf \&.../arch/\*M/snapshot/ Ar yyyymmdd/ .
+.Pa \&.../NetBSD-\*V/\*M/ .
 It contains the following files and directories:
 .Pp
 .(tag INSTALL.html -compact \" top level
diff -r 9a776f91dabd -r 09218cb7e941 distrib/notes/alpha/contents
--- a/distrib/notes/alpha/contents      Sun Nov 24 11:10:12 2019 +0000
+++ b/distrib/notes/alpha/contents      Sun Nov 24 11:15:31 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: contents,v 1.19 2019/11/21 19:23:16 martin Exp $
+.\"    $NetBSD: contents,v 1.20 2019/11/24 11:15:31 martin Exp $
 .\"
 .\" Copyright (c) 1999-2005 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -31,8 +31,7 @@
 \*V release is found in the
 .Pa \*M
 subdirectory of the distribution:
-.ie \n[FOR_RELEASE] .Pa \&.../NetBSD-\*V/\*M/ .
-.el .Pa Pf \&.../arch/\*M/snapshot/ Ar yyyymmdd/ .
+.Pa \&.../NetBSD-\*V/\*M/ .
 It contains the following files and directories:
 .Pp
 .(tag INSTALL.html -compact \" top level
diff -r 9a776f91dabd -r 09218cb7e941 distrib/notes/amd64/contents
--- a/distrib/notes/amd64/contents      Sun Nov 24 11:10:12 2019 +0000
+++ b/distrib/notes/amd64/contents      Sun Nov 24 11:15:31 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: contents,v 1.8 2019/11/21 19:23:17 martin Exp $
+.\"    $NetBSD: contents,v 1.9 2019/11/24 11:15:32 martin Exp $
 .\"
 .\" Copyright (c) 1999-2005 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -31,8 +31,7 @@
 \*V release is found in the
 .Pa \*M
 subdirectory of the distribution:
-.ie \n[FOR_RELEASE] .Pa \&.../NetBSD-\*V/\*M/ .
-.el .Pa Pf \&.../arch/\*M/snapshot/ Ar yyyymmdd/ .
+.Pa \&.../NetBSD-\*V/\*M/ .
 It contains the following files and directories:
 .Pp
 .(tag INSTALL.html -compact \" top level
diff -r 9a776f91dabd -r 09218cb7e941 distrib/notes/amiga/contents
--- a/distrib/notes/amiga/contents      Sun Nov 24 11:10:12 2019 +0000
+++ b/distrib/notes/amiga/contents      Sun Nov 24 11:15:31 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: contents,v 1.23 2019/11/21 19:23:17 martin Exp $
+.\"    $NetBSD: contents,v 1.24 2019/11/24 11:15:32 martin Exp $
 .\"
 .\" Copyright (c) 1999-2005 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -31,8 +31,7 @@
 \*V release is found in the
 .Pa \*M
 subdirectory of the distribution:
-.ie \n[FOR_RELEASE] .Pa \&.../NetBSD-\*V/\*M/ .
-.el .Pa Pf \&.../arch/\*M/snapshot/ Ar yyyymmdd/ .
+.Pa \&.../NetBSD-\*V/\*M/ .
 It contains the following files and directories:
 .Pp
 .(tag INSTALL.html -compact \" top level
diff -r 9a776f91dabd -r 09218cb7e941 distrib/notes/arc/contents
--- a/distrib/notes/arc/contents        Sun Nov 24 11:10:12 2019 +0000
+++ b/distrib/notes/arc/contents        Sun Nov 24 11:15:31 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: contents,v 1.5 2019/11/21 19:23:17 martin Exp $
+.\"    $NetBSD: contents,v 1.6 2019/11/24 11:15:32 martin Exp $
 .\"
 .\" Copyright (c) 1999-2005 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -31,8 +31,7 @@
 \*V release is found in the
 .Pa \*M
 subdirectory of the distribution:
-.ie \n[FOR_RELEASE] .Pa \&.../NetBSD-\*V/\*M/ .
-.el .Pa Pf \&.../arch/\*M/snapshot/ Ar yyyymmdd/ .
+.Pa \&.../NetBSD-\*V/\*M/ .
 It contains the following files and directories:
 .Pp
 .(tag INSTALL.html -compact \" top level
diff -r 9a776f91dabd -r 09218cb7e941 distrib/notes/arc/prep
--- a/distrib/notes/arc/prep    Sun Nov 24 11:10:12 2019 +0000
+++ b/distrib/notes/arc/prep    Sun Nov 24 11:15:31 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: prep,v 1.4 2014/11/13 08:16:42 snj Exp $
+.\"    $NetBSD: prep,v 1.5 2019/11/24 11:15:32 martin Exp $
 .
 First and foremost, before beginning the installation process,
 .Em make sure you have a reliable backup
@@ -49,7 +49,7 @@
 Systems not supported by the packages
 collection should get it from the official website:
 .br
-.Lk ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/sysutils/cdrtools/README.html
+.Lk https://cdn.NetBSD.org/pub/NetBSD/packages/pkgsrc/sysutils/cdrtools/README.html
 .br
 .Lk http://cdrecord.berlios.de/old/private/cdrecord.html
 .Pp
diff -r 9a776f91dabd -r 09218cb7e941 distrib/notes/atari/contents
--- a/distrib/notes/atari/contents      Sun Nov 24 11:10:12 2019 +0000
+++ b/distrib/notes/atari/contents      Sun Nov 24 11:15:31 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: contents,v 1.23 2019/11/21 19:23:17 martin Exp $
+.\"    $NetBSD: contents,v 1.24 2019/11/24 11:15:32 martin Exp $
 .\"
 .\" Copyright (c) 1999-2005 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -31,8 +31,7 @@
 \*V release is found in the
 .Pa \*M
 subdirectory of the distribution:
-.ie \n[FOR_RELEASE] .Pa \&.../NetBSD-\*V/\*M/ .
-.el .Pa Pf \&.../arch/\*M/snapshot/ Ar yyyymmdd/ .
+.Pa \&.../NetBSD-\*V/\*M/ .
 It contains the following files and directories:
 .Pp
 .(tag INSTALL.html -compact \" top level
diff -r 9a776f91dabd -r 09218cb7e941 distrib/notes/bebox/contents
--- a/distrib/notes/bebox/contents      Sun Nov 24 11:10:12 2019 +0000
+++ b/distrib/notes/bebox/contents      Sun Nov 24 11:15:31 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: contents,v 1.5 2019/11/21 19:23:17 martin Exp $
+.\"    $NetBSD: contents,v 1.6 2019/11/24 11:15:32 martin Exp $
 .\"
 .\" Copyright (c) 1999-2005 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -31,8 +31,7 @@
 \*V release is found in the
 .Pa \*M
 subdirectory of the distribution:
-.ie \n[FOR_RELEASE] .Pa \&.../NetBSD-\*V/\*M/ .
-.el .Pa Pf \&.../arch/\*M/snapshot/ Ar yyyymmdd/ .
+.Pa \&.../NetBSD-\*V/\*M/ .
 It contains the following files and directories:
 .Pp
 .(tag INSTALL.html -compact \" top level
diff -r 9a776f91dabd -r 09218cb7e941 distrib/notes/cats/contents
--- a/distrib/notes/cats/contents       Sun Nov 24 11:10:12 2019 +0000
+++ b/distrib/notes/cats/contents       Sun Nov 24 11:15:31 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: contents,v 1.5 2019/11/21 19:23:17 martin Exp $
+.\"    $NetBSD: contents,v 1.6 2019/11/24 11:15:32 martin Exp $
 .\"
 .\" Copyright (c) 1999-2005 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -31,8 +31,7 @@
 \*V release is found in the
 .Pa \*M
 subdirectory of the distribution:
-.ie \n[FOR_RELEASE] .Pa \&.../NetBSD-\*V/\*M/ .
-.el .Pa Pf \&.../arch/\*M/snapshot/ Ar yyyymmdd/ .
+.Pa \&.../NetBSD-\*V/\*M/ .
 It contains the following files and directories:
 .Pp
 .(tag INSTALL.html -compact \" top level
diff -r 9a776f91dabd -r 09218cb7e941 distrib/notes/cats/prep
--- a/distrib/notes/cats/prep   Sun Nov 24 11:10:12 2019 +0000
+++ b/distrib/notes/cats/prep   Sun Nov 24 11:15:31 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: prep,v 1.13 2014/11/13 08:16:42 snj Exp $
+.\"    $NetBSD: prep,v 1.14 2019/11/24 11:15:32 martin Exp $
 .
 A \*M machine usually needs little or no preparation before installing
 .Nx ,
@@ -45,7 +45,7 @@
 Systems not supported by the packages
 collection should get it from the official website:
 .br
-.Lk ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc/sysutils/cdrtools/README.html
+.Lk https://cdn.NetBSD.org/pub/NetBSD/packages/pkgsrc/sysutils/cdrtools/README.html
 .br
 .Lk http://www.fokus.gmd.de/research/cc/glone/employees/joerg.schilling/private/cdrecord.html
 .Pp
diff -r 9a776f91dabd -r 09218cb7e941 distrib/notes/common/contents
--- a/distrib/notes/common/contents     Sun Nov 24 11:10:12 2019 +0000
+++ b/distrib/notes/common/contents     Sun Nov 24 11:15:31 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: contents,v 1.179 2019/11/21 19:23:17 martin Exp $
+.\"    $NetBSD: contents,v 1.180 2019/11/24 11:15:33 martin Exp $
 .\"
 .\" Copyright (c) 1999-2005 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -30,8 +30,7 @@
 \*V release is found in the
 .Pa \*M
 subdirectory of the distribution:
-.ie \n[FOR_RELEASE] .Pa \&.../NetBSD-\*V/\*M/ .
-.el .Pa Pf \&.../arch/\*M/snapshot/ Ar yyyymmdd/ .
+.Pa \&.../NetBSD-\*V/\*M/ .
 It contains the following files and directories:
 .Pp
 .(tag INSTALL.html -compact \" top level
@@ -497,7 +496,7 @@
 .Nx Ns /sparc
 .Pa binary/sets .
 Be sure to use the 32 bit sparc
-.Pa kern-GENERIC_SUN4U.\*[setsuffix] 
+.Pa kern-GENERIC_SUN4U.tgz
 kernel distribution.  Otherwise, continue to follow the \*M installation
 procedure, not the sparc instructions.
 .Note)
diff -r 9a776f91dabd -r 09218cb7e941 distrib/notes/common/main
--- a/distrib/notes/common/main Sun Nov 24 11:10:12 2019 +0000
+++ b/distrib/notes/common/main Sun Nov 24 11:15:31 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: main,v 1.553 2019/11/21 19:23:17 martin Exp $
+.\"    $NetBSD: main,v 1.554 2019/11/24 11:15:33 martin Exp $
 .\"
 .\" Copyright (c) 1999-2012 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -30,16 +30,38 @@
        and type "make".  This will create
        src/distrib/notes/<arch>/INSTALL.*.
 
-       The notes that describe the improvements over the last release
-       aren't appropriate for a snapshot, so these are conditional on
-       FOR_RELEASE. 0 == snapshot; 1 == release
+       We keep most of the notes the same on HEAD and release branches,
+       but some of this are not appropriate for HEAD/current. Also
+       some locations differ for actual release, so we distinguish
+       between:
+
+       RELEASE_BRANCH == 1
+               this is on a release branch (not -current)
+       RELEASE_BRANCH == 0
+               this is current, not yet branched
+       FOR_RELEASE == 1
+               this is an official release (will be signed and placed
+               on ftp/cdn)
+       FOR_RELEASE == 0
+               this is a local build or a "daily" build on the build
+               cluster
 ..
 .
 .tm Processing INSTALL
 .
 .\"    --------------------  CONFIGURATION  --------------------
 .
-.nr FOR_RELEASE 1
+.nr oldvers ( \n[major] - 1 )
+.ie \n[FOR_RELEASE] \{\
+.ds RELEASE_URL https://cdn.NetBSD.org/pub/NetBSD/NetBSD-\*V



Home | Main Index | Thread Index | Old Index