Trim BottleImage doc comment and rejoin the brew docs list

Author: andrew

docs/configuration.md

@@ -1674,7 +1674,6 @@ proxy mirror --platform linux/arm64 pkg:brew/hello@2.12.3 pkg:brew/openssl%403
 ```
 
 - A formula name with `@` is written with `%40`, since `@` starts the version: `pkg:brew/openssl%403` is `openssl@3`, and `pkg:brew/openssl@3` is version 3 of `openssl`.
-
 - The formula's JSON API on `upstream.homebrew_api` gives the image tag for the current version, which carries the formula's revision and the bottles' rebuild (`hello` 2.12.3 is tagged `2.12.3-1`). Only the current version is described there; another version is used as the tag as given, so give the full tag, such as `2.12.2` or `2.12.3-1`, for older bottles.
 - A PURL without a version mirrors the current version.
 - `--platform` selects bottles like image platforms: `linux/arm64`, `linux/amd64`, or `darwin/arm64` for every macOS release's arm64 bottle. Without it every bottle of the version is mirrored.

internal/handler/homebrew_bottles.go

@@ -35,13 +35,9 @@ type homebrewFormula struct {
 	} `json:"bottle"`
 }
 
-// BottleImage returns the image Homebrew publishes the bottles of a
-// homebrew/core formula version under, as brew pulls them through
-// HOMEBREW_ARTIFACT_DOMAIN: openssl@3 is homebrew/core/openssl/3, and the tag
-// carries the formula's revision and the bottles' rebuild, so hello 2.12.3
-// with rebuild 1 is tagged 2.12.3-1. Only the current version is described by
-// the JSON API; any other version is used as the tag as given, which also
-// takes a tag such as 2.12.3-1 directly.
+// BottleImage returns the homebrew/core image and tag for a formula version.
+// Only the current version gets its revision and rebuild from the JSON API;
+// any other version is used as the tag as given.
 func (h *HomebrewHandler) BottleImage(ctx context.Context, formula, version string) (ImageRef, error) {
 	if !homebrewFormulaPattern.MatchString(formula) {
 		return ImageRef{}, fmt.Errorf("invalid Homebrew formula name %q", formula)