On Wed, May 11, 2005, Bill Campbell wrote:

> On Wed, May 11, 2005, Matthias Kurz wrote:
> >On Wed, May 11, 2005, Bill Campbell wrote:
> >
> >> On Wed, May 11, 2005, Matthias Kurz wrote:
> >> >
> >[...]
> >> >2. Mandatory documentation
> >> >--------------------------
> >> >   In short, every documentation that an administrator of a "headless
> >> >   peripheral host" needs for his daily work is considered "mandatory". 
> >> > This
> >> >   are especially manual pages (%prefix/man) and GNU info files 
> >> > (%prefix/info).
> >> >   When the packager decides that there should be more mandatory 
> >> > documentation
> >> >   it should be placed under %prefix/share/<package>/docs.
> >> 
> >> I would include sample configuration and any text HOWTO files in this
> >> category.  It would be nice to have something that turned info files into
> >> something useful (I generally read them with less since I find it far
> >> easier than navigating their ``improved'' way).
> >
> >Well, the info files are built from texinfo sources. I would like to have
> >the HTML versions (using texi2html). I fear this is also not what you want ?
> 
> I prefer simple man pages or text files where I can use less as the pager
> with its easy pattern searching.

That is also what i prefer, when i have to find infos very quickly -
and that's often. I do not look too often after .info docs, though. I still
hate it and even pinfo can not cure this, even when it is somewhat better
than what i knowed before. The hate is burned in. But do you know a tool
that would give much more improvement "pure text" wise than (using your
"less trick")
#/bin/sh
prefix=/opkg
(for i in "$@"; do cat $prefix/info/$i*; done) | less -r


   (mk)

-- 
Matthias Kurz; Fuldastr. 3; D-28199 Bremen; VOICE +49 421 53 600 47
  >> Im prämotorischen Cortex kann jeder ein Held sein. (bdw) <<
______________________________________________________________________
The OpenPKG Project                                    www.openpkg.org
Developer Communication List                   openpkg-dev@openpkg.org

Reply via email to