On Fri, Nov 28, 2008 at 4:00 PM, Michael Kerrisk <mtk.manpages@xxxxxxxxxxxxxx> wrote: [...] > It seems to me that all the info you needed was there in the page, but > you didn't read the whole page. The question is, whether the page > could/should provide more clues to make sure that the reader is > pointed to the fine details (which, for the reasons I described above, > are often not needed). I added the words "(see NOTES)" to the sentence on in DESCRIPTION mentioning that the field lengths are unspecified. This will give the reader a clue whetre to get more details, if needed. Cheers, Michael -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html