freebsd
networking.7 : create network quickstart guide
Now that the handbook has been moved to ports, I think it's very nice to have a network quickstart guide in-band, in base, in the system manual. If the user uses any of the following terms "man -k {network,networking,wifi,quickstart}" this page will come up, which is I think a very, very common use case for new users.
FreeBSD is the server star, but new users will need to play with it on their laptops before trying to use it in production, right?
Currently, this document explains connecting to a basic Ethernet network, USB tethering, a basic wifi network, scanning for wifi networks, and airplane mode, as well as linking to a few other relevant pages and sections, including the handbook.
Sorry, ignore the urndis(4) pollution above. A consequence of me attempting to work with a PR in a fork in advance of a simple PR hereabouts.
Sorry, ignore the urndis(4) pollution above. A consequence of me attempting to work with a PR in a fork in advance of a simple PR hereabouts.
No, that's beautiful. I completely forgot about USB tethering. It should be mentioned here.
I think it's less legible, but I rewrote the examples to format accordingly to style.mdoc(5), except without the depreciated Li macro. The guideline laid out there breaks a lot of mdoc conventions. The It macro is stated in mdoc(7) to be for individual commands and explicitly not entire lines. Also, subsections have their own macro, and I think they're appropriate for this use case. I have a copy with all the changes but the earlier formatting. Thoughts?
This commit needs to have a real email, not the noreply github one,
@concussious this is still not addressed
This commit needs to have a real email, not the noreply github one,
@concussious this is still not addressed
I'm sorry, I thought that I did, and I don't understand.
https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address
you need to set the commit email in your git cli, then go back rewrite the author: https://stackoverflow.com/questions/750172/how-do-i-change-the-author-and-committer-name-email-for-multiple-commits#1320317
Should I squash all these commits down to one like I was instructed to in the other thread? If so, will that negatively impact the commits coauthored with grahamperrin?
I asked @grahamperrin to chime in on whether he minds getting squashed. meanwhile, you can credit yourself as the author of this man page, if you so desire, on the bottom in an .Sh AUTHORS section.
In such a case should we add him to the copyright at the top?
if you want, sure. your call
@bsdbcr Can you review this in more detail. It seems OK to me, but I'm not sure it belongs here. Thanks!
@bsdbcr Can you review this in more detail. It seems OK to me, but I'm not sure it belongs here. Thanks!
I've reviewed the changes. That looks solid and would be a good addition to our docs. Nothing to change, add, or complain about.
I'd like it to say something better about turning wifi off. "Service netif stop" stops all networking, so local services that use networking as an ipc, such as musicpd, will also break.
Musicpd is maybe a bad example because you can configure it with a unix socket instead.
I'm also concerned about I don't want to mislead anyone. The first step of connecting to a network is configuring a firewall, unless the entire machine is already behind a firewall, which I think is kind of an advanced use case.
EDIT: Sorry for the noise, it occurred to me that these files cannot be listed in intro(7) because they're all made conditionally. I have reverted the commit described in this comment below.
I just discovered intro(7) lists all the pages in section seven. Therefore, I have added this and everything else my 14.0-R-p3 machine has in /usr/share/man/man7/ to intro(7).
While there, I also zapped old tags, added spdx, and updated the history section to the same format used in the new hier(7).
OK. This isn't getting any better, and hans't for a while. It looks good as is. I'll leave the intro issue for others.