ACC SHELL

/**
 * 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 47224 2008-04-30 12:17:01Z mvidner $
 */

{

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>Start NTP Daemon</big></b><br>
Select whether to start the NTP daemon now and on every system boot. 
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>"),

    "secure" : _("<p><b><big>Secure NTP Configuration</big></b><br>
By selecting <b>Restrict NTP Service to Configured Servers Only</b>, remote hosts will not be able to view and modify NTP settings on your 
computer. The NTP service is restricted to servers in the <tt>/etc/ntp.conf</tt> file and to localhost.<br> 
Access control flags can be fine-tunded in the servers overview table. This option is not available if NTP is configured via DHCP.</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>Display Log</big></b></p>
<p>To view the logs of the NTP daemon, click <b>Display Log</b>.</p>
"),

    // help text to a button
    "complex_button" : _("<p><b><big>Advanced configuration</big></b><br>
To configure this host to synchronize against multiple remote hosts or against
a locally connected clock, use <b>Advanced 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>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 for the device,
click <b>Browse</b>.
For some 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 the <b>Address</b> entry.
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> and
choose between <b>Local NTP Server</b> and <b>Public NTP Server</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, was removed

    // 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/ntp-doc/confopt.htm</i>.</p>"),

    "restrict" : _("<p><b><big>Access Control Options</big></b><br>
Define the access control flags (<b><tt>restrict</tt></b> directive in
<i>/etc/ntp.conf</i>) for this server, indicating which types of actions the remote
host can perform on your NTP daemon. By default, it is set to <i>notrap
nomodify noquery</i>. This option is only available if you have checked the
<b>Restrict NTP Service to Configured Servers Only</b> option in
<b>Security Settings</b>.</p>\n"),

    // 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>Outgoing Broadcast</b>.</p>")
    // help text 6/6
    + _("<p>To accept NTP packets broadcasted by other hosts on the network
and use them for setting local time, select <b>Incoming Broadcast<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>"),

    // help text connected with checkbox: "Use Random Server from pool.ntp.org"
    // rwalter, please, correct it ;)
    "use_random_servers" : _("<p><big><b>Use Random Servers</b></big><br>
This service is offered by pool.ntp.org. If you select this option,
three different servers are added to the configuration. The server names are
permanent, but they change their DNS records (IPs) every hour. This means that
your NTP client is synchronized with different servers every hour.</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>ntp-doc</i> and see
<i>/usr/share/doc/packages/ntp-doc/html/refclock.htm</i></p>");
}

/* EOF */
}