Would anyone object if I removed mention of syntax-id-rules from the Guide (and added a "deprecated" warning in the reference)?
I think the documentation should not give the impression that syntax-id-rules is idiomatic Racket since it will confuse beginners. syntax-id-rules is poorly designed because (syntax-id-rules [id ....]) seems like it should create a rename-transformer-like identifier macro that matches only identifiers but instead it matches "any". The Guide example itself suffers from this buggy behavior. I realize that there has already been a lot of discussion about changing or replacing the macros section of the Guide but the part about syntax-id-rules is particularly misleading for users and needs to be updated sooner rather than later. At least one large project, Rosette, had some bugs that I suspect are due to the Guide's influence. -- You received this message because you are subscribed to the Google Groups "Racket Developers" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/racket-dev/CAFfiA1%2Bn_F3vX39%3DMBNjut3Qz9xJACiv1bFsFZUSvv13%2BwKf1g%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
