This file is indexed.

/usr/include/Cable/cableTclGenerator.h is in libcableswig-dev 0.1.0+git20150808-2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
/*=========================================================================

  Program:   CABLE - CABLE Automates Bindings for Language Extension
  Module:    cableTclGenerator.h
  Language:  C++
  Date:      $Date$
  Version:   $Revision$

  Copyright (c) 2002 Kitware, Inc., Insight Consortium.  All rights reserved.
  See Copyright.txt for details.

     This software is distributed WITHOUT ANY WARRANTY; without even 
     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
     PURPOSE.  See the above copyright notices for more information.

=========================================================================*/
#ifndef _cableTclGenerator_h
#define _cableTclGenerator_h

#include "cableGenerator.h"
#include "cableCvTypeWriter.h"

namespace _cxx_ { class CvQualifiedType; class ClassType; }

namespace cable
{

class Namespace;
class Class;
class Function;
class Method;
class Type;
class FunctionType;

/** Tcl wrapper generation class.  */
class CABLE_PARSERS_EXPORT TclGenerator: public Generator
{
public:
  cableTypeMacro(TclGenerator, Generator);
  static Pointer New() { return new Self; }
  
  /** Print the configuration settings used to generate wrappers.  */
  void PrintConfiguration(std::ostream& os) const;
  
protected:
  TclGenerator();
  ~TclGenerator();
  
  class ClassWrapperMap;
  class StringVector;
  class MethodVector;
  
  // Wrapper generation method called by Generator::Generate().
  bool GenerateWrappers();  
  
  // Find configuration settings from the source representation.
  bool FindConfiguration();
  bool FindWrappers(const Namespace* cns);
  bool FindWrappers(const Namespace* wns, const char* prefix);
  
  // Methods to walk the wrappers and collect the types used.
  void FindCvTypes();
  void FindClassCvTypes(const Class* c);
  void FindFunctionCvTypes(const Function* f);
  void FindReturnCvTypes(const Type* returns);
  void FindArgumentCvTypes(const Type* argument);
  void AddCvReferenceType(const cxx::CvQualifiedType& target);
  void AddCvPointerType(const cxx::CvQualifiedType& target);
  void AddSuperclassCvTypes(const cxx::ClassType* classType);
  
  // Methods to write output code.
  void WriteHeaders() const;
  void WritePackageInitialization() const;
  void WriteWrappers() const;
  void WriteReturnEnumClasses() const;
  void WriteEnumValueRegistration() const;
  void WriteGroupTypeHandlers() const;
  void WriteReferenceDerivedToBase(const cxx::CvQualifiedType& derivedType,
                                   const cxx::CvQualifiedType& baseType) const;
  void WritePointerDerivedToBase(const cxx::CvQualifiedType& derivedType,
                                 const cxx::CvQualifiedType& baseType) const;
  void WriteClassWrappers() const;
  void WriteClassWrapper(const Class* c, const StringVector& names) const;
  void FindMethods(const Class* c, MethodVector& methods,
                   MethodVector& converters) const;
  void WriteClassWrapperDefinition(const Class* c, const StringVector& names,
                                   const MethodVector& methods) const;
  void WriteMethodName(const Method* m, unsigned int index) const;
  void WriteMethodWrapper(const Class* c, const MethodVector& methods,
                          unsigned int index) const;
  bool ReturnsVoid(const Function* f) const;
  String GetReturnTypeName(const Function* f) const;
  void WriteMethodComment(const Class* c, const Method* m) const;
  void WriteImplicitArgument(const Class* c, const Method* m) const;
  void WriteReturnBegin(const Function* f) const;
  void WriteReturnEnd(const Function* f) const;
  void WriteArgumentList(const FunctionType* ft, unsigned int offset,
                         unsigned int count) const;
  void WriteClassWrapperRegistration(const Class* c,
                                     const StringVector& names,
                                     const MethodVector& methods,
                                     const MethodVector& converters) const;
  void WriteMethodRegistration(const Class* c, const MethodVector& methods,
                               unsigned int index) const;
  void WriteConverterRegistration(const Class* c, const Method* m) const;
  
  typedef StringVector GroupVector;
  typedef StringVector WrapperList;
  
  // The set of classes to be wrapped.
  ClassWrapperMap& m_ClassWrapperMap;
  
  // The list of groups combined in the package to be generated.
  GroupVector& m_GroupVector;
  
  // The name of the group of wrappers to be generated.
  String m_Group;
  
  // The name of the package to be generated.
  String m_Package;
  
  // The version string of the package to be generated.
  String m_PackageVersion;
  
  // Whether a group of wrappers will be generated.
  bool m_WriteGroup;
  
  // Whether package initialization code will be generated.
  bool m_WritePackage;
  
  // The name of the cable configuration file.
  String m_ConfigFileName;
  
  // Utility to write the CxxTypes library code in the output.
  CvTypeWriter::Pointer m_CvTypeWriter;
  
  // The list of wrapper classes that have been generated.
  WrapperList& m_WrapperList;
  
  class ClassTypeSet;
  class EnumerationSet;
  typedef ClassTypeSet ClassesForDerivedToBase;
  typedef ClassTypeSet ClassesThatNeedDestructor;
  typedef EnumerationSet EnumerationsThatNeedReturn;
  typedef EnumerationSet EnumerationsThatNeedValues;
  
  // Keep track of entities that need special consideration.
  ClassesForDerivedToBase& m_ClassesForDerivedToBase;
  ClassesThatNeedDestructor& m_ClassesThatNeedDestructor;
  EnumerationsThatNeedReturn& m_EnumerationsThatNeedReturn;  
  EnumerationsThatNeedValues& m_EnumerationsThatNeedValues;

  // Internal utility methods.
  bool ParseName(const char* name, String& result);
private:
  TclGenerator(const Self&);  // Not implemented.
  void operator=(const Self&);  // Not implemented.
};

} // namespace cable

#endif