<para>O &kcron; é um aplicativo feito para agendar programas que rodam em segundo plano. Ele é uma interface gráfica para o <command>cron</command>, o agendador de sistema do &UNIX;.</para>
<important><para>Não esqueça de informar ao seu sistema para iniciar o daemon do cron (<filename>crond</filename> anteriormente, pois de outro modo o &kcron; não vai funcionar.</para></important>
<para>Quando o &kcron; inicia você vê um resumo das tarefas agendadas existentes e das variáveis de ambiente associadas. Se você está rodando como superusuário, você verá os itens de todos os usuários além dos itens de sistema agendados. Cada uma das pastas pode ser expandida ou contraída.</para>
<para>Variáveis de ambientes que aparecerem aqui irão sobrescrever qualquer variável de ambiente previamente existente para todas as tarefas agendadas. Se uma variável de ambiente for desabilitada, nenhum valor irá aparecer e a descrição estará desabilitada.</para>
<para>Para agendar uma nova tarefa, selecione inicialmente a pastas <guilabel>Tarefas</guilabel>. Entao selecione <menuchoice><guimenu>Editar</guimenu><guimenuitem>Novo...</guimenuitem></menuchoice>. Alternativamente, você pode usar o botão<mousebutton>direito</mousebutton> do mouse e escolher <menuchoice><guimenuitem>Novo...</guimenuitem></menuchoice>, ou simplesmente pressionar <keycombo action="simul"><keycap>Ctrl</keycap><keycap>N</keycap></keycombo>.</para>
<listitem><para>Entre o nome do programa. Você pode especificar tanto um caminho relativo quanto absoluto. Se você quiser procurar pelo programa, pressione <guibutton>Procurar...</guibutton>.</para>
<listitem><para>Selecione o minuto de agendamento da tarefa. O &kcron; não suporta agendamento de tarefas em intervalos menores do que cinco minutos.</para>
<para>Se você selecionou tanto dias do mês, quanto dias da semana, a tarefa será executada quando quaisquer das condições for satisfeita. Por exemplo, se você selecionou o 1° e 15° dias do mês, e selecionou Domingo, o programa será executado todos os dias primeiro e quinze (independente do dia da semana) e também todos os domingos do mês (independente do dia do mês).</para>
<para>Para cortar uma tarefa agendada, primeiramente selecione a tarefa a ser cortada. Então selecione <menuchoice><guimenu>Editar</guimenu><guimenuitem>Cortar</guimenuitem></menuchoice>.</para> <para>Alternativamente, você pode usar o botão <mousebutton>direito</mousebutton> do mouse e escolher <menuchoice><guimenuitem>Cortar</guimenuitem></menuchoice>, ou simplesmente pressionar <keycombo action="simul"><keycap>Ctrl</keycap><keycap>X</keycap></keycombo>.</para>
<para>Para copiar uma tarefa agendada, primeiramente selecione a tarefa a ser copiada. Então selecione <menuchoice><guimenu>Editar</guimenu><guimenuitem>Copiar</guimenuitem></menuchoice>.</para>
<para>Alternativamente, você pode usar o botão <mousebutton>direito</mousebutton> do mouse e escolher <menuchoice><guimenuitem>Copiar</guimenuitem></menuchoice>, ou simplesmente pressionar <keycombo action="simul"><keycap>Ctrl</keycap><keycap>C</keycap></keycombo>.</para>
<para>Para colar uma tarefa agendada, primeiramente deve-se copiar ou cortar uma tarefa para a área de transferência. Uma vez que esta ação tenha sido realizada, pode-se colar a tarefa. Selecione então a pasta <guilabel>Tarefas</guilabel>. Finalmente, selecione <menuchoice><guimenu>Editar</guimenu><guimenuitem>Colar</guimenuitem></menuchoice>.</para>
<para>Alternativamente, você pode usar o botão <mousebutton>direito</mousebutton> do mouse e escolher <menuchoice><guimenuitem>Colar</guimenuitem></menuchoice>, ou simplesmente pressionar <keycombo action="simul"><keycap>Ctrl</keycap><keycap>V</keycap></keycombo>.</para>
<para>Para modificar uma tarefa agendada, primeiramente selecione a tarefa a ser modificada. Então selecione <menuchoice><guimenu>Editar</guimenu><guimenuitem>Modificar...</guimenuitem></menuchoice>.</para>
<para>Alternativamente, você pode usar o botão <mousebutton>direito</mousebutton> do mouse e escolher <menuchoice><guimenuitem>Modificar...</guimenuitem></menuchoice>, ou simplesmente pressionar <keycombo action="simul"><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>. Você verá o diálogo <guilabel>Editar Tarefa</guilabel>, que você pode modificar como descrito <link linkend="new-task">anteriormente</link>.</para>
<para>Para apagar uma tarefa agendada, primeiramente selecione a tarefa a ser excluida. Então selecione <menuchoice><guimenu>Editar</guimenu><guimenuitem>Apagar</guimenuitem></menuchoice></para>
<para>Alternativamente, você pode usar o botão <mousebutton>direito</mousebutton> do mouse e escolher <menuchoice><guimenuitem>Apagar</guimenuitem></menuchoice>.</para>
<para>Para habilitar ou desabilitar uma tarefa agendada, primeiramente selecione a tarefa desabilitada. Tarefas desabilitadas mostrarão <guilabel>Desabilitado</guilabel> em sua descrição. Então selecione <menuchoice><guimenu>Editar</guimenu><guimenuitem>Habilitado</guimenuitem></menuchoice></para>
<para>Alternativamente, você pode usar o botão <mousebutton>direito</mousebutton> do mouse e escolher <menuchoice><guimenuitem>Habilitado</guimenuitem></menuchoice>. Confirme que o nome do programa, os parâmetros e a descrição da tarefa agendada são mostrados corretamente.</para>
<para>Para executar uma tarefa agendada imediatamente, primeiramente selecione-a. Então escolha <menuchoice><guimenu>Editar</guimenu><guimenuitem>Executar Agora</guimenuitem></menuchoice>.</para>
<para>Alternativamente, você pode usar o botão <mousebutton>direito</mousebutton> do mouse e escolher <menuchoice><guimenuitem>Executar agora</guimenuitem></menuchoice>.</para>
<para>Para criar uma nova variável de ambiente, selecione a pasta <guilabel>Variáveis</guilabel>. Após, selecione <menuchoice><guimenu>Editar</guimenu><guimenuitem>Novo...</guimenuitem></menuchoice>.</para>
<para>Alternativamente, você pode usar o botão <mousebutton>direito</mousebutton> do mouse e escolher <menuchoice><guimenuitem>Novo...</guimenuitem></menuchoice>, ou simplesmente pressionar <keycombo action="simul"><keycap>Ctrl</keycap><keycap>N</keycap></keycombo>.</para>
<listitem><para>Entre o nome da variável de ambiente. Você pode usar a caixa da lista suspensa para selecionar dentre as variáveis de ambiente mais comuns utilizadas em tarefas agendadas. Estas incluem:</para>
<note><para>Assim como na criação de novas variáveis, as mudanças às variáveis não serão realmente realizadas até que o <filename>crontab</filename> tenha sido salvo.</para></note>
<para>Para recortar uma variável de ambiente, primeiro selecione-a. Após, clique em <menuchoice><guimenu>Editar</guimenu><guimenuitem>Remover</guimenuitem></menuchoice>.</para>
<para>Alternativamente, você pode usar o botão <mousebutton>direito</mousebutton> do mouse e escolher <menuchoice><guimenuitem>Cortar</guimenuitem></menuchoice>, ou simplesmente pressionar <keycombo action="simul"><keycap>Ctrl</keycap><keycap>X</keycap></keycombo>.</para>
<para>Para copiar uma variável de ambiente, primeiro selecione-a. Após, clique em <menuchoice><guimenu>Editar</guimenu><guimenuitem>Copiar</guimenuitem></menuchoice>.</para>
<para>Alternativamente, você pode usar o botão <mousebutton>direito</mousebutton> do mouse e escolher <guimenuitem>Copiar</guimenuitem>, ou simplesmente pressionar <keycombo action="simul"><keycap>Ctrl</keycap><keycap>C</keycap></keycombo>.</para>
<para>Para colar uma variável de ambiente, primeiramente uma variável deve ter sido recortada ou copiada para a área de transferência. Uma vez que isto tenha ocorrido, a opção de colar será habilitada. Então selecione a pasta <guilabel>Variáveis</guilabel>. Finalmente, selecione <menuchoice><guimenu>Editar</guimenu><guimenuitem>Colar</guimenuitem></menuchoice>.</para>
<para>Alternativamente, você pode usar o botão <mousebutton>direito</mousebutton> do mouse e escolher <menuchoice><guimenuitem>Colar</guimenuitem></menuchoice>, ou simplesmente pressionar <keycombo action="simul"><keycap>Ctrl</keycap><keycap>V</keycap></keycombo>.</para>
<para>Para modificar uma variável de ambiente, primeiro selecione-a. Entaõ clique em <menuchoice><guimenu>Editar</guimenu><guimenuitem>Modificar...</guimenuitem></menuchoice>. Alternativamente, você pode usar o botão <mousebutton>direito</mousebutton> do mouse e escolher <guimenuitem>Modificar...</guimenuitem>, ou simplesmente pressionar <keycombo action="simul"><keycap>Ctrl</keycap><keycap>O</keycap></keycombo>. Você verá o diálogo <guilabel>Editar Variável</guilabel>, que você pode modificar conforme descrito <link linkend="new-variable">anteriormente</link>.</para>
<para>Para remover uma variável de ambiente, primeiro selecione-a. Após clique em <menuchoice><guimenu>Editar</guimenu><guimenuitem>Remover</guimenuitem></menuchoice>.</para>
<para>Alternativamente, você pode usar o botão <mousebutton>direito</mousebutton> do mouse e escolher <menuchoice><guimenuitem>Apagar</guimenuitem></menuchoice>.</para>
<title>Habilitando/Desabilitando Variáveis de Ambiente</title>
<para>Para habilitar ou desabilitar uma variável de ambiente, primeiro selecione a variável desabilitada. Variáveis neste estado mostrarão a palavra <guilabel>Desabilitada</guilabel> em sua descrição. Então clique em <menuchoice><guimenu>Editar</guimenu><guimenuitem>Habilitar</guimenuitem></menuchoice>.</para>
<para>Alternativamente, você pode usar o botão <mousebutton>direito</mousebutton> do mouse e escolher<menuchoice><guimenuitem>Habilitado</guimenuitem></menuchoice>. Confirme que o nome e o velor da variável de ambiente são mostrados corretamente.</para>
<title>Salvando o <filename>crontab</filename></title>
<para>Uma vez que todas as tarefas agendadas tenham sido criadas e/ou propriamente modificadas, salve o <filename>crontab</filename> selecionando <menuchoice><guimenu>Arquivo</guimenu> <guimenuitem>Salvar</guimenuitem> </menuchoice>.</para>
<para>Alternativamente, você pode simplesmente pressionar<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>. Adições ou mudanças não serão efetuadas até que isto seja feito.</para>
<title>Imprimindo o <filename>crontab</filename></title>
<para>Para imprimir o <filename>crontab</filename> como ele foi salvo, clique em <menuchoice><guimenu>Arquivo</guimenu><guimenuitem>imprimir</guimenuitem></menuchoice>.</para>
<para>O diálogo de impressão padrão do &kde; será mostrado. Se você selecionar <guilabel>Expandir</guilabel> você verá duas opções extra específicas do &kcron; na caixa do diálogo de impressão.</para>
<para>Imprime os <filename>contab</filename>s para todos os usuários. Esta opção é habilitada apenas para usuários com privilégios de super-usuário.</para>
<answer><para>Adições ou mudanças à tarefas agendadas não são efetivadas até que o <filename>crontab</filename> tenha sido <link linkend="saving-crontab">salvo</link>.</para>
<listitem><para><command>cron</command>, por exemplo <command>vixie-cron</command>. O &kcron; usa o <filename>crontab</filename> para modificar as tarefas agendadas dos usuários.</para></listitem>
<listitem><para>&UNIX; de acordo com o padrão POSIX, como o disponibilizado pela glibc. O &kcron; usa algumas chamadas de sistema &UNIX; padrão para a localização de datas e horas.</para></listitem>