Page MenuHomeFreeBSD

[hb]: Update instructions to update from source
Needs ReviewPublic

Authored by fernape on Sep 22 2024, 5:58 PM.
Tags
None
Referenced Files
F138044175: D46752.diff
Fri, Nov 28, 11:20 AM
F137991448: D46752.id148865.diff
Thu, Nov 27, 11:00 PM
Unknown Object (File)
Sun, Nov 23, 7:58 AM
Unknown Object (File)
Sun, Nov 23, 12:30 AM
Unknown Object (File)
Sun, Nov 23, 12:28 AM
Unknown Object (File)
Sat, Nov 22, 5:56 PM
Unknown Object (File)
Sat, Nov 22, 3:25 PM
Unknown Object (File)
Thu, Oct 30, 11:32 AM
Subscribers

Details

Reviewers
None
Group Reviewers
Src Committers
Summary

Add instructions to delete old files and libraries as documented in the top
level Makefile of src.

Test Plan
  • Apply patch
  • make run
  • Access localhost:1313 and inspect the relevant section of the handbook

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
No Lint Coverage
Unit
No Test Coverage
Build Status
Buildable 61539
Build 58423: arc lint + arc unit

Event Timeline

fernape created this revision.
jhb added inline comments.
documentation/content/en/books/handbook/cutting-edge/_index.adoc
738

This is fine (and matches UPDATING)

740

I don't think we want to add this blindly. In UPDATING, the comment for make delete-old mentions make delete-old-libs and explains when it is safe to run. I think you should mirror that arrangement here.

765
documentation/content/en/books/handbook/cutting-edge/_index.adoc
765

Isn't this warning the same as the comment in line 768 for make delete-old-libs

  • [hb]: Warn about blindly removing old libraries

    As suggested by jhb@
documentation/content/en/books/handbook/cutting-edge/_index.adoc
765

I pulled this text directly from src/UPDATING from footnote 6 at the end of the file where it talks about this same general topic (general steps for upgrading from source)

documentation/content/en/books/handbook/cutting-edge/_index.adoc
765

The bullet list already has the warning (rephrased, more compact) and then the description list also includes a similar clarification.
I'm not sure if you mean that in the bullet list you want the whole comment.

Thanks!