From ca6a9127c64d467e9a3c613ef094c669946e7b70 Mon Sep 17 00:00:00 2001 From: per1234 Date: Fri, 24 Jun 2022 18:56:44 -0700 Subject: [PATCH] Remove obsolete compilation error interpretations The Arduino IDE attempts to provide some additional guidance to users based on matches against compilation error messages. This practice was established during a time when some significant breaking changes were made to the common APIs in order to ease the transition. Since that time, the practice has mostly been discontinued. The interpretations are only valid for very old code that is unlikely to be used by the target users now. So their benefit is negligible. The patterns used are inexact, meaning that the interpretations may be printed inappropriately, which is more and more likely as the cases where the matches would be valid become increasingly rare. When the maintenance burden is taken into consideration, it is clear that the harm is far more than any benefits from these. So they are removed. Notes for specific interpretations: > Please import the SPI library from the Sketch > Import Library menu. > As of Arduino 0019, the Ethernet library depends on the SPI library. > You appear to be using it or another library that depends on the SPI library. The target error was more common prior to Arduino IDE 1.6.6 (released ~6.5 years ago), when it was necessary for the sketch to contain `#include` directives for transitive in addition to direct library dependencies (SPI is a common transitive dependency). Due to the nature of the SPI library, it is not often used directly, and when it is used directly it is done by more advanced users who are unlikely to forget the `#include` directive and would have no need for this interpretation even if they did. It is far more likely for the user to forget an `#include` for a popular library, yet Arduino rightly does not attempt to maintain interpretations for those. The "Sketch > Import Library" menu path was renamed to "Sketch > Include Library" ~7 years ago. Arduino IDE 0019 was released ~12 years ago. We can safely assume the migration to the new Ethernet API is complete. > The 'BYTE' keyword is no longer supported. > As of Arduino 1.0, the 'BYTE' keyword is no longer supported. > Please use Serial.write() instead. Arduino IDE 1.0 was released ~10.5 years ago. We can safely assume the migration to the new Serial API is complete. This compilation error pattern is now far more likely to occur due to incorrect usage of a completely unrelated occurrence of the common `BYTE` name in the user's code. > The Server class has been renamed EthernetServer. > As of Arduino 1.0, the Server class in the Ethernet library has been renamed to EthernetServer. > The Client class has been renamed EthernetClient. > As of Arduino 1.0, the Client class in the Ethernet library has been renamed to EthernetClient. > The Udp class has been renamed EthernetUdp. > As of Arduino 1.0, the Udp class in the Ethernet library has been renamed to EthernetUdp. Arduino IDE 1.0 was released ~10.5 years ago. We can safely assume the migration to the new Ethernet API is complete. The compilation error patterns are in no way specific to the Ethernet library so is prone to false positives. > Wire.send() has been renamed Wire.write(). > As of Arduino 1.0, the Wire.send() function was renamed to Wire.write() for consistency with other libraries. > Wire.receive() has been renamed Wire.read(). > As of Arduino 1.0, the Wire.receive() function was renamed to Wire.read() for consistency with other libraries. Arduino IDE 1.0 was released ~10.5 years ago. We can safely assume the migration to the new Wire API is complete. Due to the nature of the Wire library, it is not often used directly, and when it is used directly it is done by more advanced users who have less need for an interpretation of the compiler error. > 'Mouse' not found. Does your sketch include the line '#include '? > 'Keyboard' not found. Does your sketch include the line '#include '? I left these in because they are the most "recent" (added due to a breaking change made 7 years ago). However, I also feel that these are harmful and should either be removed or changed. The problem is that there is a false match when the user attempts to compile the Keyboard or Mouse libraries for a board which does not have native USB support (e.g., Uno, Mega), even when their sketch does contain the `#include` directives that are recommended by the interpretation. That cause of the compilation error matching the pattern is more common than the case where the user is compiling old code or forgot the `#include` directive, for which the interpretation is valid. --- .../src/node/cli-error-parser.ts | 70 ------------------- i18n/en.json | 16 +---- 2 files changed, 1 insertion(+), 85 deletions(-) diff --git a/arduino-ide-extension/src/node/cli-error-parser.ts b/arduino-ide-extension/src/node/cli-error-parser.ts index 25148250f..b002742c6 100644 --- a/arduino-ide-extension/src/node/cli-error-parser.ts +++ b/arduino-ide-extension/src/node/cli-error-parser.ts @@ -149,76 +149,6 @@ function remapErrorMessages(result: ParseResult): ParseResult { // Based on the Java IDE: https://github.com/arduino/Arduino/blob/43b0818f7fa8073301db1b80ac832b7b7596b828/arduino-core/src/cc/arduino/Compiler.java#L528-L578 const KnownErrors: Record = { - 'SPI.h: No such file or directory': { - error: nls.localize( - 'arduino/cli-error-parser/spiError', - 'Please import the SPI library from the Sketch > Import Library menu.' - ), - message: nls.localize( - 'arduino/cli-error-parser/spiMessage', - 'As of Arduino 0019, the Ethernet library depends on the SPI library.\nYou appear to be using it or another library that depends on the SPI library.' - ), - }, - "'BYTE' was not declared in this scope": { - error: nls.localize( - 'arduino/cli-error-parser/byteError', - "The 'BYTE' keyword is no longer supported." - ), - message: nls.localize( - 'arduino/cli-error-parser/byteMessage', - "As of Arduino 1.0, the 'BYTE' keyword is no longer supported.\nPlease use Serial.write() instead." - ), - }, - "no matching function for call to 'Server::Server(int)'": { - error: nls.localize( - 'arduino/cli-error-parser/serverError', - 'The Server class has been renamed EthernetServer.' - ), - message: nls.localize( - 'arduino/cli-error-parser/serverMessage', - 'As of Arduino 1.0, the Server class in the Ethernet library has been renamed to EthernetServer.' - ), - }, - "no matching function for call to 'Client::Client(byte [4], int)'": { - error: nls.localize( - 'arduino/cli-error-parser/clientError', - 'The Client class has been renamed EthernetClient.' - ), - message: nls.localize( - 'arduino/cli-error-parser/clientMessage', - 'As of Arduino 1.0, the Client class in the Ethernet library has been renamed to EthernetClient.' - ), - }, - "'Udp' was not declared in this scope": { - error: nls.localize( - 'arduino/cli-error-parser/udpError', - 'The Udp class has been renamed EthernetUdp.' - ), - message: nls.localize( - 'arduino/cli-error-parser/udpMessage', - 'As of Arduino 1.0, the Udp class in the Ethernet library has been renamed to EthernetUdp.' - ), - }, - "'class TwoWire' has no member named 'send'": { - error: nls.localize( - 'arduino/cli-error-parser/sendError', - 'Wire.send() has been renamed Wire.write().' - ), - message: nls.localize( - 'arduino/cli-error-parser/sendMessage', - 'As of Arduino 1.0, the Wire.send() function was renamed to Wire.write() for consistency with other libraries.' - ), - }, - "'class TwoWire' has no member named 'receive'": { - error: nls.localize( - 'arduino/cli-error-parser/receiveError', - 'Wire.receive() has been renamed Wire.read().' - ), - message: nls.localize( - 'arduino/cli-error-parser/receiveMessage', - 'As of Arduino 1.0, the Wire.receive() function was renamed to Wire.read() for consistency with other libraries.' - ), - }, "'Mouse' was not declared in this scope": { error: nls.localize( 'arduino/cli-error-parser/mouseError', diff --git a/i18n/en.json b/i18n/en.json index 46e0c4488..eb0d7ed76 100644 --- a/i18n/en.json +++ b/i18n/en.json @@ -57,22 +57,8 @@ "uploadingCertificates": "Uploading certificates." }, "cli-error-parser": { - "byteError": "The 'BYTE' keyword is no longer supported.", - "byteMessage": "As of Arduino 1.0, the 'BYTE' keyword is no longer supported.\nPlease use Serial.write() instead.", - "clientError": "The Client class has been renamed EthernetClient.", - "clientMessage": "As of Arduino 1.0, the Client class in the Ethernet library has been renamed to EthernetClient.", "keyboardError": "'Keyboard' not found. Does your sketch include the line '#include '?", - "mouseError": "'Mouse' not found. Does your sketch include the line '#include '?", - "receiveError": "Wire.receive() has been renamed Wire.read().", - "receiveMessage": "As of Arduino 1.0, the Wire.receive() function was renamed to Wire.read() for consistency with other libraries.", - "sendError": "Wire.send() has been renamed Wire.write().", - "sendMessage": "As of Arduino 1.0, the Wire.send() function was renamed to Wire.write() for consistency with other libraries.", - "serverError": "The Server class has been renamed EthernetServer.", - "serverMessage": "As of Arduino 1.0, the Server class in the Ethernet library has been renamed to EthernetServer.", - "spiError": "Please import the SPI library from the Sketch > Import Library menu.", - "spiMessage": "As of Arduino 0019, the Ethernet library depends on the SPI library.\nYou appear to be using it or another library that depends on the SPI library.", - "udpError": "The Udp class has been renamed EthernetUdp.", - "udpMessage": "As of Arduino 1.0, the Udp class in the Ethernet library has been renamed to EthernetUdp." + "mouseError": "'Mouse' not found. Does your sketch include the line '#include '?" }, "cloud": { "account": "Account",