NAME

TM::FAQ - Topic Maps, Frequently Angering Quirks

FAQ, TIPS AND PITFALLS

• Q: How can I get rid of these annoying topics occurrence, name, etc. which I have not put into the map in the first place. They seem to be in each map I create.

  A: These infrastructure topics are needed to make the map complete (everything used is defined). Per se, you cannot remove them and, seriously you probably do not want that to happen.

  But you can filter these out when you retrieve a list of toplets:

     my @ts   = $tm->toplets (\ '+all -infrastructure');

• Q: How can I get all names and/or occurrences of a topic?

  A: If you have a topic identifier mytopic in your hand, then you can get all characteristics (= names and occurrences, but not associations) with

      my @cs = $tm->match_forall (char => 1, irole => $tm->tids ('mytopic'));

  Then you can filter occording the type, the scope, the data type value or the KIND. The latter tells you whether an assertion is a name or occurrence. For example those occurrences which are occurrences and not anything specials as, say, homepage:

      my @occs  = map  { $_->[0] } 
                  map  { TM::get_x_players ($tm, $_, 'value') }
                  grep { $_->[TM->TYPE] eq 'occurrence' } @cs;

• Q: Some of these maps I create have the trait ResourceAble and import therefore a method mtime. How does this work?

  A: Every map which is attached to an external resource is said to be resourceable, hence the trait with the same name. You, the developer, decide which copy of the map is the authoritative, i.e. what should happen should the map infrastructure be forced to synchronize the content.

  While the synchronization (and when that is triggered) is handled by the trait TM::Synchronizable, the infrastructure needs to know (a) when the in-memory copy of the map was last modified and (b) when the resource to which it is attached has been modified last. This is the reasons for timestamps on the memory-stored map.

  The resources themselves also have these timestamps; when the resource is a file on a file system, then the "last modified" timestamps are take from there. The only complication is that TM is using a much higher time resolution as most file systems (HiRes::Time).

• Q: When using AsTMa (1.x) it is very difficult to figure out where I make a syntax error. Is there a convenient and effective way? What about line numbers?

  A: One approach is to use the %cancel method: When added to the file, the parser will stop there and write a message onto STDERR. Another method is to use %trace 1 within the AsTMa stream. Then the parser should let you know what it could detect successfully.

  Line numbers cannot be used because the file will be massively reduced before the parser actually see it.

COPYRIGHT AND LICENSE

Copyright 200[3-68] by Robert Barta, <drrho@cpan.org>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.