where should Simbody examples be installed? about simbody HOT 11 CLOSED

For reference, the installed examples folder has a bin/ with executable binaries and two folders that contain the C++ source code of the examples. My guess would be to put it somewhere under share/simbody, but I expect there is a policy for it that I don't know about.

from simbody.

Is that on Ubuntu? Where does the examples directory end up?

from simbody.

The examples directory ends up at ${CMAKE_INSTALL_PREFIX}/examples and it contains 3 folders:

$ ls examples/
bin  simmath  src

This is both for mac and ubuntu for me. Note that I used homebrew for the mac build:

brew tap osrf/simulation
brew install simbody --HEAD

from simbody.

Does that mean by default on Debian it would end up in /usr/examples? That seems bad! The default on Mac puts it in /usr/local/examples which still seems like the wrong place.

from simbody.

I'd think it'd go somewhere in /usr/share/simbody.

On Thu, Dec 12, 2013 at 5:19 PM, Michael Sherman
[email protected]:

Does that mean by default on Debian it would end up in /usr/examples? That
seems bad! The default on Mac puts it in /usr/local/examples which still
seems like the wrong place.

—
Reply to this email directly or view it on GitHubhttps://github.com//issues/82#issuecomment-30478877
.

from simbody.

I would say that the usual place is under /usr/share/doc/$package_name/examples. Easy to get using $CMAKE_INSTALL_DOCDIR.

from simbody.

Currently the examples aren't installed on Ubuntu due to Jose's configuration of the debian install files.

from simbody.

Here is the Debian policy regarding examples:
http://www.debian.org/doc/debian-policy/ch-docs.html#s12.6

12.6 Examples

Any examples (configurations, source files, whatever), should be installed in a directory /usr/share/doc/package/examples. These files should not be referenced by any program: they're there for the benefit of the system administrator and users as documentation only. Architecture-specific example files should be installed in a directory /usr/lib/package/examples with symbolic links to them from /usr/share/doc/package/examples, or the latter directory itself may be a symbolic link to the former.

If the purpose of a package is to provide examples, then the example files may be installed into /usr/share/doc/package.

Please note that sources must be in share whereas binaries should be in lib.

from simbody.

Can you clarify about your last comment? Compiled examples go in
/usr/lib?

On Thu, Dec 12, 2013 at 5:41 PM, Thomas Moulard [email protected]:

Here is the Debian policy regarding examples:
http://www.debian.org/doc/debian-policy/ch-docs.html#s12.6

12.6 Examples

Any examples (configurations, source files, whatever), should be installed in a directory /usr/share/doc/package/examples. These files should not be referenced by any program: they're there for the benefit of the system administrator and users as documentation only. Architecture-specific example files should be installed in a directory /usr/lib/package/examples with symbolic links to them from /usr/share/doc/package/examples, or the latter directory itself may be a symbolic link to the former.

If the purpose of a package is to provide examples, then the example files may be installed into /usr/share/doc/package.

Please note that sources must be in share whereas binaries should be in
lib.

—
Reply to this email directly or view it on GitHubhttps://github.com//issues/82#issuecomment-30479877
.

from simbody.

I think he meant that they go in /usr/lib/simbody/examples, and that that folder is also symlinked to /usr/share/doc/simbody/examples.

from simbody.

Yes, exactly. The most important point is: no architecture dependent files in share (i.e. no compiled files).

from simbody.