From owner-svn-src-head@FreeBSD.ORG Sun Jun 14 01:45:59 2015 Return-Path: Delivered-To: svn-src-head@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 1A10CACA; Sun, 14 Jun 2015 01:45:59 +0000 (UTC) (envelope-from crodr001@gmail.com) Received: from mail-yk0-x233.google.com (mail-yk0-x233.google.com [IPv6:2607:f8b0:4002:c07::233]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id C5689E; Sun, 14 Jun 2015 01:45:58 +0000 (UTC) (envelope-from crodr001@gmail.com) Received: by ykfl8 with SMTP id l8so34819781ykf.1; Sat, 13 Jun 2015 18:45:57 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:date:message-id:subject :from:to:cc:content-type; bh=EEI4g2L/x7v4Yb7l9xmGL6jN4x0T+4XuY/nSHUu7rZo=; b=0kY4/o4xJeLMfyXFw5AYcsqrQ0e+1UZUGJbbrW8JiXf5ygCSRGZjgztZ7ntjFz8JQb vYgmjP7jxvMC3qyjv8zWSRkHcHY5Mp8L/osVe2S7eqq9PKZ0HesaPsCo2gsl9UXNbUhA t13JrZm7o/3Nsue24T3bH+zGsv+q1EMs7ICV74GSJ8nJlP80lJpucC+zvMUkCRPRRZHz ECyYvLRQQiB9YX+7eMIf6l3KtZ3LQd9WCIYqhXrNPF+qzsbE+uzLLqG2aPbQOBaPwwhb dq9+d0D2cHQTSUnA+9b7VDbAoohiOvtiu0oBxNjrpBxnqhpudP5Jp/mV1PyKMdi3xx9l rGjg== MIME-Version: 1.0 X-Received: by 10.170.59.213 with SMTP id b204mr26542678ykb.10.1434246357865; Sat, 13 Jun 2015 18:45:57 -0700 (PDT) Sender: crodr001@gmail.com Received: by 10.37.39.130 with HTTP; Sat, 13 Jun 2015 18:45:57 -0700 (PDT) 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> <557C661F.8080104@freebsd.org> <860017ED-D754-450C-865D-2D81A30C2212@xcllnt.net> <20150614002640.GA2746@troutmask.apl.washington.edu> <20150614012924.GA2965@troutmask.apl.washington.edu> Date: Sat, 13 Jun 2015 18:45:57 -0700 X-Google-Sender-Auth: qYKy5kgBGodST05vzlYdz6vjKoM Message-ID: Subject: Re: svn commit: r284198 - head/bin/ls From: Craig Rodrigues To: Steve Kargl Cc: "src-committers@freebsd.org" , "svn-src-all@freebsd.org" , "svn-src-head@freebsd.org" Content-Type: text/plain; charset=UTF-8 X-Content-Filtered-By: Mailman/MimeDel 2.1.20 X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 14 Jun 2015 01:45:59 -0000 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