#######################################################################
# RCS: @(#) $Id: API.tcl,v 1.2 2004/01/09 20:53:57 scholly Exp $
#
# API.tcl: Custom TCL API Functions
#
# Copyright (C) 2004 Electronic Data Systems Corporation.  All Rights Reserved.
#
# This is a set of functions that are intended to remain static, so
# they may be used from within customizations.  Customizations written
# previously will still be refering to our internal functions names,
# which may change at any point (or may already have changed).  Please
# revise code to use functions from this file, when possible, to avoid
# this potential problem.
#
# These API functions may also be called directly from the windows
# console, script files, etc.
#
# NOTES:
#
# o Please see user.tcl for examples and more details on creating
# customizations.
#
# o A given internal function may change in terms of the name 
# itself, the parameters, the return values, or even the exact
# effect of the function.  However, the functions in this file will 
# remain static in all these ways for backwards compatability.  In
# other words, a change to the internal function(s) that these depend 
# on will remain invisible (the functions here will work consistantly), 
# while calling the internal function directly may produce unexpected
# results.
#
# o If a change makes sense for a given function, a new version
# will be added rather than modifying the existing version.  These
# will typically be named with a version number, like 
# prpInstallPSOutPrinterV2 (as a new version of prpInstallPSOutPrinter).
# This will prevent existing custom code from having to be updated
# or else no longer working properly.
#
# o Many sets of functions defined in util.tcl will not change and
# will not have wrappers here, such as keyed-list functions.
#
# o At this point, we have not written wrappers for all the code that
# is needed for writting customizations.  For now, please see 
# util.tcl and functions used by examples in user.tcl for the names
# of internal functions that may be used for writting customizations.
# We will be adding more API functions in the future.
#
#######################################################################

#######################################################################
# Printing functions
#######################################################################

#######################################################################
# Install/update the standard Windows psout external app printer
#
# NOTE: This may be called manually from the Windows console in order 
# to explicitly install the psout printer.  Normally, the printer is 
# installed automatically the first time it is needed.  However,
# permissions on printer installations may be restricted in some
# environments and an administrator will need to call this function
# directly.

proc apiInstallPSOutPrinter {} {
	return [prpInstallVVCPPrinter]
}