On Mon, Mar 17, 2008 at 04:31:11PM -0400, Chuck Robey wrote:
> I was reading in the eix man page about eix-sync, and it gave about a
> million options, but nowhere did I see if give a useable format for the
> options,

Quoting from the manpage ..

  /etc/eixrc
      Global configuration file. The variables in ~/.eixrc or from the
      environment can override the variables set in this file.
      See ~/.eixrc.
  
  [snip]
  
  ~/.eixrc
      Per-user configuration file. The variables in this file can be
      overridden by environment variables. You can use a shell-like
      syntax to set the following variables.             ^^^^^^^^^^
      ^^^^^^ 

>  I wanted to have a option line setting but I couldn't tell if it was
>  like
> 
> PRINT_SLOTS=yes                       or
> PRINT_SLOTS   yes             or
> PRINT_SLOTS="yes"             or
> PRINT_SLOTS   "yes"

As said above, eix uses shell-style configuration files so #1 and #3
should be fine.

> There are other permutations.  Howcome the man page doesn't give something
> as obvious as that?  Darn huge man page, after I initially found the
> PRINT_SLOTS defintion, it took me 10 more minutes to find out that it was
> supposed to go into /etc/eix-sync.

Are you sure? Normally that stuff goes into /etc/eixrc or ~/.eixrc.

> It gives a great amoount of info, but maybe it could stand some better
> organization, to let things get found.

Martin actually acknowledges this problem in the "BUGS" section: "There
are too many features: The documentation and configuration has become
too complicated." So it definitely could.

The *huge* list of variables could be split up into sections, for
example all the "MATCH_*" stuff could go into a section called "Changing
default match-fields". 
But this approach is probably be better suited for formats that support
links, so we can have a nice table of contents. info-pages spring to
mind, but I hear many people don't like those.

Another way to reduce the size and complexity could be to split the
whole thing into multiple documents, one for each tool (eix, update-eix,
eix-diff and so on..).

Any thoughts or suggestions on this topic would be greatly appreciated.

Cheers, Emil

-- 
Emil Beinroth
83059 Kolbermoor | Germany

Attachment: pgpoLNzrlk0d3.pgp
Description: PGP signature

Reply via email to