[handbook] Add a section to about switching pkg from the quarterly branch to the latest branch

[carlavilla]

Summary

[handbook] Add a section to about switching pkg from the quarterly branch to the latest branch.

PR: 228333

Test Plan

Compile the handbook.

[bcr]

A few minor additions and clarifications, mostly tags.

en_US.ISO8859-1/books/handbook/ports/chapter.xml

537 ↗

(On Diff #69767)

s/Quarterly branch/The Quarterly branch is/

539 ↗

(On Diff #69767)

What do you mean with the name part of this sentence (the one after the comma)?

543 ↗

(On Diff #69767)

I'd enclose "Latest" with <literal> tags (same above for "Quarterly").

554 ↗

(On Diff #69767)

Enclose the "url:" in <literal> tags, too.

[carlavilla]

Fixed. Thanks.

[bcr]

Good, looks better now. Commit it!

head/en_US.ISO8859-1/books/handbook/ports/chapter.xml

 static void        run_rt2870_set_chan(struct run_softc *, u_int);
 static void        run_rt3070_set_chan(struct run_softc *, u_int);
 static void        run_rt3572_set_chan(struct run_softc *, u_int);
 static void        run_rt3593_set_chan(struct run_softc *, u_int);
 static void        run_rt5390_set_chan(struct run_softc *, u_int);
 static void        run_rt5592_set_chan(struct run_softc *, u_int);
 static int        run_set_chan(struct run_softc *, struct ieee80211_channel *);
 static void        run_set_channel(struct ieee80211com *);
+static void        run_getradiocaps(struct ieee80211com *, int, int *,
+                    struct ieee80211_channel[]);
 static void        run_scan_start(struct ieee80211com *);
 static void        run_scan_end(struct ieee80211com *);
 static void        run_update_beacon(struct ieee80211vap *, int);
 static void        run_update_beacon_cb(void *);
 static void        run_updateprot(struct ieee80211com *);
 static void        run_updateprot_cb(void *);
 static void        run_usb_timeout_cb(void *);
 static void        run_reset_livelock(struct run_softc *);

 
 static int
 run_attach(device_t self)
 {
         struct run_softc *sc = device_get_softc(self);
         struct usb_attach_arg *uaa = device_get_ivars(self);
         struct ieee80211com *ic = &sc->sc_ic;
         uint32_t ver;
-        uint8_t bands[IEEE80211_MODE_BYTES];
         uint8_t iface_index;
         int ntries, error;
 
         device_set_usb_desc(self);
         sc->sc_udev = uaa->device;
         sc->sc_dev = self;
         if (USB_GET_DRIVER_INFO(uaa) != RUN_EJECT)
                 sc->sc_flags |= RUN_FLAG_FWLOAD_NEEDED;
ic->ic_cryptocaps =
             IEEE80211_CRYPTO_WEP |
             IEEE80211_CRYPTO_AES_CCM |
             IEEE80211_CRYPTO_TKIPMIC |
             IEEE80211_CRYPTO_TKIP;
 
         ic->ic_flags |= IEEE80211_F_DATAPAD;
         ic->ic_flags_ext |= IEEE80211_FEXT_SWBMISS;
 
-        memset(bands, 0, sizeof(bands));
-        setbit(bands, IEEE80211_MODE_11B);
-        setbit(bands, IEEE80211_MODE_11G);
-        if (sc->rf_rev == RT2860_RF_2750 || sc->rf_rev == RT2860_RF_2850 ||
-            sc->rf_rev == RT3070_RF_3052 || sc->rf_rev == RT3593_RF_3053 ||
-            sc->rf_rev == RT5592_RF_5592)
-                setbit(bands, IEEE80211_MODE_11A);
-        ieee80211_init_channels(ic, NULL, bands);
+        run_getradiocaps(ic, IEEE80211_CHAN_MAX, &ic->ic_nchans,
+            ic->ic_channels);
 
         ieee80211_ifattach(ic);
 
         ic->ic_scan_start = run_scan_start;
         ic->ic_scan_end = run_scan_end;
         ic->ic_set_channel = run_set_channel;
+        ic->ic_getradiocaps = run_getradiocaps;
         ic->ic_node_alloc = run_node_alloc;
         ic->ic_newassoc = run_newassoc;
         ic->ic_updateslot = run_updateslot;
         ic->ic_update_mcast = run_update_mcast;
         ic->ic_wme.wme_update = run_wme_update;
         ic->ic_raw_xmit = run_raw_xmit;
         ic->ic_update_promisc = run_update_promisc;
         ic->ic_vap_create = run_vap_create;

 {
         struct run_softc *sc = ic->ic_softc;
 
         RUN_LOCK(sc);
         run_set_chan(sc, ic->ic_curchan);
         RUN_UNLOCK(sc);
 
         return;
+}
+
+static void
+run_getradiocaps(struct ieee80211com *ic,
+    int maxchans, int *nchans, struct ieee80211_channel chans[])
+{
+        struct run_softc *sc = ic->ic_softc;
+        uint8_t bands[IEEE80211_MODE_BYTES];
+
+        memset(bands, 0, sizeof(bands));
+        setbit(bands, IEEE80211_MODE_11B);
+        setbit(bands, IEEE80211_MODE_11G);
+        ieee80211_add_channel_list_2ghz(chans, maxchans, nchans,
+            run_chan_2ghz, nitems(run_chan_2ghz), bands, 0);
+
+        if (sc->rf_rev == RT2860_RF_2750 || sc->rf_rev == RT2860_RF_2850 ||
+            sc->rf_rev == RT3070_RF_3052 || sc->rf_rev == RT3593_RF_3053 ||
+            sc->rf_rev == RT5592_RF_5592) {
+                setbit(bands, IEEE80211_MODE_11A);
+                ieee80211_add_channel_list_5ghz(chans, maxchans, nchans,
+                    run_chan_5ghz, nitems(run_chan_5ghz), bands, 0);
+        }
 }
 
 static void
 run_scan_start(struct ieee80211com *ic)
 {
         struct run_softc *sc = ic->ic_softc;
         uint32_t tmp;