Ok - so one of the steps in building CDE is an early phase called the includes phase (make includes). At this point, all of the public header files are exported to exports/include/Dt, DtI, ... Then, the software is built using that include dir. This of course does not work in autotools. Much of the software does things like #include <Dt/something.h>, so in order for the build to succeed, this behavior must be represented/replicated in some way. It seems the usual way of dealing with this is to place all public headers (and in some projects, ALL headers) into a toplevel include directory. We now do this for all public headers - they have been moved from wherever they were and placed in the appropriate spot in includes/ This will break the Imake 'make includes' phase unless the Imakefiles are fixed (remove the HEADERS = stuff, and the incdir defines). This has not been done at this point since in reality, once autotools works properly, there will be no need for the Imake stuff anymore, and I intend to get rid of it. This is just a warning for now - Imake builds in this tree will now fail at the 'includes' stage. This commit is only the migration. In upcoming commits, libtt will be fixed so that the hack being used before to get around this problem is removed as there will no longer be any need. And then the autotools work continues...
202 lines
6.5 KiB
C
202 lines
6.5 KiB
C
/*
|
|
* CDE - Common Desktop Environment
|
|
*
|
|
* Copyright (c) 1993-2012, The Open Group. All rights reserved.
|
|
*
|
|
* These libraries and programs are free software; you can
|
|
* redistribute them and/or modify them under the terms of the GNU
|
|
* Lesser General Public License as published by the Free Software
|
|
* Foundation; either version 2 of the License, or (at your option)
|
|
* any later version.
|
|
*
|
|
* These libraries and programs are distributed in the hope that
|
|
* they will be useful, but WITHOUT ANY WARRANTY; without even the
|
|
* implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
|
* PURPOSE. See the GNU Lesser General Public License for more
|
|
* details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with these libraries and programs; if not, write
|
|
* to the Free Software Foundation, Inc., 51 Franklin Street, Fifth
|
|
* Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
/* $XConsortium: HelpTermP.h /main/4 1995/10/26 12:25:56 rswiston $ */
|
|
/*************************************<+>*************************************
|
|
*****************************************************************************
|
|
**
|
|
** File: FormatTerm.h
|
|
**
|
|
** Project: Cache Creek (Rivers) Project:
|
|
**
|
|
** Description: Public Header file for FormatTerm.c, the terminal access
|
|
** functions.
|
|
**
|
|
** (c) Copyright 1987, 1988, 1989, 1990, 1991, 1992 Hewlett-Packard Company
|
|
**
|
|
** (c) Copyright 1993, 1994 Hewlett-Packard Company
|
|
** (c) Copyright 1993, 1994 International Business Machines Corp.
|
|
** (c) Copyright 1993, 1994 Sun Microsystems, Inc.
|
|
** (c) Copyright 1993, 1994 Novell, Inc.
|
|
**
|
|
*******************************************************************
|
|
*************************************<+>*************************************/
|
|
#ifndef _DtHelpFormatTermP_h
|
|
#define _DtHelpFormatTermP_h
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**************************
|
|
* Link Types and Window
|
|
* Hints should match what
|
|
* is in Canvas.h
|
|
**************************/
|
|
/**************************
|
|
* Link Types
|
|
**************************/
|
|
|
|
#ifndef CELinkType_Execute
|
|
#define CELinkType_Execute 3
|
|
#endif
|
|
#ifndef CELinkType_ManPage
|
|
#define CELinkType_ManPage 4
|
|
#endif
|
|
#ifndef CELinkType_AppDefine
|
|
#define CELinkType_AppDefine 5
|
|
#endif
|
|
#ifndef CELinkType_SameVolume
|
|
#define CELinkType_SameVolume 6
|
|
#endif
|
|
#ifndef CELinkType_CrossLink
|
|
#define CELinkType_CrossLink 7
|
|
#endif
|
|
#ifndef CELinkType_TextFile
|
|
#define CELinkType_TextFile 8
|
|
#endif
|
|
|
|
|
|
/**************************
|
|
* Window Hint Kinds
|
|
**************************/
|
|
|
|
#ifndef CEWindowHint_PopupWindow
|
|
#define CEWindowHint_PopupWindow 1
|
|
#endif
|
|
#ifndef CEWindowHint_CurrentWindow
|
|
#define CEWindowHint_CurrentWindow 2
|
|
#endif
|
|
#ifndef CEWindowHint_NewWindow
|
|
#define CEWindowHint_NewWindow 3
|
|
#endif
|
|
|
|
/******** Public Defines Declarations ********/
|
|
|
|
/******** Public Structures Declarations ********/
|
|
|
|
|
|
/*****************************************************************************
|
|
* Structure: DtHelpHyperLines
|
|
*
|
|
* Fields: title Indicates the title of the linked topic.
|
|
* specification Contains the hypertext link information.
|
|
* hyper_type Specifies the hypertext links type.
|
|
*
|
|
*
|
|
*****************************************************************************/
|
|
typedef struct {
|
|
char *title;
|
|
char *specification;
|
|
int hyper_type;
|
|
int win_hint;
|
|
} DtHelpHyperLines;
|
|
|
|
|
|
/******** Public Function Declarations ********/
|
|
|
|
/*****************************************************************************
|
|
* Function: extern void _DtHelpFreeTopicData (
|
|
* char **helpList,
|
|
* DtHelpHyperLines *hyperList)
|
|
*
|
|
*
|
|
* Parameters: helpList Specifies the parent widget ID.
|
|
* hyperList Specifies the name of the created dialog
|
|
*
|
|
* Return Value: void.
|
|
*
|
|
* Purpose: Free up the info gotten by _DtHelpGetTopicData.
|
|
*
|
|
*****************************************************************************/
|
|
extern void _DtHelpFreeTopicData (
|
|
char **helpList,
|
|
DtHelpHyperLines *hyperList);
|
|
|
|
|
|
|
|
/*****************************************************************************
|
|
* Function: extern int _DtHelpGetTopicData(
|
|
* char *helpVolume,
|
|
* char *locationID,
|
|
* int maxColumns,
|
|
* char ***helpList,
|
|
* DtHelpHyperLines **hyperList);
|
|
*
|
|
* Parameters:
|
|
*
|
|
*
|
|
* Return Value: int value, -1 implies that the function call failed, a
|
|
* value of 0, implies that the call was successful.
|
|
*
|
|
* Purpose: Allows developers to extract semi-formatted ASCII data
|
|
* from a Cache Creek help file.
|
|
*
|
|
*****************************************************************************/
|
|
extern int _DtHelpGetTopicData (
|
|
char *helpVolume,
|
|
char *locationID,
|
|
int maxColumns,
|
|
char ***helpList,
|
|
DtHelpHyperLines **hyperList);
|
|
|
|
|
|
|
|
/*****************************************************************************
|
|
* Function: extern int _DtHelpProcessLinkData(
|
|
* DtHelpHyperLines *hyperLine,
|
|
* char **helpVolume,
|
|
* char **locationId )
|
|
*
|
|
*
|
|
* Parameters:
|
|
*
|
|
*
|
|
* Return Value: int value, -1 implies that the function call failed, a
|
|
* value of 0, implies that the call was successful.
|
|
*
|
|
* Purpose: This function is used in conjunction with the
|
|
* _DtHelpGetTopicData() function call to provide developers
|
|
* with a mechanism in which they can traverse Cache Creek
|
|
* hypertext links. This call will return the file and
|
|
* locationid information that when used with the
|
|
* DtGetTopicData function will retrrieve the help text
|
|
* and new hypertext information associated with the previous
|
|
* hypertext link information.
|
|
*
|
|
*****************************************************************************/
|
|
extern int _DtHelpProcessLinkData (
|
|
char *ref_volume,
|
|
DtHelpHyperLines *hyperLine,
|
|
char **helpVolume,
|
|
char **locationId);
|
|
|
|
|
|
#ifdef __cplusplus
|
|
} /* Close scope of 'extern "C"' declaration which encloses file. */
|
|
#endif
|
|
|
|
|
|
#endif /* _DtHelpFormatTermP_h */
|
|
/* DON'T ADD ANYTHING AFTER THIS #endif */
|