/**
 * File:	include/ntp-client/helps.ycp
 * Package:	Configuration of ntp-client
 * Summary:	Help texts of all the dialogs
 * Authors:	Jiri Srain <jsrain@suse.cz>
 *
 * $Id: helps.ycp 18471 2004-08-10 07:42:02Z jsrain $
 */

{

textdomain "ntp-client";

/**
 * All helps are here
 */
map HELPS = $[

    /* Read dialog help 1/2 */
    "read" : _("<p><b><big>Initializing NTP Client Configuration</big></b><br>
Please wait...<br></p>") +

    /* Read dialog help 2/2 */
    _("<p><b><big>Aborting Initialization:</big></b><br>
Safely abort the configuration utility by pressing <b>Abort</b> now.</p>"),

    /* Write dialog help 1/2 */
    "write" : _("<p><b><big>Saving NTP Client Configuration</big></b><br>
Please wait...<br></p>") +

    /* Write dialog help 2/2 */
_("<p><b><big>Aborting Saving:</big></b><br>
Abort the save procedure by pressing  <b>Abort</b>.
An additional dialog will inform you whether it is safe to do so.</p>"),

    // help text 1/5
    "start" : _("<p><b><big>Automatically Start NTP Daemon</big></b><br>
Select whether to start the NTP daemon when booting the system. The
NTP daemon resolves host names when initializing. Your
network connection must be started before the NTP daemon starts.</p>"),

    // help text 2/5
    "chroot_environment" : _("<p><b><big>Chroot Jail</big></b><br>
To run the NTP daemon in chroot jail, set
<b>Run NTP Daemon in Chroot Jail</b>. Starting any daemon in a chroot jail
is more secure and strongly recommended.</p>"),

    // help text 3/5
    "config_dhcp" : _("<p><b><big>Configuring via DHCP</big></b><br>
To retrieve the information about NTP servers via the DHCP protocol from
your network server instead of setting them manually, set
<b>Configure NTP Daemon via DHCP</b>. Ask your network administrator if
the information about NTP servers is provided by the DHCP server.</p>"),

    // help text 4/5
    "overview" : _("<p><b><big>Configured Servers</big></b><br>
To adjust NTP servers, peers, local clocks, and NTP broadcasting,
select the appropriate line and click <b>Edit</b>. To add a new synchronization
peer, click <b>Add</b>. To delete an existing synchronization peer,
select it and click <b>Delete</b>.</p>")
    +
    // help text 5/5
    _("<p><b><big>Advanced Functions</big></b><br>
To assign NTP-related firewall settings or display the log of the NTP
daemon, select <b>Advanced</b>.</p>"),

    // help text to a button
    "complex_button" : _("<p><b><big>Complex configuration</big></b><br>
To configure this host to synchronize against multiple remote hosts or against
a locally connected clock, use <b>Complex Configuration</b>."),

    // help text 1/4
    "clock_type" : _("<p><b><big>Clock Type</big></b><br>
Select the driver for the clock to configure.</p>"),

    // help text 2/4
    "unit_number" : _("<p><b><big>Unit Number</big></b><br>
If you have multiple clocks of the same type, you must set
<b>Unit Number</b>.</p>"),

    // help text 3/4
    "device" : _("<p><b><big>Clock Device</big></b><br>
To make the clock work, it may be necessary to create a special symbolic link to 
the device to which the clock is connected. To do this, check
<b>Create Symlink</b> and set the <b>Device</b>. To browse the device,
click <b>Browse</b>.
For some of the clock types, it is not necessary to create a symbolic link or 
it must be created manually.</p>"),

    // help text 4/4
    "fudge_button" : _("<p><b><big>Driver Calibration</big></b><br>
To calibrate the clock driver, click <b>Driver Calibration</b>.</p>"),

    // help text 1/1, alt. 1 part 1/3
    "server_address" : _("<p><b><big>Address of the NTP Server</big></b><br>
To set the address of the NTP server, use <b>NTP Server</b>.
To find an NTP server, ask your network administrator or Internet service
provider.</p>")
    +
    // help text 1/1, alt. 1 part 2/3
    _("<p><b><big>Selecting a Server</big></b><br>
To select an NTP server from those found in the local network
or from the list of known NTP servers, click <b>Select</b>.</p>")
    +
    // help text 1/1, alt. 1 part 3/3
    _("<p><b><big>Testing Server Accessibility</big></b><br>
To test if the selected server is up and responds properly,
click <b>Test</b>.</p>"),

    // help text 1/1, alt. 2
    "paddress" : _("<p><b><big>Address</big></b><br>
To set the address of the host with which to synchronize mutually,
use <b>Address</b>.</p>"),

    // help text 1/1, alt. 3
    "bcaddress" : _("<p><b><big>Address</big></b><br>
To set the address to which to broadcast, use the <b>Address</b>
text field.</p>"),

    // help text 1/1, alt. 4
    "bccaddress" : _("<p><b><big>Address</big></b><br>
To set the address from which to accept broadcast packets, use 
<b>Address</b>.</p>"),

    // help text 2/4, optinal
    "init_sync" : _("<p><b><big>Initial Synchronization</big></b><br>
The first synchronization of the clock is performed before the NTP daemon is
started. To use this host for initial synchronization, select
<b>Use for Initial Synchronization</b>.</p>"),

    // help text 3/4, optional
    "options" : _("<p><b><big>Options</big></b><br>
To fine tune the synchronization source, write the options to the
<b>Options</b> text field. For details, see
<i>/usr/share/doc/packages/xntp-doc/html/confopt.htm</i>.</p>"),

    // help text 1/6
    "peer_types" : _("<p><b><big>Synchronization Peer Type</big></b><br>
Select the kind of synchronization peer to add here.</p>")
    // help text 2/6
    + _("<p>To add an NTP server to which to synchronize,
select <b>Server</b>.</p>")
    // help text 3/6
    + _("<p>To add an NTP peer to synchronize mutually, select
<b>Peer</b>.</p>")
    // help text 4/6
    + _("<p>To configure a local clock connected directly to your computer,
select <b>Radio Clock</b>.</p>")
    // help text 5/6
    + _("<p>To broadcast time information through your network, select
<b>Broadcasting</b>.</p>")
    // help text 6/6
    + _("<p>To accepts NTP packets broadcasted by other hosts on the network
and use them for setting local time, select <b>Accepting Broadcast Packets<b>.</p>"),

    // help text 1/5
    "servers_source" : _("<p><big><b>Server Location</b></big>
Select if you want to find the NTP server in the local network or select
the NTP server from the list of known NTP servers.</p>"),

    // help text 2/5
    "found_servers" : _("<p><big><b>Finding Server in the Local
Network</b></big><br>
To find NTP servers in the local network using the
Service Location Protocol (SLP), click <b>Lookup</b>.
Then select a server from the list of found servers.</p>"),

    // help text 3/5
    "servers_list" : _("<p><big><b>Selecting a Public NTP Server</b></big><br>
Select the NTP server to use from the <b>Public NTP Servers</b> list. To display
NTP servers only for a particular country, select it in <b>Country</b>.</p>")
    +
    // help text 4/5
    _("<p><big><b>Note</b></big><br>
The listed NTP servers may not be available from any country, but only
for a particular country or region.
Before using any NTP server from the list, ask your system administrator
or Internet service provider if there is an NTP server closer to you and
prefer this recommended server to any server from this list.
You may also see <i>http://www.eecis.udel.edu/~mills/ntp/servers.html</i>
to find an NTP server near you.</p>"),

    // help text 5/5
    "selected_test" : _("<p><big><b>Testing Server Accessibility</b></big><br>
To test if the selected server responds properly, click <b>Test</b>.</p>"),

];

/**
 * Get help to the fudge factors settings dialog
 * @return string the help text
 */
define string fudgeHelp () ``{
    // help text 1/2
    return _("<p><big><b>Clock Driver Calibration</b></big><br>
The clock driver may need to be calibrated. In this dialog, various calibration
options can be set. The meaning of particular options depends on the particular
driver. Some drivers do not use all the options.</p>")
    +
    // help text 2/2
    _("For information about the meaning of the options, install package
<i>xntp-doc</i> and see
<i>/usr/share/doc/packages/xntp-doc/html/refclock.htm</i></p>");
}

/**
 * Get help to the firewall settings dialog
 * @return string the help text
 */
define string firewallHelp () ``{
    // help text 1/3
    return _("<p><big><b>Firewall Configuration</b></big><br>
Use <b>Change Firewall Configuration</b> to set whether to preserve
current firewall settings or set interfaces that can be used for remote
access to the NTP daemon.</p>")
    +
    // help text 2/3
    _("<p>For each interface class, set if the NTP daemon can be remotely accessed
through interfaces that belong to the interface class.</p>")
    +
    // help text 3/3
    _("<p><big><b>Automatic Proposal</b></big><br>
To propose a firewall configuration automatically according to configured
hosts against which to synchronize, use <b>Propose Configuration</b>.</p>");
}

/* EOF */
}
