BEGIN {
foreach (qw(Mac::Files)) {
$MOD_AVAIL{$_} = eval "use $_; 1";
}
}
package HeaderDoc::ObjCCategory;
use HeaderDoc::Utilities qw(findRelativePath safeName getAPINameAndDisc printArray printHash registerUID unregisterUID);
use HeaderDoc::ObjCContainer;
@ISA = qw( HeaderDoc::ObjCContainer );
use strict;
use vars qw($VERSION @ISA);
$HeaderDoc::ObjCCategory::VERSION = '$Revision: 1.6 $';
my $isMacOS;
my $pathSeparator;
if ($^O =~ /MacOS/io) {
$pathSeparator = ":";
$isMacOS = 1;
} else {
$pathSeparator = "/";
$isMacOS = 0;
}
my $debugging = 0;
my $tracing = 0;
my $outputExtension = ".html";
my $tocFrameName = "toc.html";
sub _initialize {
my($self) = shift;
$self->SUPER::_initialize();
$self->tocTitlePrefix('Category:');
$self->{CLASS} = "HeaderDoc::ObjCCategory";
}
sub className {
my $self = shift;
my ($className, $categoryName) = &getClassAndCategoryName($self->name(), $self->fullpath(), $self->linenum());
return $className;
}
sub categoryName {
my $self = shift;
my ($className, $categoryName) = &getClassAndCategoryName($self->name(), $self->fullpath(), $self->linenum());
return $categoryName;
}
sub getMethodType {
my $self = shift;
my $declaration = shift;
my $methodType = "";
if ($declaration =~ /^\s*-/o) {
$methodType = "instm";
} elsif ($declaration =~ /^\s*\+/o) {
$methodType = "clm";
} else {
$methodType = HeaderDoc::CPPClass::getMethodType($self, $declaration);
}
return $methodType;
}
sub docNavigatorComment {
my $self = shift;
my $name = $self->name();
my $olduid = $self->apiuid();
$name =~ s/\s+//go;
$name =~ s/;//sgo;
my $indexgroup = $self->indexgroup(); my $igstring = "";
if (length($indexgroup)) { $igstring = "indexgroup=$indexgroup;"; }
my $uid = $self->apiuid("cat"); my $navComment = "<!-- headerDoc=cat; uid=$uid; $igstring name=$name-->";
my $appleRef = "<a name=\"$uid\"></a>";
unregisterUID($olduid, $name, $self);
registerUID($uid, $name, $self);
return "$navComment\n$appleRef";
}
sub objName { my $obj1 = $a;
my $obj2 = $b;
return (lc($obj1->name()) cmp lc($obj2->name()));
}
sub getClassAndCategoryName {
my $fullName = shift;
my $className = '';
my $categoryName = '';
my $fullpath = shift; my $linenum = shift;
if ($fullName =~ /(\w+)\s*(\((.*)\))?/o) {
$className = $1;
$categoryName =$3;
if (!length ($className)) {
print STDERR "$fullpath:$linenum: warning: Couldn't determine class name from category name '$fullName'.\n";
}
if (!length ($categoryName)) {
print STDERR "$fullpath:$linenum: warning: Couldn't determine category name from category name '$fullName'.\n";
}
} else {
print STDERR "$fullpath:$linenum: warning: Specified category name '$fullName' isn't complete. Expecting a name of the form 'MyClass(CategoryName)'\n";
}
return ($className, $categoryName);
}
sub printObject {
my $self = shift;
my $className = $self->className();
my $categoryName = $self->categoryName();
print STDERR "------------------------------------\n";
print STDERR "ObjCCategory\n";
print STDERR " associated with class: $className\n";
print STDERR " category name: $categoryName\n";
print STDERR "Inherits from:\n";
$self->SUPER::printObject();
}
1;