User Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

cl:types:style-warning [2017/05/01 21:00] (current)
Line 1: Line 1:
 +====== Condition Type STYLE-WARNING ======
 +
 +====Class Precedence List====
 +**warning**,​ **[[CL:​Types:​warning]]**,​ **[[CL:​Types:​condition]]**,​ **[[CL:​Types:​t]]**
 +
 +====Description====
 +The type **style-warning** includes those //​[[CL:​Glossary:​condition|conditions]]//​ that represent //​[[CL:​Glossary:​situations]]//​ involving //​[[CL:​Glossary:​code]]//​ that is //​[[CL:​Glossary:​conforming code]]// but that is nevertheless considered to be faulty or substandard.
 +
 +====See Also====
 +**[[CL:​Functions:​muffle-warning|Function MUFFLE-WARNING]]**
 +
 +====Notes====
 +An //​[[CL:​Glossary:​implementation]]//​ might signal such a //​[[CL:​Glossary:​condition]]//​ if it encounters //​[[CL:​Glossary:​code]]//​ that uses deprecated features or that appears unaesthetic or inefficient.
 +
 +An "​unused variable"​ warning must be of type **style-warning**.
 +
 +In general, the question of whether //​[[CL:​Glossary:​code]]//​ is faulty or substandard is a subjective decision to be made by the facility processing that //​[[CL:​Glossary:​code]]//​. The intent is that whenever such a facility wishes to complain about //​[[CL:​Glossary:​code]]//​ on such subjective grounds, it should use this //​[[CL:​Glossary:​condition]]//​ //​[[CL:​Glossary:​type]]//​ so that any clients who wish to redirect or muffle superfluous warnings can do so without risking that they will be redirecting or muffling other, more serious warnings.
 +