////////////////////////////////////////////////////////////////////////////////
// <file
//   repository_path  = "$Source: /pub/cvsprojects/nucleo/web/home/meta/js/openHelpWin.js,v $"
//   revision         = "$Revision: 1.1 $"
//   date             = "$Date: 2005/09/01 13:35:01 $"
//   tag              = "$Name:  $"
//   template_version = "cp_template.0.12"
// >
//   <license>
//     We have not chosen a copyright/license at the time of this release.
//   </license>
// </file>
////////////////////////////////////////////////////////////////////////////////

//##############################################################################
// <routine name="openHelpWin">
//
//   <description>
//     <abstract>
//       Function opens a pop-up window with set size.  This window is intended
//       to house help information about a particular web-site or online tool.
//       the id of this window is 'help'
//     </abstract>
//     <keywords>
//      pop-up, javascript, help, window, information 
//     </keywords>
//   </description>
// 
//   <authors>
//     <current>
//       <author userid="jdenny" start_date="2005/06/11" />
//       <author userid="jsbrown" start_date="2005/06/11" />
//     </current>
//     <previous>
//     </previous>
//   </authors>
// 
//   <compatibility>
//     Browser: IE version 6.0.2900.2180.xpsp_sp2_rtm.040803-2158;
//     Browser: Mozilla 1.7.3;
//     Browser: Firefox version 1.0;
//     Browser: Opera 7.54, build 3869;
//   </compatibility>
//
//   <usage>
// 
//     <calling_sequence>
//       openHelpWin(page)
//     </calling_sequence>
// 
//     <param name="page" kind="in,positional"     doc="page" />
//     <param name="return" kind="return"     doc="return,example" />
// 
//     <doc kind="pre" id="page">
//       page is a javascript string that is the path (absolute or relative)
//       of the infromation xhtml file that is displayed in the window.
//     </doc>
// 
//     <doc kind="post" id="return">
//       return is the resulting javascript which opens the pop-up window.
//     </doc>
// 
//     <doc kind="example" id="example">
//       Given an XHTML anchor tag, pop-up a window upon clicking link:
//
//       <a href="www.cnn.com" 
//         onclick="return openHelpWin('www.cnn.com')"
//       >
//         www.cnn.com  
//       </a>  
//
//     </doc>
// 
//   </usage>
//
// </routine>
//##############################################################################

function openHelpWin(page) {
  var win_handle = window.open(page,'help',
    'width='+500+',height='+300+',screenX=20,screenY=20,left=20,top=20,'+
    'scrollbars=1,resizable=1,toolbar');
  win_handle.focus();
}