Uploaded image for project: 'RHEL Documentation'
  1. RHEL Documentation
  2. RHELDOCS-19481

The filename of the SPEC file of the pello package triggers the rpmlint invalid-spec-name linting error in the "Packaging and distributing software" RHEL9 documentation

XMLWordPrintable

    • None
    • None
    • False
    • False
    • Hide

      None

      Show
      None
    • None
    • Red Hat Enterprise Linux
    • None
    • None
    • Unspecified
    • Unspecified
    • Unspecified

      Document link: https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html-single/packaging_and_distributing_software/index#creating-spec-files-with-rpmdev-newspec_working-with-spec-files

      Section number and name:

      • 4.5.1. Creating a new spec file for sample Bash, Python, and C programs
      • 4.6.1. Building source RPMs
      • 4.6.3. Building a binary RPM from the spec file
      • 4.7.2.1. Checking the pello spec file for common errors
      • 5.3.6. Using non-shell scripts in a spec file

      Describe the issue:

      When running the rpmlint command documented in the "4.7.2.1. Checking the pello spec file for common errors" section, I noticed the following linting error:

      python-hello.src: E: invalid-spec-name
      The spec file name (without the .spec suffix) must match the package name
      ("Name:" tag). Either rename your package or the specfile.

      Impact of this issue: Documentation consumers might learn a spec file naming convention for Python packages that is not complying to the best practices.

      Suggestions for improvement:

      As the example spec file in the "4.5.4. An example SPEC file for a program written in Python" section uses the python-pello package name:

      Name:           python-pello

      the filename of the spec file should instead be python-pello.spec.  The 2. bullet point explaining the naming of Python RPM packages probably should be moved to the "4.5.1. Creating a new spec file for sample Bash, Python, and C programs" section to properly address the different naming of the spec file for the pello package.

              mpershin@redhat.com Mariya Pershina
              lin-buo-ren 林博仁 Buo-ren Lin (Inactive)
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated:
                Resolved: