chicken-hackers
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Chicken-hackers] install-extension: locations for docs, examples etc.


From: Shawn Rutledge
Subject: [Chicken-hackers] install-extension: locations for docs, examples etc.
Date: Sat, 12 Apr 2008 13:09:04 -0700

Something I've been noticing:

(install-extension 'dbus
        `("dbus.so"
                "dbus.html"
                ,@(if has-exports? '("dbus.exports") '()) )
        `((version 0.85)
                ,@(if has-exports? `((exports "dbus.exports")) '())
                (documentation "dbus.html")
                (examples
                        "examples/introspect-avahi.scm"
                        "examples/introspect-services.scm"
                        "examples/receive-car-turn.scm"
                        "examples/send-example-query.scm"
                        "examples/introspect-hal.scm"
                        "examples/listen-example.scm"
                        "examples/receive-signal.scm"
                        "examples/send-signal.scm"
                        "examples/introspect-phonekit.scm"
                        "examples/paranoid-android.scm"
                        "examples/send-car-turn.scm"   )))

It installs examples like this:

  cp -r examples/send-signal.scm
/usr/share/chicken/examples/examples/send-signal.scm

IMO it would be better something like

/usr/share/doc/chicken-3.1.0/eggs/dbus/examples/whatever.scm

>From the dbus egg's perspective there is a directory of examples, but
from the system perspective, one wants to distinguish the dbus
examples from the others.  Likewise the dbus egg's documentation
should be in

/usr/share/doc/chicken-3.1.0/eggs/dbus

with as many files as the egg would like to install there, rather than
being restricted to just the typical everything-on-one-page.

(/usr/share/doc/package-version/xxx is the Gentoo convention, at
least.  It could be configurable in case other distros are different.)

It's also inconsistent that examples only need to be mentioned in the
property list, whereas documentation has to be mentioned both there
and in the list of files to install.  I think it should be enough to
have it in the property list.




reply via email to

[Prev in Thread] Current Thread [Next in Thread]