+1 > On Jul 29, 2016, at 11:50 AM, Stephen Chang <[email protected]> wrote: > > 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/F3E393ED-34D9-4E65-AE36-447C5E939266%40knauth.org. For more options, visit https://groups.google.com/d/optout.
