Fix docs typos, add \see, and rename brief

Author: will-v-pi

src/rp2_common/pico_bootrom/include/pico/bootrom.h

@@ -1046,11 +1046,12 @@ static inline int rom_get_last_boot_type(void) {
  */
 int rom_add_flash_runtime_partition(uint32_t start_offset, uint32_t size, uint32_t permissions);
 
-/*! \brief  Pick A/B partition for a separate partition
+/*! \brief  Pick A/B partition with TBYB guards
  * \ingroup pico_bootrom
  *
  * This will call `rom_pick_ab_partition` with the current `flash_update_boot_window_base`, while performing extra checks to prevent disrupting a main image TBYB.
  * It requires the same minimum workarea size as `rom_pick_ab_partition`.
+ * \see rom_pick_ab_partition()
  * 
  * For example, if an `explicit_buy` is pending then calling `pick_ab_partition` would normally clear the saved `flash_erase_addr` so the required erase would not
  * occur when `explicit_buy` is called - this function saves and restores that address to prevent this issue, and returns `BOOTROM_ERROR_NOT_PERMITTED` if the
@@ -1061,8 +1062,8 @@ int rom_add_flash_runtime_partition(uint32_t start_offset, uint32_t size, uint32
  *
  * \param workarea_base base address of work area
  * \param workarea_size size of work area
- * @param partition_a_num the A partition of the pair
- * @return >= 0 the partition number picked
+ * \param partition_a_num the A partition of the pair
+ * \return >= 0 the partition number picked
  *         BOOTROM_ERROR_NOT_PERMITTED if not possible to do an update correctly, eg if both main image and data image are TBYB
  *         BOOTROM_ERROR_NOT_FOUND if the chosen partition failed verification
  */