OpenSolaris

  subsites   code review   repo   packages   bugs   defect   polls   planet
You are not signed in. Sign in or register.

JDS Packaging Guidelines

  • Assiging files to packages:
    • Files located in the / filesystem belong in the "-root" subpackage. These are typically files in /etc or /var
    • Files only needed for software development belong in the "-devel" subpackage. These files include:
      • headers (%_includedir/*)
      • executable only used for development (e.g. glib-genmarshal, esd-config)
      • manual pages that belong to those executables
      • development manual pages (man3*)
      • pkgconfig .pc files.
      • source code examples
      • aclocal .m4 files.
      • API documentation (e.g. gtk-doc)
      • IDL files
    • Localization files (e.g. /usr/share/locale/*, /usr/share/gnome/help/<anything but C>) belong in "-l10n" the subpackage.
      Note: in JDS, these files are repackaged into "language packs", i.e. packages that collect all l10n content for a given locale, from all JDS packages. This magic happens in SUNWzz-gnome-l10n.spec.
  • File attributes:
    • use %defattr (-, root, sys) in all %files root sections and use %defattr (-, root, bin) in all other %files sections
    • when present in the package, specify the attributes of system directories explicitely: 
      %dir %attr (0755, root, bin) %{_bindir}
%dir %attr (0755, root, bin) %{_sbindir}
%dir %attr (0755, root, bin) %{_libdir}
%dir %attr (0755, root, other) %{_libdir}/pkgconfig
%dir %attr (0755, root, bin) %{_includedir}
%dir %attr (0755, root, sys) %{_datadir}
%dir %attr (0755, root, bin) %{_mandir}
%dir %attr (0755, root, other) %{_datadir}/aclocal
%dir %attr (0755, root, other) %{_datadir}/applications
%dir %attr (0755, root, other) %{_datadir}/doc
%dir %attr (0755, root, other) %{_datadir}/gnome
%dir %attr (0755, root, other) %{_datadir}/locale
%dir %attr (0755, root, other) %{_datadir}/mime-info
%dir %attr (0755, root, other) %{_datadir}/pixmaps
     %attr (-, root, other) %{_datadir}/icons
%dir %attr (0755, root, sys) %{_sysconfdir}
%dir %attr (0755, root, sys) %{_localstatedir}
  • Build options. Solaris.inc defines some macros for optional build elements. Use these in spec files whenever appropriate:
    • %build_l10n: set to 1 if building the l10n content was requested (--with-l10n), 0 otherwise. The default is --without-l10n. (See SUNWgnome-dialog.spec for example).
    • %debug_build: set to 1 if building debuggable binaries was requested (--with-debug), 0 otherwise. The default is --without-debug. (See esound.spec for example).
    • %gtk_doc_option: set to --enable-gtk-doc unless building gtk-doc API docs was disabled (--without-gtk-doc), set to --disable-gtk-doc otherwise. The default is --with-gtk-doc. Use this in %files if needed: 
      %if %{!?_without_gtk_doc:1}%{?_without_gtk_doc:0}
%{_datadir}/gtk-doc
%endif
      (See glade.spec and SUNWgnome-ui-designer.spec for example).