summaryrefslogtreecommitdiffstats
path: root/Source/cmDepends.h
blob: b9e3f99f9306d52928cc4fc47483913a18483923 (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
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
/*=========================================================================

  Program:   CMake - Cross-Platform Makefile Generator
  Module:    $RCSfile$
  Language:  C++
  Date:      $Date$
  Version:   $Revision$

  Copyright (c) 2002 Kitware, Inc., Insight Consortium.  All rights reserved.
  See Copyright.txt or http://www.cmake.org/HTML/Copyright.html 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 cmDepends_h
#define cmDepends_h

#include "cmStandardIncludes.h"

/** \class cmDepends
 * \brief Dependency scanner superclass.
 *
 * This class is responsible for maintaining a .depends.make file in
 * the build tree corresponding to an object file.  Subclasses help it
 * maintain dependencies for particular languages.
 */
class cmDepends
{
public:
  /** Instances need to know the build directory name and the relative
      path from the build directory to the target file.  */
  cmDepends();
  
  /** set the name directory and extensions of the target file to scan */
  void SetTargetFile(const char* dir, const char* targetFile, 
                     const char *markExt, const char *makeExt);

  /** should this be verbose in its output */
  void SetVerbose(bool verb) { m_Verbose = verb; }
    
  /** Virtual destructor to cleanup subclasses properly.  */
  virtual ~cmDepends();

  /** Write dependencies for the target file.  */
  bool Write();

  /** Check dependencies for the target file.  */
  void Check();

  /** Clear dependencies for the target file so they will be regenerated.  */
  void Clear();

  /** Get the name of the dependency make file.  */
  const char* GetMakeFileName();

  /** Get the name of the dependency mark file.  */
  const char* GetMarkFileName();

protected:

  // Write dependencies for the target file to the given stream.
  // Return true for success and false for failure.
  virtual bool WriteDependencies(std::ostream& os)=0;

  // Check dependencies for the target file in the given stream.
  // Return false if dependencies must be regenerated and true
  // otherwise.
  virtual bool CheckDependencies(std::istream& is)=0;

  // The directory in which the build rule for the target file is executed.
  std::string m_Directory;

  // The name of the target file for which dependencies are maintained.
  std::string m_TargetFile;

  // The name of the .depends.make file corresponding to the target.
  std::string m_DependsMakeFile;

  // The name of the .depends file marking when dependencies were generated.
  std::string m_DependsMarkFile;

  // Flag for verbose output.
  bool m_Verbose;

private:
  cmDepends(cmDepends const&); // Purposely not implemented.
  void operator=(cmDepends const&); // Purposely not implemented.
};

#endif