Next: prepend invocation, Previous: apply invocation, Up: Writing boilerplate [Index]
png-apply: Write the working boilerplate to .png files
png-apply command adds the current working boilerplate to one or more .png image files. It is usually used in this fashion:
$ licensing png-apply foo.png png-apply: foo.png -> Boilerplate applied.
This example applies the current working boilerplate to foo.png.
The commenting style is automatically removed from the current working boilerplate before it is added to a .png file. This means that an uncommented form of the current working boilerplate is copied into the comment section of the PNG file.
This command will fail to operate when a copyright holder or a license have not been specified in the current working boilerplate. It will also fail if the given file is not recognized as a valid PNG file.
By default a backup .bak file is created; to prevent this behaviour use the --no-backup option.
The --quiet option prevents the ‘Boilerplate applied.’ messages from being displayed.
In the PNG file-format, there are named text sections. This command creates a named text section called "Comment" if it does not exist. Otherwise
png-apply overwrites an existing one.