Re: fw_update manpage examples

2014-01-18 Thread Fritjof Bornebusch
Theo de Raadt schrieb am Sat, 18. Jan 15:42: > > > 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

Re: fw_update manpage examples

2014-01-18 Thread Jason McIntyre
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 ex

Re: fw_update manpage examples

2014-01-18 Thread Theo de Raadt
> > 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 exampl

Re: fw_update manpage examples

2014-01-18 Thread Fritjof Bornebusch
Theo de Raadt schrieb am Sat, 18. Jan 15:02: > > I have added some examples to the fw_update manpage, to show how you > > can install, update or delete a firmware package. It tooks a little > > while until I figured out how fw_update works, so maybe it can help > > the next one. > > You sure did

Re: fw_update manpage examples

2014-01-18 Thread Fritjof Bornebusch
Jason McIntyre schrieb am Sat, 18. Jan 21:56: > On Sat, Jan 18, 2014 at 10:28:18PM +0100, Fritjof Bornebusch wrote: > > Hi tech, > > > > I have added some examples to the fw_update manpage, to show how you can > > install, update or delete a firmware package. > > It tooks a little while until I

Re: fw_update manpage examples

2014-01-18 Thread Theo de Raadt
> I have added some examples to the fw_update manpage, to show how you > can install, update or delete a firmware package. It tooks a little > while until I figured out how fw_update works, so maybe it can help > the next one. You sure did spot a real problem in the man page, which is that it doe

Re: fw_update manpage examples

2014-01-18 Thread Jason McIntyre
On Sat, Jan 18, 2014 at 10:28:18PM +0100, Fritjof Bornebusch wrote: > Hi tech, > > I have added some examples to the fw_update manpage, to show how you can > install, update or delete a firmware package. > It tooks a little while until I figured out how fw_update works, so maybe it > can help th

fw_update manpage examples

2014-01-18 Thread Fritjof Bornebusch
Hi tech, I have added some examples to the fw_update manpage, to show how you can install, update or delete a firmware package. It tooks a little while until I figured out how fw_update works, so maybe it can help the next one. Regards, Fritjof Index: fw_update.1 ==