On Wed, Jun 03, 2015 at 05:06:38PM -0500, Bruce Dubbs wrote: > Ken Moffat wrote: > >I was aware that biber installed a program in /usr/bin, but it has > >its own page which allows that to be documented. > > > >Today, while I was looking at the new version of Text-BibTeX I > >realised that it too puts programs in /usr/bin : biblex, bibparse, > >dumpnames (all compiled progs) : and it also installs > >libbtparse.so into /usr/lib. > > > >Checking from what I have installed, putting a program into /usr/bin > >is not totally weird, although all the others are actually perl > >scripts. From Archive-Zip there is crc32, from libwww-perl there > >are four lwp- programs, Log-Log4perl installs l4p-tmpl, > > > > From the module dependencies, File-Find-Rule installs findrule and > >Pod-Coverage installs pod_cover. > > > >Arguably, the dependencies are not fully in the book, so they can be > >ignored. But for the remainder we do not appear to have any way of > >documenting these progs and that lib. Does that matter ? > > IMO, A note is the preferred way to explain oddball issues like this. > Whether to explain it or not is a judgement call and on this issue, I > certainly defer to your experience. > In fact, I managed to index them. I can't add per-module lists of programs (it does not validate) and the indexing has to be for perl-modules rather than the specific module, but in r16088 I've added Contents and Short Descriptions. The seg-list was interesting: it seems it can only include text within a seg (I tried to put a seglist within the program segment, then I tried to put paragraphs there - both failed to validate), but using emphasis (which is actually italic, at least on my system) on the module names within the 'Installed Programs' helps separate Module::Name: from the program(s). I've also given them the names we use in the page, so 'Archive:;Zip' with colons, but 'libwww-perl' with a dash.
ĸen -- Nanny Ogg usually went to bed early. After all, she was an old lady. Sometimes she went to bed as early as 6 a.m. -- http://lists.linuxfromscratch.org/listinfo/blfs-dev FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
