Closing, tsoome committed the fix for the bug this exposed this today.

LGTM + tested, thank you so much!

Add a copyright

add markup, fix option order in synopsis

Thanks @adrian! Capitalization: USB MIBM being a proper noun does, and cellular modem driver does not. Driver: yes this one is, I helped write the hardware section for it.

Apparently update-packages also can create the initial repo.
This is confusing and we should simplify this.

If make update-packages creates and or updates the package repo, the difference between this and make packages is confusing. Can we just remove make packages and rename this to make packages so it's a bit cleaner?

I did see that commit already when I was preparing this sir. My make packages fails on e6000sw not found. I do have a /etc/src.conf at https://people.freebsd.org/~ziaee/tmp/src.conf .

address issues i mentioned previously

I also intend to change this to "Update the pkg(7) repository created by the *packages* target".

In D50292#1147390, @cy wrote:

In D50292#1147383, @zlei wrote:

RIP has been obsolete for over 20 years and no one is running it on modern networks

RIP is quite a simple routing protocol to be implemented, and can be found from lots of routers. It is still available from modern routers, even modern networks prefer other routing protocols.

I'd say RIP can be easily deployed rather than obsolete.

Would a port be acceptable? I could extract it into its own repo as a basis for a distfile for use with USE_GITHUB plumbing.

add a stub description

tag copyright

Floppies might be a tough thing to waste the fd namespace on. What if we called it something that was still short but less ambiguous like floppies, similar to how we have manuals?

Manual looks fine to me.

Correct voice

Accepted as manpages

update for renamed firmware pkg

oops, had a typo

-remove debugging info, this is now done at compile time with a secret
flag

I believe this is a simple statement of fact with no copyrightable creative work here, and protected by the copyright of the rest of this work.

This also needs to be in UPDATING and Relnotes, I think.

If you want to remove them from build(7) so the commit is atomic for our downstream, I have no problem resolving the conflict in my build(7) draft.

When I was a kid, I was in awe by the unbelievable simplicity and elegance of that statement.

Sir when you merge this please note that I disapproved. This code is not causing any problems.

Development(7):
+ markup draft.diff/draft.patch as paths, for e.g. apropos Pa=patch
+ add the port of git-arc to FILES, and then xref it's manual

+ split make clean all install
+ make cross-building example DESTDIR consistent

Thats important and makes sense, thank you.
Removed CAVEATS

+ rollback fixing list widths
+ switch to TARGET_ARCH=aarch64 in examples, thanks @imp!

Switch all reboot to shutdown -r now, and remove xref to reboot.

+ combine build targets in examples
+ markup buildworld in CAVEATS
+ add a CAVEAT about build. The way I see this going is that the already
architecture specific boot(8) pages (missing on ARM64, and a bit
convoluted on x86) needs to be the meta page or topic introduction page
for each architecture, linking to the loader pages for that arch.
We just have too many pages all over the place for this with great doc
sprawl. It makes sense to start with boot(8) and clean them up from
there but like, that needs a whole working group or I need to annoy
everyone with questions.

In D50217#1146701, @des wrote:

Well then apropos Sy=__nodiscard should work just fine.

In D50217#1146689, @des wrote:

No, apropos only searches man page titles (.Nm) and descriptions (.Nd).

For another commit: we should mark these up somehow so they're searchable with apropos. I think the relevant macros are (from mdoc(7)):

Semantic markup for function libraries
       Lb		function library (one argument)
       In		include	file (one argument)
       Fd		other preprocessor directive (>0 arguments)
       Ft		function type (>0 arguments)
       Fo, Fc		function block:	funcname
       Fn		function name: funcname	[argument ...]
       Fa		function argument (>0 arguments)
       Vt		variable type (>0 arguments)
       Va		variable name (>0 arguments)
       Dv		defined	 variable   or	 preprocessor	constant   (>0
				       arguments)
       Er		error constant (>0 arguments)
       Ev		environmental variable (>0 arguments)

Split make kernel up for future recommendations about not building as
root.

I tested this on my machine (2560x1600) and nothing bad happened (default font is still 32x64 producing a perfect 80x25).

@tsoome may have fixed this issue in https://reviews.freebsd.org/D50258

Oops, lots of pending messages didn't get submitted. Still reflecting on LOCAL_MODULES and not building as root. Do we have any mechanism to do this in base? mdo?

Attempt to improve language for INSTKERNNAME example

+ fix INSTKERNNAME example straggler
+ switch cross compiling examples to TARGET, I don't know if this works, these examples are from other docs we have
+ add an example for git formatted patches to development(7)

Revert line organization. I got distracted thinking about how we should
do this, and circling back after I think this note in the example is
important and helpful.

Switch to INSTKERNNAME, switch "KODIR and INSTKERNNAME" to or instead of
and, thanks @jhb! Still reflecting on what to do with LOCAL_MODULES.

New code should have the shorter text. We cannot change licenses of existing code unless lots of corner circumstances.

Check out https://docs.freebsd.org/en/articles/license-guide/ or style.9 from current, there is a much shorter text you can use now.

I'm sorry I didn't mean for you to change it, I was just wondering

This is actually probably unhelpful, sorry for the noise.

+ add testing one kernel example from UPDATING
+ add KODIR to ENVIRONMENT
+ use reboot in all examples for consistency
+ add example numbers for referencability

I disgraced the commit log here. @emaste did not review this. I was thinking of him teaching me about Makefile but that was a completely different review.

Thank you so much @ivy!

Flesh out a bit more from UPDATING.

Thank you gentlemen.

A level 0 dump is like dd. It gets absolutely everything, unlike a boot environment. I'll work on that after I merge this one.

Are these Function Arguments? Can I alphabetize these?

That's a great idea, thank you! I didn't notice because I put them in src.conf.

fix typo

Update with the things I learned making iwx.4.
+ getting creative with rc.conf breaks at least ansible
+ give debug synopsis example for maximum debug
+ consolidate firmware in Sh files
+ explain that the driver can be configured with ifconfig/rc.conf

Sorry for the delay, this is waiting on USB support for fwget(8), which is waiting on another patch under review.

Related https://reviews.freebsd.org/D48905