about summary refs log tree commit diff
path: root/docs/tool/Modules/NaturalDocs/SourceDB/ItemDefinition.pm
blob: ee053fef352fdf1886f339bd68eef1ac4e9e7787 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
###############################################################################
#
#   Package: NaturalDocs::SourceDB::ItemDefinition
#
###############################################################################
#
#   A base class for all item definitions for extensions that track more than existence.
#
###############################################################################

# This file is part of Natural Docs, which is Copyright (C) 2003-2008 Greg Valure
# Natural Docs is licensed under the GPL

use strict;
use integer;


package NaturalDocs::SourceDB::ItemDefinition;


#
#   Function: Compare
#
#   Returns whether the definitions are equal.  This version returns true by default, you must override it in your subclasses
#   to make the results relevant.  This is important for <NaturalDocs::SourceDB->AnalyzeTrackedFileChanges()>.
#
#   This will only be called between objects of the same <ExtensionID>.  If you use multiple derived classes for the same
#   <ExtensionID>, you will have to take that into account yourself.
#
#   Parameters:
#
#       other - Another <NaturalDocs::SourceDB::ItemDefinition>-derived object to compare this one to.  It will always be from
#                  the same <ExtensionID>.
#
#   Returns:
#
#       Whether they are equal.
#
sub Compare #(other)
    {
    return 1;
    };


1;