From Fedora Project Wiki

< User:Dp67

Revision as of 03:26, 18 June 2010 by Dp67 (talk | contribs) (update per guidelines)

================================
Key:

[P] Pass
[F] Fail See [n]
[-] Not applicable
[?] Questions (see comments)

================================

[ ]  MUST: rpmlint must be run on every package. The output should be
     posted in the review.

[ ]  MUST: The package must be named according to the Package Naming
     Guidelines.

[ ]  MUST: The spec file name must match the base package %{name},
     in the format %{name}.spec unless your package has an exemption.

[ ]  MUST: The package must meet the Packaging Guidelines.

[ ]  MUST: The package must be licensed with a Fedora approved
     license and meet the Licensing Guidelines .

[ ]  MUST: The License field in the package spec file must match
     the actual license.

[ ]  MUST: If (and only if) the source package includes the text of the
     license(s) in its own file, then that file, containing the text of
     the license(s) for the package must be included in %doc.

[ ]  MUST: The spec file must be written in American English.

[ ]  MUST: The spec file for the package MUST be legible.

[ ]  MUST: The sources used to build the package must match the upstream
     source, as provided in the spec URL. Reviewers should use md5sum for
     this task. If no upstream URL can be specified for this package,
     please see the Source URL Guidelines for how to deal with this.

[ ]  MUST: The package MUST successfully compile and build into binary
     rpms on at least one primary architecture.

[ ]  MUST: If the package does not successfully compile, build or work on
     an architecture, then those architectures should be listed in the spec
     in ExcludeArch. Each architecture listed in ExcludeArch MUST have a bug
     filed in bugzilla, describing the reason that the package does not
     compile/build/work on that architecture. The bug number MUST be
     placed in a comment, next to the corresponding ExcludeArch line.

[ ]  MUST: All build dependencies must be listed in BuildRequires,
     except for any that are listed in the exceptions section of the
     Packaging Guidelines ; inclusion of those as BuildRequires is
     optional. Apply common sense.

[ ]  MUST: The spec file MUST handle locales properly. This is done by
     using the %find_lang macro. Using %{_datadir}/locale/[ ] is strictly
     forbidden.

[ ]  MUST: Every binary RPM package (or sub package) which stores shared
     library files (not just symlinks) in any of the dynamic linker's
     default paths, must call ldconfig in %post and %postun.

[ ]  MUST: If the package is designed to be relocatable, the packager
     must state this fact in the request for review, along with the
     rationalization for relocation of that specific package.
     Without this, use of Prefix: /usr is considered a blocker.

[ ]  MUST: A package must own all directories that it creates. If it does not
     create a directory that it uses, then it should require a package which
     does create that directory. Refer to the Guidelines for examples.

[ ]  MUST: A package must not contain any duplicate files in the %files
     listing.

[ ]  MUST: Permissions on files must be set properly. Executables should
     be set with executable permissions, for example. Every %files section
     must include a %defattr(...) line.

[ ]  MUST: The %clean section is not required for F-13 and above. Each package
     for F-12 and below (or EPEL) MUST have a %clean section, which contains
     rm -rf %{buildroot} (or $RPM_BUILD_ROOT).


[ ]  MUST: Each package must consistently use macros, as described in the
     macros section of Packaging Guidelines.

[ ]  MUST: The package must contain code, or permissible content.
     This is described in detail in the code vs. content section
     of Packaging Guidelines.

[ ]  MUST: Large documentation files should go in a -doc sub package.
     (The definition of large is left up to the packager's best judgement,
     but is not restricted to size. Large can refer to either size or quantity)

[ ]  MUST: If a package includes something as %doc, it must not affect the
     runtime of the application. To summarize: If it is in %doc, the program
     must run properly if it is not present.

[ ]  MUST: Header files must be in a -devel package.

[ ]  MUST: Static libraries must be in a -static package.

[ ]  MUST: Packages containing pkgconfig(.pc) files must 'Requires:
     pkgconfig' (for directory ownership and usability).

[ ]  MUST: If a package contains library files with a suffix
     (e.g. libfoo.so.1.1), then library files that end in .so
     (without suffix) must go in a -devel package.

[ ]  MUST: In the vast majority of cases, devel packages must require
     the base package using a fully versioned dependency: Requires:
     %{name} = %{version}-%{release}

[ ]  MUST: Packages must NOT contain any .la libtool archives,
     these should be removed in the spec.

[ ]  MUST: Packages containing GUI applications must include a
     %{name}.desktop file,and that file must be properly installed
     with desktop-file-install in the %install section. This is described
     in detail in the desktop files section of the Packaging Guidelines.
     If you feel that your packaged GUI application does not need a .desktop
     file, you must put a comment in the spec file with your explanation.

[ ]  MUST: Packages must not own files or directories already owned by
     other packages. The rule of thumb here is that the first package
     to be installed should own the files or directories that other packages
     may rely upon. This means, for example, that no package in Fedora should
     ever share ownership with any of the files or directories owned by the
     file system or man package. If you feel that you have a good reason to
     own a file or directory that another package owns, then please present
     that at package review time.

[ ]  MUST: At the beginning of %install, each package MUST run
     rm -rf %{buildroot} ( or $RPM_BUILD_ROOT ).
     See Prepping BuildRoot For %install for details. (For EPEL Only)

[ ]  MUST: All file names in rpm packages must be valid UTF-8.

SHOULD Items:

[ ]  Should build in mock.
[ ]  Should build on all supported archs
[ ]  Should function as described.
[ ]  Should have sane scriptlets.
[ ]  Should have sub packages require base package with fully versioned depend.
[ ]  Should have dist tag
[ ]  Should package latest version
[ ]  Check for outstanding bugs on package. (For core merge reviews)

Issues:

1.