Chris, your notes are reasonable. I've changed "item" to "promise" to make it clearer. Still I believe that it's not that easy to ignore "promise" part. What important part is left from the description is the syntax for calling edit_line bundles and compound bodies from the promises description. I didn't invent the short and clear way to describe it yet.
2010/11/2 C R Ritson <c.r.rit...@newcastle.ac.uk>: >> topic: https://cfengine.com/forum/read.php?3,18931,19016#msg-19016 >> >>Mark, >> >>I propose to add my explanation from above to the reference. I believe >>it's clear enough. > > This prompted me, as a struggling newcomer, to have another look at the > topic. It's very easy to ignore the "item" in that description. If you do > this (and ignore the filtering effect of classes) you end up degenerating to:- > > - a bundle is a semicolon separated list of <property> => <value> pairs > > - a body is a comma separated list of <property> => <value> pairs > > When you do update the documentation, can you find some way of rewording the > first bit of > > Accordingly, bodies are only used as property containers > while bundles are only used for promises definitions. > > The control bodies are only exception to the naming > convention (the control word comes third, not second), > and they define the Cfengine component controls. > > to make sure that you highlight that a bundle MUST have an item, as it is a > set of promises about the state of that item. Then find an equally short way > of describing a body. > > Chris Ritson (Computing Officer and School Safety Officer) > > Room 707, Claremont Tower, EMAIL: c.r.rit...@ncl.ac.uk > School of Computing Science, PHONE: +44 191 222 8175 > Newcastle University, FAX : +44 191 222 8232 > Newcastle upon Tyne, UK NE1 7RU. WEB : http://www.cs.ncl.ac.uk/ > > > _______________________________________________ > Help-cfengine mailing list > Help-cfengine@cfengine.org > https://cfengine.org/mailman/listinfo/help-cfengine > -- SY, Seva Gluschenko. _______________________________________________ Help-cfengine mailing list Help-cfengine@cfengine.org https://cfengine.org/mailman/listinfo/help-cfengine
