Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 13 Jun 2015 18:45:57 -0700
From:      Craig Rodrigues <rodrigc@FreeBSD.org>
To:        Steve Kargl <sgk@troutmask.apl.washington.edu>
Cc:        "src-committers@freebsd.org" <src-committers@freebsd.org>,  "svn-src-all@freebsd.org" <svn-src-all@freebsd.org>,  "svn-src-head@freebsd.org" <svn-src-head@freebsd.org>
Subject:   Re: svn commit: r284198 - head/bin/ls
Message-ID:  <CAG=rPVdYQe3robA6WtMxubRfzjYU3bHx==Cgx70rJxd6T=66%2Bg@mail.gmail.com>
In-Reply-To: <20150614012924.GA2965@troutmask.apl.washington.edu>
References:  <201506100127.t5A1RdX6051959@svn.freebsd.org> <20150612204309.11dd3391@kan> <20150613024916.GA98218@troutmask.apl.washington.edu> <1434208622.1415.57.camel@freebsd.org> <C88CB169-12FE-4692-92AA-5C7D41BB61DF@FreeBSD.org> <557C661F.8080104@freebsd.org> <860017ED-D754-450C-865D-2D81A30C2212@xcllnt.net> <CAG=rPVd93Q18aYnSGSf_QH4C08RCq5wsdKQSNYTgWQ2huTbUHQ@mail.gmail.com> <20150614002640.GA2746@troutmask.apl.washington.edu> <CAG=rPVfrM9SnqRU-g=L6Y39GM2yEd%2Bt6=UFhggauu0s3HJvpYw@mail.gmail.com> <20150614012924.GA2965@troutmask.apl.washington.edu>

next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, Jun 13, 2015 at 6:29 PM, Steve Kargl <
sgk@troutmask.apl.washington.edu> wrote:

> >
> > Are you talking about this comment you made?
> >
> https://lists.freebsd.org/pipermail/freebsd-current/2015-March/054899.html
> >
> > I can't make heads or tails of what you wrote, other than you seemed very
> > angry.
> >
>
> I wasn't very angry.


It's hard for me to tell, really, since you submitted patches
with FUBAR in them, so you seemed pretty angry in that e-mail.


  I'm simply pointing out that the libxo
> manpages, which should document what libxo is/does, are
> horrible documentation.  If the quality of the manpages
> matches the quality of library, and the brokeness that
> we have been witnesses bears this out, should be questioned.
>
>
I can't comment on the quality of the code, since I haven't looked at it
in detail.  I have read the discussions on arch@, and understand what
libxo is trying to accomplish, and am eager to have this
because I will definitely use it in stuff I am working on.

I have also worked with Marcel and Phil, and respect them both quite a bit.
It's a shame that some of the libxo commits broke some things,
but if I was doing this type of work, I would probably make some mistakes
and break things too, since this is low-level stuff covering many utilities
in Unix.
Hopefully, we can fix these things can quickly, and we move on.



> Do you really believe that the Nd entries for these manpages are
> correct?
>

I'm not an expert on the mdoc format, so I couldn't tell you.
If you can think of some patches to fix things, in the man pages,
would you be able to submit the patches to Phil, and have them incorporated
into the software to make it better?

libxo is maintained at https://github.com/Juniper/libxo .

I don't know if you are willing/able to submit patches to the libxo project
on Github,
to help fix things.  That would be great if you could do that and help out.

--
Craig



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAG=rPVdYQe3robA6WtMxubRfzjYU3bHx==Cgx70rJxd6T=66%2Bg>