Page MenuHomeFreeBSD

releases: Expand rel-latest macro
AcceptedPublic

Authored by ziaee on Fri, Mar 27, 2:57 AM.
Tags
None
Referenced Files
F150615496: D56104.diff
Thu, Apr 2, 8:16 PM
Unknown Object (File)
Wed, Apr 1, 10:40 PM
Unknown Object (File)
Tue, Mar 31, 8:40 PM
Unknown Object (File)
Mon, Mar 30, 11:58 AM
Unknown Object (File)
Sun, Mar 29, 3:58 AM
Subscribers

Details

Reviewers
mhorne
Group Reviewers
releng
docs
Summary

There are a few places where we compare a RELEASE to it's STABLE branch,
or a RELEASE to it's previous release. Use macros so we can bump these
instead of bumping the numbers constantly.

Outstanding:

  • I don't know what to do with rel-latest-previous since we're at a .0

currently, it should be whatever the reader should update to before they
update to 15.0. The jails chapter would benefit greatly from that.

  • The syntax for escaping to use a macro inside of a code block is

still I can't figure it out... but other than that it's working!

Fixes: ff71b333bffaa8 (releases: define rel-latest macro)

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Skipped
Unit
Tests Skipped
Build Status
Buildable 71829
Build 68712: arc lint + arc unit

Event Timeline

ziaee requested review of this revision.Fri, Mar 27, 2:57 AM
ziaee created this revision.

Thanks for working on these macros. I think in many places they are highly desirable.

shared/releases.adoc
41–42

Right!?

Hey Mitchell, good to see you. Thanks for looking this over! Fixed yank/put fail, doh!

The IGNORE seems like a fine solution for now, and can be changed to fit how these macros actually get used. I suspect the active/legacy release lists will still require frequent micro-management. (this is now your purview? ;) )

From my perspective, :rel-latest: is useful for some examples that remain valid over time, but appear stale if they reference the active release at the time of writing, e.g. 12.0.

Hey Mitchell, good to see you. Thanks for looking this over! Fixed yank/put fail, doh!

:)

This revision is now accepted and ready to land.Tue, Mar 31, 2:44 PM