From owner-svn-src-head@FreeBSD.ORG Wed Jun 17 19:28:34 2015 Return-Path: Delivered-To: svn-src-head@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id A47C56ED; Wed, 17 Jun 2015 19:28:34 +0000 (UTC) (envelope-from hiren@strugglingcoder.info) Received: from mail.strugglingcoder.info (strugglingcoder.info [65.19.130.35]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 80E5015F; Wed, 17 Jun 2015 19:28:34 +0000 (UTC) (envelope-from hiren@strugglingcoder.info) Received: from localhost (unknown [10.1.1.3]) (Authenticated sender: hiren@strugglingcoder.info) by mail.strugglingcoder.info (Postfix) with ESMTPSA id AA3CF10C369; Wed, 17 Jun 2015 12:28:33 -0700 (PDT) Date: Wed, 17 Jun 2015 12:28:33 -0700 From: hiren panchasara To: Bryan Drewery Cc: Steve Kargl , Craig Rodrigues , Marcel Moolenaar , Marcel Moolenaar , "src-committers@freebsd.org" , "svn-src-all@freebsd.org" , "svn-src-head@freebsd.org" Subject: Re: svn commit: r284198 - head/bin/ls Message-ID: <20150617192833.GD53336@strugglingcoder.info> References: <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> <557F021C.1000509@FreeBSD.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="Xm/fll+QQv+hsKip" Content-Disposition: inline In-Reply-To: <557F021C.1000509@FreeBSD.org> User-Agent: Mutt/1.5.23 (2014-03-12) 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: Wed, 17 Jun 2015 19:28:34 -0000 --Xm/fll+QQv+hsKip Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 06/15/15 at 12:49P, Bryan Drewery wrote: > On 6/13/15 9:29 PM, Steve Kargl 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 v= ery > >> angry. > >> > >=20 > > I wasn't very angry. I'm simply pointing out that the libxo > > manpages, which should document what libxo is/does, are=20 > > horrible documentation. If the quality of the manpages=20 > > matches the quality of library, and the brokeness that > > we have been witnesses bears this out, should be questioned. > >=20 > > % 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 argume= nts > > 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 argume= nts > > xo_flush.3:.Nd emit formatted output based on format string and argumen= ts > > xo_open_list.3:.Nd emit formatted output based on format string and arg= uments > > 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 arg= uments > > xo_set_info.3:.Nd emit formatted output based on format string and argu= ments > > xo_set_style.3:.Nd emit formatted output based on format string and arg= uments > > xo_set_writer.3:.Nd emit formatted output based on format string and ar= guments > >=20 > > Do you really believe that the Nd entries for these manpages are > > correct? > >=20 >=20 > I also found that from simple 'man ls' (etc) there is no real mention of > what --libxo even is or how it works. Following the manpage > cross-references leads me to have to go to a webpage to see what params > --libxo even takes. The --libxo flag needs much more documentation in > these manpages. Sorry if I've missed it but has any of the libxo proponents signed up to fix the documentation part? Cheers, Hiren --Xm/fll+QQv+hsKip Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.22 (FreeBSD) iQF8BAEBCgBmBQJVgcphXxSAAAAAAC4AKGlzc3Vlci1mcHJAbm90YXRpb25zLm9w ZW5wZ3AuZmlmdGhob3JzZW1hbi5uZXRBNEUyMEZBMUQ4Nzg4RjNGMTdFNjZGMDI4 QjkyNTBFMTU2M0VERkU1AAoJEIuSUOFWPt/lasgH+wUOUpXpAl3fQ+aVsCblnRKv O2fjyIhDhwbn3QF3yaOdsLYoPV+Ce6VwQVoQzyToCv0q/6eMaXK3QTx8YMwKrOYr V55kSfACBtxkAxgcvBavT/kBKwDjbdJyWdjmxFHSJB0xIPSdsG4nb8EwZ9J7uetW IkE56ntZWW8gRSF+i54lGkKv8YfCi/l5oxatrmcTMQ1RVE+eJQG3rbk7R54Y4QqY iyDaVeXYyQse0ylnoIYa0yGiMwWtEX4MD30QzSjCXYzCCFLRl+MHY/5ysncvVJBQ YLoAescQPVyAjhXYeWspNqRGxMWvcLBu0IGAZ/WNv0UytQ6lGjqQFc1VzFkUxyM= =D9Lq -----END PGP SIGNATURE----- --Xm/fll+QQv+hsKip--