Justin,
> On Tue, May 23, 2006 at 01:09:36AM +0200, Michael Kerrisk wrote:
> > > reference ftw.3; see #367846
> >
> > Done. For 2.33, And also the converse SEE ALSO in ftw.3
> > referring to fts.3.
> >
> > > Mention the return values in a separate section (especially
> > > fts_open)
> >
> > This page derives from BSD. Other than trivial changes, or
> > major flaws, I'm not inclined to gratuitously make changes.
> >
> > > s/NULL-terminated/null-terminated/
> >
> > No! It is not a string!
[...]
> Both of these are strings.
Agreed. Sorry -- what caught my eye was that there were other
instances, including the first: "in the NULL-terminated
linked list", which are legitimate.
> > > Figure out what is up with FTS_{LOGICAL,PHYSICAL}; it seems that
> > > flags combinations which are noted as being invalid (neither set)
> > > and implied as invalid (both set) are not rejected. Bug#367691
> > > and #333160 are mildy relevant (to me anyway, since I'm updating
> > > the pages)
> > >
> > > Michael, I'm waiting for your comments on the patch suggested in
> > > #367846 before changing this page.
> >
> > This note is the first mention I have seen of that patch.
> >
> > I have no interest in patch that changes multiple things
> > at one time, without any explanation. If you want to
> > get any of those changes in, do them as logically separate
> > pieces (separate bug reports), and give them to me one at
> > a time, along with as well reasoned argument. I suggest
> > that you space the reports so that I can respond to one
> > before you submit the next.
> document FTW_ACTIONRETVAL;
> include .SH "RETURN VALUE";
> reorganized and rearranged the page
>
> I'm not sure I can break the third one up, and it won't be well
> represented in a diff. I think the page reads much more clearly now,
> anyway.
Okay -- hold off a moment. I will pull at least some pieces out
of the existing patch, and then send you a revised version of
the page.
(And yes, sorry for not saying so earlier, but thanks for the
work. It's just that when I get an unexplained patch like
that, I just need to put on the brakes somewhat -- it takes
time to grok large patches that do multiple things. If you want
to get them upstream, then it's best to let me know of the plan
a little in advance, and to break the work up.)
Cheers,
Michael
--
Michael Kerrisk
maintainer of Linux man pages Sections 2, 3, 4, 5, and 7
Want to help with man page maintenance?
Grab the latest tarball at
ftp://ftp.win.tue.nl/pub/linux-local/manpages/,
read the HOWTOHELP file and grep the source
files for 'FIXME'.
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
