BEGIN {
foreach (qw(Mac::Files)) {
$MOD_AVAIL{$_} = eval "use $_; 1";
}
}
package HeaderDoc::ObjCCategory;
use HeaderDoc::Utilities qw(findRelativePath safeName getAPINameAndDisc printArray printHash);
use HeaderDoc::ObjCContainer;
@ISA = qw( HeaderDoc::ObjCContainer );
use strict;
use vars qw($VERSION @ISA);
$VERSION = '1.20';
my $isMacOS;
my $pathSeparator;
if ($^O =~ /MacOS/i) {
$pathSeparator = ":";
$isMacOS = 1;
} else {
$pathSeparator = "/";
$isMacOS = 0;
}
my $debugging = 0;
my $tracing = 0;
my $outputExtension = ".html";
my $tocFrameName = "toc.html";
my $theTime = time();
my ($sec, $min, $hour, $dom, $moy, $year, @rest);
($sec, $min, $hour, $dom, $moy, $year, @rest) = localtime($theTime);
$moy++;
$year += 1900;
my $dateStamp = "$moy/$dom/$year";
sub _initialize {
my($self) = shift;
$self->SUPER::_initialize();
$self->tocTitlePrefix('Category:');
}
sub className {
my $self = shift;
my ($className, $categoryName) = &getClassAndCategoryName($self->name());
return $className;
}
sub categoryName {
my $self = shift;
my ($className, $categoryName) = &getClassAndCategoryName($self->name());
return $categoryName;
}
sub getMethodType {
my $self = shift;
my $declaration = shift;
my $methodType = "";
if ($declaration =~ /^\s*-/) {
$methodType = "instm";
} elsif ($declaration =~ /^\s*\+/) {
$methodType = "clm";
} else {
my $filename = $HeaderDoc::headerObject->filename();
print "$filename:0:Unable to determine whether declaration is for an instance or class method.\n";
print "$filename:0: '$declaration'\n";
}
return $methodType;
}
sub docNavigatorComment {
my $self = shift;
my $name = $self->name();
$name =~ s/\s+//g;
my $navComment = "<!-- headerDoc=cat; name=$name-->";
my $appleRef = "<a name=\"//apple_ref/occ/cat/$name\"></a>";
return "$navComment\n$appleRef";
}
sub objName { my $obj1 = $a;
my $obj2 = $b;
if ($HeaderDoc::sort_entries) {
return ($obj1->name() cmp $obj2->name());
} else {
return (1 cmp 2);
}
}
sub getClassAndCategoryName {
my $fullName = shift;
my $className = '';
my $categoryName = '';
if ($fullName =~ /(\w+)\s*(\((.*)\))?/) {
$className = $1;
$categoryName =$3;
if (!length ($className)) {
my $filename = $HeaderDoc::headerObject->filename();
print "$filename:0:Couldn't determine class name from category name '$fullName'.\n";
}
if (!length ($categoryName)) {
my $filename = $HeaderDoc::headerObject->filename();
print "$filename:0:Couldn't determine category name from category name '$fullName'.\n";
}
} else {
my $filename = $HeaderDoc::headerObject->filename();
print "$filename:0:Specified category name '$fullName' isn't complete.\n";
print "$filename:0: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 "------------------------------------\n";
print "ObjCCategory\n";
print " associated with class: $className\n";
print " category name: $categoryName\n";
print "Inherits from:\n";
$self->SUPER::printObject();
}
1;