Alan Coopersmith wrote: > I've resync'ed with Stephen's changes and posted a new webrev, > including HTML formatted output of the new guide pages, to: > > http://cr.opensolaris.org/~alanc/pkg-attributes-doc/
This looks nice, thanks. > I've updated both the .rst & .txt even though I thought the .txt files > were being removed when they were transformed to .rst (the > doc/README.guide says they'd be renamed) but that doesn't appear to be > happening yet. I'm not sure why Stephen didn't do that, but unless we can come up with a good reason, we should probably torch the .txt files. > As a note, it seems the distinction between "tags" & "attributes" that's > described in the doc isn't used in most conversations I see about them - > I often hear both referred to as attributes, and noticed Stephen's > updates even got the terms swapped in one place. > > Is "package attribute" and "action attribute" going to be a simpler way > to describe them? Should the docs move towards that in the future? I think so, yes. I think we use "tag" more now as a verb -- "tag an action with ..." or, less frequently, "tag a package ..." -- than a noun, but when we do use it as a noun, it's pretty much interchangeable with "attribute". Danek _______________________________________________ pkg-discuss mailing list [email protected] http://mail.opensolaris.org/mailman/listinfo/pkg-discuss
