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
Unknown Object (File)
Thu, May 2, 1:14 PM
Unknown Object (File)
Thu, May 2, 1:14 PM
Unknown Object (File)
Thu, May 2, 11:35 AM
Unknown Object (File)
Thu, May 2, 9:58 AM
Unknown Object (File)
Jan 17 2024, 8:59 AM
Unknown Object (File)
Dec 22 2023, 9:37 PM
Unknown Object (File)
Oct 11 2023, 12:56 AM
Unknown Object (File)
May 14 2023, 6:37 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 Not Applicable
Unit
Tests Not Applicable

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.