From owner-svn-src-head@freebsd.org Sun Jul 19 22:08:32 2015 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 031899A4381; Sun, 19 Jul 2015 22:08:32 +0000 (UTC) (envelope-from crodr001@gmail.com) Received: from mail-yk0-x230.google.com (mail-yk0-x230.google.com [IPv6:2607:f8b0:4002:c07::230]) (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 B0CDC121C; Sun, 19 Jul 2015 22:08:31 +0000 (UTC) (envelope-from crodr001@gmail.com) Received: by ykay190 with SMTP id y190so126817234yka.3; Sun, 19 Jul 2015 15:08:30 -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=toHobfdNIm90Q9ybpfAiqDzDjf1yXRykAJGjSSDbHjQ=; b=0A+O9qoF0/Rx5yJ+peTOMRMMVnAyFz5lSF8NN9DPUmXLXD1I4eBaZVjxnry/SVy+QM Wn1buSlkuurifeZfvqnsJus+FxolOnRZuJIe02mCayR4lM7NDwzD5K/vVUhvUJTfcD6w suUDh62DiQ5fSeDC5E2KeH9EqXjk767boABCWOMha+a+tO1MwZdd46OODVUOXsy0UPup NZQAZm8YWUDiGEHoHp7SjD3ga6S6+ORQAQkcxMBYfVjRo8SPrT4myv+i/yowzSSDYG+p XkzGewt6nGNnDSD6/57tclSh5/G4cMq+EQtlDsJ/+uCYplZRWDHwf7q5FTulQN+qIkV7 0DnQ== MIME-Version: 1.0 X-Received: by 10.170.203.215 with SMTP id u206mr25718325yke.116.1437343710535; Sun, 19 Jul 2015 15:08:30 -0700 (PDT) Sender: crodr001@gmail.com Received: by 10.37.65.193 with HTTP; Sun, 19 Jul 2015 15:08:30 -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: Sun, 19 Jul 2015 18:08:30 -0400 X-Google-Sender-Auth: 4gS9_Hlekym1c8tWkOAuIif2IH4 Message-ID: Subject: Re: svn commit: r284198 - head/bin/ls From: Craig Rodrigues To: Steve Kargl Cc: Marcel Moolenaar , Marcel Moolenaar , "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, 19 Jul 2015 22:08:32 -0000 On Sat, Jun 13, 2015 at 9:29 PM, Steve Kargl < sgk@troutmask.apl.washington.edu> wrote: > On Sat, Jun 13, 2015 at 05:40:59PM -0700, Craig Rodrigues wrote: > > On Sat, Jun 13, 2015 at 5:26 PM, Steve Kargl < > > sgk@troutmask.apl.washington.edu> wrote: > > > > > > Given the horrid state of the manpages, which I showed > > > in March, one can only wonder about the internals of > > > the libxo itself. > > > > > > > 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. 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. > > % cd src/contrib/libxo/libxo > % grep Nd *.3 | grep formatted > xo_attr.3:.Nd emit formatted output based on format string and arguments > xo_create.3:.Nd emit formatted output based on format string and arguments > xo_emit.3:.Nd emit formatted output based on format string and arguments > xo_finish.3:.Nd emit formatted output based on format string and arguments > xo_flush.3:.Nd emit formatted output based on format string and arguments > xo_open_list.3:.Nd emit formatted output based on format string and > arguments > xo_set_allocator.3:.Nd emit formatted output based on format string and > arguments > xo_set_flags.3:.Nd emit formatted output based on format string and > arguments > xo_set_info.3:.Nd emit formatted output based on format string and > arguments > xo_set_style.3:.Nd emit formatted output based on format string and > arguments > xo_set_writer.3:.Nd emit formatted output based on format string and > arguments > > Do you really believe that the Nd entries for these manpages are > correct? > > I opened this bug report against libxo: https://github.com/Juniper/libxo/issues/43 Phil Shafer fixed it and closed that bug report out. Hopefully these fixes will make it into FreeBSD after the next libxo import. -- Craig