home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 February / CHIP_2_98.iso / misc / src / rpm / docs / spec < prev   
Text File  |  1997-09-17  |  2KB  |  60 lines
  1. SPEC FILE ADDITIONS
  2. ===================
  3.  
  4. A few additions have been made to the spec file format.
  5.  
  6. Summary and Description
  7. -----------------------
  8.  
  9. The Summary: tag should be use to give a short (50 char or so) summary
  10. of the package.  Most package's Description: line should be changed to
  11. a Summary: line.  The Description: tag is still supported but should
  12. be changed to a "%description" entry similar to %package and %files.
  13. At some point in the future support will be removed for "Description:".
  14. As an example, this spec file fragment:
  15.  
  16.   Description: Screen drawing library
  17.   Name: screenlib
  18.   Version: 1.0
  19.  
  20.   %package devel
  21.   Description: Screen drawing library headers and static libs
  22.  
  23. might be changed to:
  24.  
  25.   Summary: Screen drawing library
  26.   Name: screenlib
  27.   Version: 1.0
  28.  
  29.   %description
  30.   The screen drawing library
  31.   is a handy development tool
  32.  
  33.   %package devel
  34.   Summary: Screen drawing library headers and static libs
  35.  
  36.   %description devel
  37.   This package contains all of the
  38.   headers and the static libraries for
  39.   screenlib.
  40.  
  41.   You'll only need this package if you
  42.   are doing development.
  43.  
  44. The description is free form text, but there are two things to note.
  45. The first regards reformating.  Lines that begin with white space
  46. are considered "pre-formatted" and will be left alone.  Adjacent
  47. lines without leading whitespace are considered a single paragraph
  48. and may be subject to formatting by glint or another RPM tool.
  49.  
  50. Other Tags
  51. ----------
  52.  
  53. Two new tags are "URL:" and "Packager:".  "URL:" is a place to put a
  54. URL for more information and/or documentation on the software
  55. contained in the package.  Some future RPM package tool may make use
  56. of this.  The Packager: tag is meant to contain the name and email
  57. address of the person who "maintains" the RPM package (which may be
  58. different from the person who actually maintains the program the
  59. package contains).
  60.