On Sat, Jun 13, 2015 at 9:29 PM, Steve Kargl < s...@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 < > > s...@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 _______________________________________________ svn-src-head@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/svn-src-head To unsubscribe, send any mail to "svn-src-head-unsubscr...@freebsd.org"
