Section [info]

Attention: This section is mandatory.

An example

An example from a Device Description INI of the CAPS Driver Collection

[info]
brief=Samsung ML-1640 monochrome laser printer
detailed=Native ML-1640 monochrom laser printer driver
device=ML-1640
vendor=Samsung
driver=driver-collection by the CAPS project
author=Jürgen Borleis
copyright=2018, Juergen Borleis <projects@caps-printing.org>
license=GPL-2.0-or-later
version=<some version info>

This section carries various base information. Some keys herein are optional, others are mandatory since their values are already used.

Even if some keys here are optional, feel encouraged to define them. Maybe they will be used in the future to show more detailed information to a user.

Mandatory keys are

Key	Description
brief	some brief description about the printing device, free text
vendor	vendor's name, can be the printer manufacturer or your name as the printing driver's vendor, free text
device	printing device's name, free text

brief's value is forwared to the printing coordinator to describe the printer in more detail
vendor's value is used for PPD generation as a fallback if the manufacturer key isn't present
device's value is used for PPD generation as a fallback if the product, nick or shortnick key isn't present
device's value is used by the drivers of the CAPS Driver Collection to get a hint about the really attached printer. This is important for generic drivers which supports variants of printer devices.

Optional keys are

Key	Description
author	driver author's name, free text (and utf8 encoded)
copyright	driver author's copyright and - maybe - email address, free text
license	driver's license, free text, but SPDX names are favoured
version	driver's version, free text
detailed	More detailed information about the driver and/or the printer device it is for, free text
documentation	Some hints (paths or URLs) to documentation sources, more or less free text

Note: This section has more mandatory keys. But their values are not generic and thus, not defined here in the Device Description INI file. They are defined in the Printing Device Parameters INI files instead. Refer Printing Device Parameters INI files: section [info] for user adaption for details.