Brock Pytlik wrote: > On 06/23/11 17:08, Danek Duvall wrote: > >Brock Pytlik wrote: > > > >>http://cr.opensolaris.org/~bpytlik/ips-18441-v2/ > > > >pkg.1.txt: > > > > - line 1244: might be useful to have a second line showing the output of > > "pkg freeze" after this. > sure > > - line 1249: This is supposed to have output, no? > > > Yeah. I was just following the examples the other examples set where > they show a command but not output. If you'd like output, I'll add it > to the freeze examples.
I think that as they are, the examples are uninteresting -- they do nothing more than demonstrate the commandline flags. The things that make examples interesting are combinations of commandline options that a user might not think of independently, or ones that show a common task which might not be easy to express. Interesting output is another thing that makes an example interesting -- see the contents and search examples. > > - line 1251: I don't know that this demonstrates anything interesting. > > Well, I feel that way about many of our examples in general, especially > for something like freeze.. However, if we're going to have "freeze" > examples, then having at least one "unfreeze" example makes sense to me. I'll agree that we have a bunch of examples that are pretty silly. 3, 13-20, maybe the set-publisher ones. And 22 would be better with a more realistic set of package names. If you don't think that there's any interesting output to be shown here, then I'd just not put in any examples. We don't have to demonstrate every single aspect of every single subcommand. Danek _______________________________________________ pkg-discuss mailing list [email protected] http://mail.opensolaris.org/mailman/listinfo/pkg-discuss
