Document extensions and other miscellania

doc/manual/tags.md

@@ -539,11 +539,19 @@ Transfiletrigger-tags run once per transaction.
   Denotes a source rpm.
 
 ## Internal / special
+
 * Headeri18ntable (100) string array
+
+  Locales for which the header has translations.
+
 * Headerimmutable (63) bin
 
+  Special tag to return the unmodified, original image of the header
+  even after data has been added to it in eg installation.
+
 ## Deprecated / Obsolete
 * Filecontexts (1147) string array
+* Fscontexts (1148) string array
 * Gif (1012) bin
 * Icon (1043) bin
 * Oldenhancesname (1159) string array
@@ -557,10 +565,14 @@ Transfiletrigger-tags run once per transaction.
 * Patchesname (1133) string array
 * Patchesversion (1135) string array
 * Pubkeys (266) string array
+* Recontexts (1149) string array
 * Removetid (1129) int32
 * Xpm (1013) bin
 
 ## Aliases
+
+Aliases are simply shorthands or alternative names for other tags.
+
 * C (Conflictname) string array
 * Conflicts (Conflictname) string array
 * E (Epoch) int32
@@ -583,38 +595,124 @@ Transfiletrigger-tags run once per transaction.
 * V (Version) string
 
 ## Extension
+
+Extension tags do not exist in concrete form anywhere, their data is
+constructed at query time based on other information in the headers
+or runtime environment.
+
 * Dbinstance (1195) int32
+
+  Header ID of installed package, 0 otherwise.
+
 * Epochnum (5019) int32
+
+  Package epoch as numeric value (0 if not present).
+
 * Evr (5013) string
+
+  Formatted `epoch:version-release` string of the package
+
 * Headercolor (5017) int32
+
+  Header "color" calculated from file colors.
+
 * Nevr (5015) string
+
+  Formatted `name-epoch:version-release` string of the package
+
 * Nevra (5016) string
+
+  Formatted `name-epoch:version-release.arch` string of the package
+
 * Nvr (5014) string
+
+  Formatted `name-version-release` string of the package
+
 * Nvra (1196) string
 
+  Formatted `name-version-release.arch` string of the package
+
 * Filenames (5000) string array
+
+  Per file paths contained in the package, calculated from the path triplet.  
+
 * Filenlinks (5045) int32 array
+
+  Per file hardlink number, calculated from inode/device information.
+
 * Fileprovide (5001) string array
+
+  Per file dependency capabilities provided by the corresponding files.
+
 * Filerequire (5002) string array
-* Fscontexts (1148) string array
+
+  Per file dependency capabilities required by the corresponding files.
+
 * Instfilenames (5040) string array
+
+  Per file paths installed from the package, calculated from the path triplet
+  and file status info.
+
 * Origfilenames (5007) string array
-* Recontexts (1149) string array
+
+  Original Filenames in relocated packages.
 
 * Providenevrs (5042) string array
+
+  Formatted `name [op version]` provide dependency strings.
+
 * Conflictnevrs (5044) string array
+
+  Formatted `name [op version]` conflict dependency strings.
+
 * Obsoletenevrs (5043) string array
+
+  Formatted `name [op version]` obsolete dependency strings.
+
 * Enhancenevrs (5061) string array
+
+  Formatted `name [op version]` enhance dependency strings.
+
 * Recommendnevrs (5058) string array
+
+  Formatted `name [op version]` recommend dependency strings.
+
 * Requirenevrs (5041) string array
+
+  Formatted `name [op version]` require dependency strings.
+
 * Suggestnevrs (5059) string array
+
+  Formatted `name [op version]` suggest dependency strings.
+
 * Supplementnevrs (5060) string array
 
-* Filetriggertype (5087) string array
+  Formatted `name [op version]` supplement dependency strings.
+
 * Filetriggerconds (5086) string array
+
+  Formatted file trigger condition information.
+
+* Filetriggertype (5087) string array
+
+  Formatted file trigger type information.
+
 * Transfiletriggerconds (5088) string array
+
+  Formatted transaction file trigger condition information.
+
 * Transfiletriggertype (5089) string array
+
+  Formatted transaction file trigger type information.
+
 * Triggerconds (5005) string array
+
+  Formatted trigger condition information.
+
 * Triggertype (5006) string array
 
+  Formatted trigger type information.
+
 * Verbose (5018) int32
+
+  Returns 1 if rpm is running in verbose mode.