Spurious triggers of hardcoded Udp -> EthernetUdp migration error enhancement causes confusion

Arduino often calls static methods like Wifi.begin(). When reading the documentation on Arduino's WiFiSendReceiveUDPString page, if you don't pay attention to the declaration "WiFiUDP Udp" you will assume that the "Udp" in the code samples is a static class.

Not a problem though, if you don't declare "WiFiUDP Udp", you will just get an error that variable is missing, right? No. You get the error that Udp was renamed to EthernetUdp. And now you're off on a wild goose chase trying to figure out what EthernetUdp is and where to get that library.

My suggestion is either change the documentation and set "WiFiUDP udp", making it obvious that "udp" is a variable, or remove the error that says Udp has been changed to EthernetUdp and make it clear that the variable is not declared.

[matthijskooijman]

No. You get an error that Udp was renamed to EthernetUdp

Huh? Can you show the full error that you get? I'm wondering how that error is generated, I'm not aware of any compiler errors about "renaming" variables?

Try it yourself. Here's all you need:

void setup() {
  Udp.endPacket();
}

void loop() {

}

And you get the following error:

sketch_jan13b:3:3: error: The Udp class has been renamed EthernetUdp.
As of Arduino 1.0, the Udp class in the Ethernet library has been renamed to EthernetUdp.


   Udp.endPacket();

   ^

exit status 1
The Udp class has been renamed EthernetUdp.

[facchinm]

This is a problem with the "fancy errors" that are handled by the IDE trying to be friendly with the user (see

Arduino/arduino-core/src/cc/arduino/Compiler.java

Lines 554 to 557 in b5bfe08

	if (error.trim().equals("'Udp' was not declared in this scope")) {
	error = tr("The Udp class has been renamed EthernetUdp.");
	msg = tr("\nAs of Arduino 1.0, the Udp class in the Ethernet library " +
	"has been renamed to EthernetUdp.\n\n");

)
Some of them don't even apply anymore or are related with 0.x -> 1 transition (which happened eons ago) so getting rid of them shouldn't harm too much.
@cmaglie what should we do?

[cmaglie]

I guess it's time to remove them.

[hilldweller2]

I know this is an old thread but it just saved me.
All I did was type Udp. instead of udp. And then my brain got hammered by an absurd incorrect error message.
Never mind, I still love Arduino to bits. It's just so (usually) user friendly.