Improve extended examination text for many objects (#31381)

Plurality, capitalization, punctuation, and item icons have been
improved. Status displays now show the same text on examination that
they do visually. Inducers only show a success message when they
actually succeed.

code/game/objects/items/bodybag.dm

@@ -36,7 +36,8 @@
 /obj/item/bodybag/bluespace/examine(mob/user)
 	..()
 	if(contents.len)
-		to_chat(user, "<span class='notice'>You can make out the shapes of [contents.len] objects through the fabric.</span>")
+		var/s = contents.len == 1 ? "" : "s"
+		to_chat(user, "<span class='notice'>You can make out the shape[s] of [contents.len] object[s] through the fabric.</span>")
 
 /obj/item/bodybag/bluespace/Destroy()
 	for(var/atom/movable/A in contents)

code/game/objects/items/crayons.dm

@@ -549,7 +549,7 @@
 /obj/item/toy/crayon/spraycan/examine(mob/user)
 	. = ..()
 	if(charges_left)
-		to_chat(user, "It has [charges_left] uses left.")
+		to_chat(user, "It has [charges_left] use\s left.")
 	else
 		to_chat(user, "It is empty.")
 

code/game/objects/items/devices/radio/radio.dm

@@ -512,9 +512,9 @@
 /obj/item/device/radio/examine(mob/user)
 	..()
 	if (b_stat)
-		to_chat(user, "<span class='notice'>[name] can be attached and modified.</span>")
+		to_chat(user, "<span class='notice'>It can be attached and modified.</span>")
 	else
-		to_chat(user, "<span class='notice'>[name] can not be modified or attached.</span>")
+		to_chat(user, "<span class='notice'>It cannot be modified or attached.</span>")
 
 /obj/item/device/radio/attackby(obj/item/W, mob/user, params)
 	add_fingerprint(user)

code/game/objects/items/extinguisher.dm

@@ -68,7 +68,7 @@
 /obj/item/extinguisher/examine(mob/user)
 	..()
 	if(reagents.total_volume)
-		to_chat(user, "It contains [round(reagents.total_volume)] units.")
+		to_chat(user, "It contains [round(reagents.total_volume)] unit\s.")
 		to_chat(user, "<span class='notice'>Alt-click to empty it.</span>")
 	else
 		to_chat(user, "It is empty.")

code/game/objects/items/flamethrower.dm

@@ -144,7 +144,7 @@
 /obj/item/flamethrower/examine(mob/user)
 	..()
 	if(ptank)
-		to_chat(user, "<span class='notice'>\The [src] has \the [ptank] attached. Alt-click to remove it.</span>")
+		to_chat(user, "<span class='notice'>\The [src] has \a [ptank] attached. Alt-click to remove it.</span>")
 
 /obj/item/flamethrower/proc/toggle_igniter(mob/user)
 	if(!ptank)

code/game/objects/items/inducer.dm

@@ -48,15 +48,15 @@
 
 /obj/item/inducer/proc/cantbeused(mob/user)
 	if(!user.IsAdvancedToolUser())
-		to_chat(user, "<span class='warning'>You don't have the dexterity to use \the [src]!</span>")
+		to_chat(user, "<span class='warning'>You don't have the dexterity to use [src]!</span>")
 		return TRUE
 
 	if(!cell)
-		to_chat(user, "<span class='warning'>\The [src] doesn't have a power cell installed!</span>")
+		to_chat(user, "<span class='warning'>[src] doesn't have a power cell installed!</span>")
 		return TRUE
 
 	if(!cell.charge)
-		to_chat(user, "<span class='warning'>\The [src]'s battery is dead!</span>")
+		to_chat(user, "<span class='warning'>[src]'s battery is dead!</span>")
 		return TRUE
 	return FALSE
 
@@ -79,12 +79,12 @@
 			if(!cell)
 				if(!user.transferItemToLoc(W, src))
 					return
-				to_chat(user, "<span class='notice'>You insert \the [W] into \the [src].</span>")
+				to_chat(user, "<span class='notice'>You insert [W] into [src].</span>")
 				cell = W
 				update_icon()
 				return
 			else
-				to_chat(user, "<span class='notice'>\The [src] already has \a [cell] installed!</span>")
+				to_chat(user, "<span class='notice'>[src] already has \a [cell] installed!</span>")
 				return
 
 	if(cantbeused(user))
@@ -110,15 +110,17 @@
 	if(istype(A, /obj))
 		O = A
 	if(C)
+		var/done_any = FALSE
 		if(C.charge >= C.maxcharge)
-			to_chat(user, "<span class='notice'>\The [A] is fully charged!</span>")
+			to_chat(user, "<span class='notice'>[A] is fully charged!</span>")
 			recharging = FALSE
 			return TRUE
-		user.visible_message("[user] starts recharging \the [A] with \the [src]","<span class='notice'>You start recharging [A] with \the [src]</span>")
+		user.visible_message("[user] starts recharging [A] with [src].","<span class='notice'>You start recharging [A] with [src].</span>")
 		while(C.charge < C.maxcharge)
 			if(E)
 				E.chambered = null  // Prevents someone from firing continuously while recharging the gun.
 			if(do_after(user, 10, target = user) && cell.charge)
+				done_any = TRUE
 				induce(C, coefficient)
 				do_sparks(1, FALSE, A)
 				if(O)
@@ -127,7 +129,8 @@
 				break
 		if(E)
 			E.recharge_newshot() //We're done charging, so we'll let someone fire it now.
-		user.visible_message("[user] recharged \the [A]!","<span class='notice'>You recharged \the [A]!</span>")
+		if(done_any) // Only show a message if we succeeded at least once
+			user.visible_message("[user] recharged [A]!","<span class='notice'>You recharged [A]!</span>")
 		recharging = FALSE
 		return TRUE
 	recharging = FALSE
@@ -147,7 +150,7 @@
 
 /obj/item/inducer/attack_self(mob/user)
 	if(opened && cell)
-		user.visible_message("[user] removes \the [cell] from \the [src]!","<span class='notice'>You remove \the [cell].</span>")
+		user.visible_message("[user] removes [cell] from [src]!","<span class='notice'>You remove [cell].</span>")
 		cell.update_icon()
 		user.put_in_hands(cell)
 		cell = null
@@ -157,11 +160,11 @@
 /obj/item/inducer/examine(mob/living/M)
 	..()
 	if(cell)
-		to_chat(M, "<span class='notice'>It's display shows: [DisplayPower(cell.charge)]</span>")
+		to_chat(M, "<span class='notice'>Its display shows: [DisplayPower(cell.charge)].</span>")
 	else
-		to_chat(M,"<span class='notice'>It's display is dark.</span>")
+		to_chat(M,"<span class='notice'>Its display is dark.</span>")
 	if(opened)
-		to_chat(M,"<span class='notice'>It's battery compartment is open.</span>")
+		to_chat(M,"<span class='notice'>Its battery compartment is open.</span>")
 
 /obj/item/inducer/update_icon()
 	cut_overlays()
@@ -174,7 +177,7 @@
 /obj/item/inducer/sci
 	icon_state = "inducer-sci"
 	item_state = "inducer-sci"
-	desc = "A tool for inductively charging internal power cells. This one has a science color scheme, and is less potent than it's engineering counterpart."
+	desc = "A tool for inductively charging internal power cells. This one has a science color scheme, and is less potent than its engineering counterpart."
 	cell_type = null
 	powertransfer = 500
 	opened = TRUE

code/game/objects/items/pneumaticCannon.dm

@@ -38,10 +38,10 @@
 		out += "<span class='notice'>You'll need to get closer to see any more.</span>"
 		return
 	for(var/obj/item/I in loadedItems)
-		out += "<span class='info'>[icon2html(I, user)] It has \the [I] loaded.</span>"
+		out += "<span class='info'>[icon2html(I, user)] It has \a [I] loaded.</span>"
 		CHECK_TICK
 	if(tank)
-		out += "<span class='notice'>[icon2html(tank, user)] It has \the [tank] mounted onto it.</span>"
+		out += "<span class='notice'>[icon2html(tank, user)] It has \a [tank] mounted onto it.</span>"
 	to_chat(user, out.Join("<br>"))
 
 /obj/item/pneumatic_cannon/attackby(obj/item/W, mob/user, params)

code/game/objects/items/powerfist.dm

@@ -26,7 +26,7 @@
 		to_chat(user, "<span class='notice'>You'll need to get closer to see any more.</span>")
 		return
 	if(tank)
-		to_chat(user, "<span class='notice'>[icon2html(tank, user)] It has \the [tank] mounted onto it.</span>")
+		to_chat(user, "<span class='notice'>[icon2html(tank, user)] It has \a [tank] mounted onto it.</span>")
 
 
 /obj/item/melee/powerfist/attackby(obj/item/W, mob/user, params)

code/game/objects/items/toys.dm

@@ -840,7 +840,7 @@
 	if(ishuman(user))
 		var/mob/living/carbon/human/cardUser = user
 		if(cardUser.is_holding(src))
-			cardUser.visible_message("[cardUser] checks [cardUser.p_their()] card.", "<span class='notice'>The card reads: [cardname]</span>")
+			cardUser.visible_message("[cardUser] checks [cardUser.p_their()] card.", "<span class='notice'>The card reads: [cardname].</span>")
 		else
 			to_chat(cardUser, "<span class='warning'>You need to have the card in your hand to check it!</span>")