Ken McDonell wrote:
On Thu, 2010-07-29 at 14:01 +1000, Greg Banks wrote:
Wow, I never thought I'd say this but...the first thing I can see wrong
with this manpage is that it *over*documents things.
Some people are hard to please ... 8^)>
:)
MAPPING CONFIGURATION
The mapfile contains specifications in standard XML 1.0 format.
For new XML-based formats you really ought to be providing a DTD
(they're easy, see http://csharpcomputing.com/XMLTutorial/Lesson8.htm
for what seems to be an adequate tutorial) or perhaps a schema (I've
never done one of these, but see http://www.w3.org/XML/Schema#dev ).
I feel like I'm recovering from a radical lobotomy after battling
timezones in the Perl/libc/PCP no man's land ... I need some time to
recover before launching into anything new, easy or not. But I will
follow up on this suggestion.
Fair enough.
timezone Set the source timezone in the PCP archive (the
default is to
use UTC). Example: timezone="+1100".
I assume that all timezone name formats that work with tzset() work
here? If so you should say so.
Nope. I finally nutted this out in iostat2pcp, and +HHMM or -HHMM is
the only thing that is going to work here. I've updated the code and
the documentation to reflect that.
Ouch. I'd ask for details but I'm afraid to hear the reply.
Otherwise indom
should be specified as 2 numbers separated by periods
(.) to
set the domain and ordinal fields of the Instance Domain.
The other paragraphs around this one have a reference to another manpage
where e.g. the fields of a pmid are explained. Something like that
would be useful at this point.
Unfortunately this is not documented in any man page ... best option is "see
the __pmInDom_int typedef in <pcp/impl.h>".
Oh dear.
--
Greg.
|