metaperl:

I've never used Parse::RecDescent before, but I keep meaning to. So I did a quick read of the FAQ, and here are my notes as a newbie to the module.

• The body of section Is Parse::RecDescent LL(1)? LL(N)? LR(1)? LR(N)? doesn't answer the question in the header. (In fact, the question remains unanswered in this section.) The body appears to be asking how to connect semantic actions with specific grammar productions. So I'd give that question a new header, e.g., How do I connect semantics to my grammar rules?. But keep the heading and give it a blank (until answered) body, as that's an interesting question that I would answer.
• In Insuring a top-level rule match, the code referenced doesn't show up. It would be nice to see what the inquirer was talking about. If it's a long chunk of code, you might refer them to another page (or an appendix in the FAQ). You might want to point them to section Commit in subrule which is optional in rule also, as it appears to be related. (And shouldn't that be Ensuring in the title? I'm no grammarian, so I'm not certain.)
• Sometimes the module is abbreviated to PRD and in other locations as P::RD. You might want to make them all the same. (You may also want to add abbrev tags to them, too.)
• s/Ques:/Question:/ in section Commit in subrule which is optional in rule.
• In several areas, you give a link as the answer. You might want to include a brief summary of the answer so the reader can tell if they want to follow the link. For example, in Macro processing the answer points to a PerlMonks discussion. But that thread doesn't really have a definitive answer.
• Hmmm ... in Incremental generation of data structure representing parse you restate the question from Is Parse::RecDescent LL(1)? LL(N)? LR(1)? LR(N)? with an answer. Perhaps the original question was lost in a copy/paste accident?
• A large portion of the body of section Double vs Single-quoted strings appears earlier in the FAQ. Perhaps that item should simply refer them to this one?
• Section Unconditionally listifying scalars appears to be unanswered.
• Under heading "Mastering Regular Expressions" by Jeffrey Freidl, there's no link. Is this referring to the previous item? If so, I'd remove the heading annotation and move it before the link. If not, then the link to the content is missing!

Sorry, I ran out of time for lunch, so I gotta get back to work. When I start using PRD and referring to the FAQ, I may have more suggestions for you.

...roboticus

Damn picky robots!