On Mon, Feb 16, 2009 at 12:24:51PM -0500, Stephen Wille Padnos wrote: > Vince Mulhollon wrote: > >This situation is handled explicitly by Debian Policy, section 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. > > > >>From Debian Policy Manual version 3.8.0.1, 2008-06-05 > > > >So the correct Debian location would be /usr/share/doc/emc2/examples/ > > > > > We have two kinds of example: configurations and gcode. Do you think > that both should go under usr/share/doc? > > There are other examples as well I think, like (classic)ladders, some > scripts (like jdi.py), maybe even skeleton code for writing your own HAL > components. Do you think these should all be considered examples in > this context?
Yes I'd say Policy 12.6 is pretty clear that examples not referenced by any program, for the benefit of the administrator, go there, no matter if they be configs, source files (source code), whatever. A script that someone would realistically run out of the box without any changes would go in /usr/bin but a typical example that could be edited into something useful belongs in the examples dir. There is also consistency. Even if it can be argued that scripts and skeletons of source files are not "source files", so that section of policy does not apply, it seems a reasonable user would expect all the "examples" to be in the same "examples" directory. /var is for stuff thats variable on otherwise similar machines. Gotta back up /var (along with /etc) /usr is for stuff thats the same for any similar machine. No point in backing up /usr, in fact its usually OK to mount it read-only over NFS or whatever if you want. ------------------------------------------------------------------------------ Open Source Business Conference (OSBC), March 24-25, 2009, San Francisco, CA -OSBC tackles the biggest issue in open source: Open Sourcing the Enterprise -Strategies to boost innovation and cut costs with open source participation -Receive a $600 discount off the registration fee with the source code: SFAD http://p.sf.net/sfu/XcvMzF8H _______________________________________________ Emc-developers mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/emc-developers
