On Sun, 2012-10-28 at 02:53:57 -0700, Jonathan Nieder wrote: > Guillem Jover wrote: > > Yeah, one of the things I checked was if an EXAMPLE section was > > present in the man page at all, or more detail about the quoting, > > given the confusion. So I think this really makes sense. But the > > QUOTING section seems a bit strange > > That's fair. I first tried putting this in the description of the > --export option but it felt too long.
Right, I see what you mean. But what seems to me to be clutterering it a bit, are the examples. :) > It didn't seem right in the examples section, either, because the > examples don't illustrate other aspects of how to use dpkg-buildflags > properly (for example, the text doesn't mention bug#327154). Oh, sure, although I do think adding a note for the $(shell) issue and an example for that would be worthwile (or other caveats or usage patterns you might have in mind?), afterall this kind of shell quoting stuff seems to usually trip people over. > Here's another try at putting it in the description of --export. What > do you think? Certainly an improvement, although I'm not yet sold on the embedded examples, it would probably also make more sense to format them all in the same way too. And thanks for bearing with my pickyness? :) thanks, guillem -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
