Nicolas Pitre <nico@xxxxxxx> writes: >> Man pages are reference documentation, so I figure it's OK to sacrifice >> a little newbie-friendliness for accuracy and concision. > > I disagree. Clarity should be the first goal. And the fact that even > modified files have to be specified is something worth enphasizing, > especially since this is not something other systems do. Let's keep plumbing documentation technical reference material, but allow more newbie friendliness in Porcelain-ish documentation. - To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html