On Sat, Jan 18, 2014 at 03:42:50PM -0700, Theo de Raadt wrote: > > > this page does not need an EXAMPLES section. > > > jmc > > What are the criteria to add an EXAMPLES section to a manpage? > > Examples should cover either "slightly non-obvious but powerful" usage > cases that are not entirely expected, and thus lead people to seeing > the power of the command. > > An example of this is the EXAMPLES in the mv page; they handle the > tricky cases. > > fw_update is not a tricky command. Your first example was only second > order usage (first order is: fw_update). In this case you did spot that > the inverse operation is missing, and that should be added. >
if you don;t add an option to delete the firmware, please just document using pkg_delete rather than adding an example. jmc
