Changes

no edit summary
Line 142: Line 142:  
* To save storage space or bandwidth when some tarballs will contain any-arch data that are common for all platforms, and another tarball will contain binaries for a particular platform.
 
* To save storage space or bandwidth when some tarballs will contain any-arch data that are common for all platforms, and another tarball will contain binaries for a particular platform.
   −
All archive archive sections are named:
+
All archive sections are named:
    
  [Archive[:''sub-name'']]
 
  [Archive[:''sub-name'']]
Line 150: Line 150:  
  '''include''' = <glob-pattern> [; ...]
 
  '''include''' = <glob-pattern> [; ...]
   −
Optional. [[Platform_Team/Guide/Packaging#Glob patterns|Glob pattern]] for files to include to the archive. Path related patterns will be processed starting from the [[#Predefined_options|%(DISTDIR)s/%(PREFIX)s]] directory. By default, all files are assumed.
+
Optional. [[Platform_Team/Guide/Packaging#Glob patterns|Glob pattern]] for files to include in the archive. Path related patterns will be processed starting from the [[#Predefined_options|%(DISTDIR)s/%(PREFIX)s]] directory. By default, all files are assumed.
    
  '''exclude''' = <glob-pattern> [; ...]
 
  '''exclude''' = <glob-pattern> [; ...]
   −
Optional. Like the ''include'' option but used for excluding files from the archive. In additional, various temporary files will be excluded like ''.bak'' or ''.pyc''.
+
Optional. Like the ''include'' option, but used for excluding files from the archive. In addition, various temporary files will be excluded, like ''.bak'' or ''.pyc''.
    
  '''langs''' = <lang-name> [; ...]
 
  '''langs''' = <lang-name> [; ...]
Line 160: Line 160:  
  exclude[<lang-name>] = <glob-pattern> [; ...]
 
  exclude[<lang-name>] = <glob-pattern> [; ...]
   −
Optional. A special form of ''include''/''exclude'' options that are intended to create separate, per locale, archives. If language is mentioned in the ''langs'' list, but doesn't have any ''include[]''/''exclude[]'' options, ''include''/''exclude'' will be used (in that case, using the special [[#Predefined_options|LANG]] variable makes sense).
+
Optional. A special form of ''include''/''exclude'' options that are intended to create separate, per locale, archives. If a language is mentioned in the ''langs'' list, but doesn't have any ''include[]''/''exclude[]'' options, ''include''/''exclude'' will be used (in that case, using the special [[#Predefined_options|LANG]] variable makes sense).
    
  '''arch''' = <arch>
 
  '''arch''' = <arch>
Line 180: Line 180:  
  '''requires''' = <dependency-name> [(=|>=|<) <version>] [; ...]
 
  '''requires''' = <dependency-name> [(=|>=|<) <version>] [; ...]
   −
What [[Platform_Team/Guide/Packaging#Package_names|dependencies]] should be present before building the sweet from sources. Note that ''requires'' from [[#.5BComponent.5D|[Component]]] sections are not auto included in the build-time dependencies.
+
This defines what [[Platform_Team/Guide/Packaging#Package_names|dependencies]] should be present before building the sweet from sources. Note that ''requires'' from [[#.5BComponent.5D|[Component]]] sections are not auto included in the build-time dependencies.
    
  '''configure''' = <shell-command>
 
  '''configure''' = <shell-command>
   −
Shell command to configure sources before building, e.g., invoking the configure script in auto-tools-based projects. If the source code does not require a configuration stage, this option could be omited.
+
Shell command to configure sources before building, e.g., invoking the configure script in auto-tools-based projects. If the source code does not require a configuration stage, this option could be omitted.
    
  '''make''' = <shell-command>
 
  '''make''' = <shell-command>
Line 208: Line 208:  
  '''exec''' = <shell-command>
 
  '''exec''' = <shell-command>
   −
Execute external program to create sources tarball. Option might be used, e.g., to run {{Code|make dist}} command. After executing ''exec'' shell command, {{Code|sweets}} will pick up newly appeared tarball if it was created in sweet root directory.
+
Execute external program to create sources tarball. Option might be used, e.g., to run {{Code|make dist}} command. After executing the ''exec'' shell command, {{Code|sweets}} will pick up newly appearing tarball if it was created in the sweet root directory.
    
  '''include''' = <glob-pattern> [; ...]
 
  '''include''' = <glob-pattern> [; ...]
 
  '''exclude''' = <glob-pattern> [; ...]
 
  '''exclude''' = <glob-pattern> [; ...]
   −
If neither ''url'' nor ''exec'' options were used, all files will be bundled and these [[Platform_Team/Guide/Packaging#Glob patterns|glob patterns]] might be used to concretize selection.
+
If neither ''url'' nor ''exec'' options were used, all files will be bundled and these [[Platform_Team/Guide/Packaging#Glob patterns|glob patterns]] might be used to concretize the selection.
    
  '''requires''' = <dependency> [(=|>=|<) <version>] [; ...]
 
  '''requires''' = <dependency> [(=|>=|<) <version>] [; ...]
Line 229: Line 229:  
* ''CXXFLAGS'' default gcc CXXFLAGS
 
* ''CXXFLAGS'' default gcc CXXFLAGS
   −
In sections that contain ''langs'' option:
+
In sections that contain a ''langs'' option:
    
* ''LANG'' current language while building per language implementation
 
* ''LANG'' current language while building per language implementation