Lines Matching full:format

20 .Nd configuration format descriptors and discovery
32 .Fa "enum bsdconf_format format"
48 .Fa "enum bsdconf_format *format"
56 .Fa "enum bsdconf_format format"
60 .Fa "enum bsdconf_format format"
64 .Fa "enum bsdconf_format format"
68 .Fa "enum bsdconf_format format"
73 .Fa "enum bsdconf_format *format"
76 Every supported configuration file format is described by the same small
77 format descriptor
110 a format descriptor merely parameterizes it.
115 .It Sy format Ta Sy keyword Ta Sy "default write path"
139 the default write path is the format's one and only file and the two
148 the format is backed by several files and
201 A format whose backing files are themselves configuration data describes
243 .Fa format
265 the format's default write path,
330 to its format.
332 guesses the format of an arbitrary file from the basename of
340 where a wrong format silently misformats a file,
342 the caller should require the format to be stated explicitly instead,
349 returns the format descriptor for a format handle.
357 Before adding a format,
372 no format descriptor,
375 A format descriptor parameterizes only tokenization and writing;
391 the format descriptor is the entire definition of a format;
392 no format has private parsing or writing code.
393 Support for a new configuration file format is therefore a data problem,
396 An application whose format is mostly like an existing one bolts it on at
400 copies the format descriptor of the nearest
402 format into
408 registers the result and returns a new format handle through
409 .Fa format .
410 The format descriptor is copied by value but the strings and arrays it
431 each built-in format is a self-contained translation unit
433 that documents the format's syntax rules,
436 and defines its format descriptor,
438 Promoting a format into the library therefore touches no existing parsing
477 A candidate format whose syntax the existing option flags cannot express
485 flag that the new format's descriptor is the first to set.
488 and becomes available to every other format
491 the new format itself remains nothing more than a format descriptor in its
512 .Pq Er EINVAL for a format with no backing files .
514 Bolt on a new format at runtime by deriving from the built-in it most
541 Promoting such a format into the library itself
554 The format descriptor interface first appeared in