Page MenuHomeFreeBSD

Update the version of -CURRENT in Porters Handbook
ClosedPublic

Authored by carlavilla on Nov 5 2019, 8:12 PM.
Tags
None
Referenced Files
F110087999: D22248.diff
Thu, Feb 13, 11:26 AM
Unknown Object (File)
Wed, Jan 29, 8:55 PM
Unknown Object (File)
Oct 9 2024, 9:34 AM
Unknown Object (File)
Oct 5 2024, 5:02 AM
Unknown Object (File)
Oct 4 2024, 1:54 AM
Unknown Object (File)
Oct 3 2024, 8:07 AM
Unknown Object (File)
Oct 2 2024, 7:36 PM
Unknown Object (File)
Sep 26 2024, 8:11 PM
Subscribers
None

Details

Summary

Update the number version of -CURRENT in the Porters Handbook.

PR: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=240791

Test Plan

Compile the Porters Handbook

Diff Detail

Repository
rD FreeBSD doc repository - subversion
Lint
Lint Skipped
Unit
Tests Skipped

Event Timeline

I think we have a variable for the current release: &rel.current;
Can you try that and see if the has the desired effect? That way, we don't have to touch that fine each time when there is a new CURRENT release branch.

In D22248#486357, @bcr wrote:

I think we have a variable for the current release: &rel.current;
Can you try that and see if the has the desired effect? That way, we don't have to touch that fine each time when there is a new CURRENT release branch.

The entity &rel.current makes reference to 12.0
I found all the entities in share/xml/freebsd.ent

OK, if we don't have an entity for 13 in there at the moment, I guess we have to either add it there or use your original proposed patch.

Isn't there some place where this value can come from? Because it feels a bit silly to have to update that every couple of years.

In D22248#486752, @mat wrote:

Isn't there some place where this value can come from? Because it feels a bit silly to have to update that every couple of years.

Yes, that's true. But right now, there's no entity for this value.

We have two options:
a) Create a new value in the share/xml/freebsd.ent file that makes reference to 13.0-CURRENT
b) Change 12.0-CURRENT with 13.0-CURRENT

Adding Glen for clarification: Does it make sense to add the 13-CURRENT entity in the file or will that change other references that are using it already?
I think using 13-CURRENT is the right thing to do here and as @mat pointed out, it is easier to just reference it rather than changing it every time the version of CURRENT changes.

While I agree with mat, please go ahead and commit the change.

The Handbook does not directly use the entities used by the website, which I would like to change to be version-specific, to eliminate some overlap between the two sets of used entities.

For example, see r53534 of share/xml/freebsd.ent, where the 'rel121.current' (and related) entities were added.

To mat's comment, yes, this needs further revisiting, but this at least resolves the immediate problem.

In D22248#487594, @gjb wrote:

While I agree with mat, please go ahead and commit the change.

The Handbook does not directly use the entities used by the website, which I would like to change to be version-specific, to eliminate some overlap between the two sets of used entities.

For example, see r53534 of share/xml/freebsd.ent, where the 'rel121.current' (and related) entities were added.

To mat's comment, yes, this needs further revisiting, but this at least resolves the immediate problem.

So... can I make the commit? I still need the approval of @bcr and @mat

OK, go ahead. We'll figure out a more elegant solution separately.

This revision was not accepted when it landed; it landed in state Needs Review.Nov 16 2019, 5:45 PM
This revision was automatically updated to reflect the committed changes.