Files
cdesktop/cde/include/Dt/SaverP.h
Jon Trulson 369308b737 The great includes migration of 2019 (autotools)
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...
2019-10-25 17:01:34 -06:00

113 lines
3.6 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: SaverP.h /main/4 1995/10/26 15:10:42 rswiston $ */
/* *
* (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. *
*/
/************************************<+>*************************************
****************************************************************************
**
** File: Saver.h
**
** Description
** -----------
** Variables and declarations needed for
** managing external screen savers
**
****************************************************************************
************************************<+>*************************************/
#ifndef _dtsaverp_h
#define _dtsaverp_h
/*************************************<->*************************************
*
* _DtSaverStart()
*
*
* Description:
* -----------
* Store provided array of windows on root window property
* _DT_SAVER_WINDOWS and launch specified screen saver. Screen savers
* will attempt to use these windows as drawables.
*
* Inputs:
* ------
* display - display structure
* drawArea - array of widgets to be drawn upon by screen saver
* count - number of elements in drawArea array
* saverAction - screen saver action to invoke
* wAction - action UI widget
*
* Outputs:
* -------
*
* Return:
* -------
* state - pointer to opaque state structure
*
* Comments:
* --------
* This function uses _DtActionInvoke() to launch an action. As a result,
* the caller is responsible for loading and maintaining the action database
* using the DtDbLoad() function and procedures. The caller
* must call _DtSaverStop() to terminate screen saver
*
*************************************<->***********************************/
extern void * _DtSaverStart(Display *, Widget *, int, char *, Widget);
/*************************************<->*************************************
*
* _DtSaverStop()
*
*
* Description:
* -----------
* Stop an external screen saver started with DtStartSaver(). Deletes
* _DT_SAVER_WINDOWS property from root window.
*
* Inputs:
* ------
* display - display structure
* state - state returned from _DtSaverStart()
*
* Outputs:
* -------
*
* Return:
* -------
*
* Comments:
* --------
*
*************************************<->***********************************/
extern void _DtSaverStop(Display *, void *);
#endif /*_dtsaverp_h*/
/* DON'T ADD ANYTHING AFTER THIS #endif */