31881265c7
documentation for all modules found in CMAKE_MODULE_PATH, which currently has to be specified via -D, this can later on be improved e.g. by reading a special (to-be-created) file like CMakeFiles/ModulePath.cmake in the build tree so that running cmake help in the build tree of a project will always give you the current module path. (This could actually also help IDEs which would like to support cmake for projects...) Alex
63 lines
2.2 KiB
C++
63 lines
2.2 KiB
C++
/*=========================================================================
|
|
|
|
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 _cmDocumentationFormatter_h
|
|
#define _cmDocumentationFormatter_h
|
|
|
|
#include "cmStandardIncludes.h"
|
|
|
|
/** This is just a helper class to make it build with MSVC 6.0.
|
|
Actually the enums and internal classes could directly go into
|
|
cmDocumentation, but then MSVC6 complains in RequestedHelpItem that
|
|
cmDocumentation is an undefined type and so it doesn't know the enums.
|
|
Moving the enums to a class which is then already completely parsed helps
|
|
against this. */
|
|
class cmDocumentationEnums
|
|
{
|
|
public:
|
|
/** Types of help provided. */
|
|
enum Type
|
|
{ None, Usage, Single, SingleModule, SingleProperty,
|
|
List, ModuleList, PropertyList,
|
|
Full, Properties, Modules, CustomModules, Commands, CompatCommands,
|
|
Copyright, Version };
|
|
|
|
/** Forms of documentation output. */
|
|
enum Form { TextForm, HTMLForm, ManForm, UsageForm };
|
|
};
|
|
|
|
/** Base class for printing the documentation in the various supported
|
|
formats. */
|
|
class cmDocumentationFormatter
|
|
{
|
|
public:
|
|
cmDocumentationFormatter();
|
|
virtual ~cmDocumentationFormatter();
|
|
void PrintFormatted(std::ostream& os, const char* text);
|
|
|
|
virtual cmDocumentationEnums::Form GetForm() const = 0;
|
|
|
|
virtual void PrintHeader(const char* /*name*/, std::ostream& /*os*/) {}
|
|
virtual void PrintFooter(std::ostream& /*os*/) {}
|
|
virtual void PrintSection(std::ostream& os,
|
|
const cmDocumentationEntry* section,
|
|
const char* name) = 0;
|
|
virtual void PrintPreformatted(std::ostream& os, const char* text) = 0;
|
|
virtual void PrintParagraph(std::ostream& os, const char* text) = 0;
|
|
};
|
|
|
|
#endif
|