<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kljettool "<application>kljettool</application>">
]>
<book lang="pt">
<bookinfo>
<title>Manual do KLJetTool - Comando de LaserJets</title>
<authorgroup>
<author>
<firstname>Bernd Johannes</firstname>
<surname>Wuebben</surname>
<affiliation><address><email><ulink url="mailto:wuebben@kde.org">wuebben@kde.org</ulink></email></address></affiliation>
</author>
</authorgroup>
<date>Versão 0.2, 09-03-2000</date>
<releaseinfo><!-- information about this particular version --></releaseinfo>
<abstract>
<para>Este manual descreve a versão 0.2 do KLJetTool</para>
<para>KDE Kljettool</para><!-- Merge this with the previous paragraph; it comes from <META NAME="description" CONTENT="..."> --></abstract>
<keywordset>
<keyword>KDE</keyword>
</keywordset> 
</bookinfo>

<chapter id="introduction">
<title>Introdução</title>

<para>O KLJetTool é um programa que permite controlar os comandos especiais da tua impressora Hewlett Packard Laserjet.
Algumas das impressoras Hewlett Packard tal como a 5L ou a
6L não são controladas pelo hardware da impressora, mas sim, 
a partir de software. Contudo este software, normalmente, só está disponível para
Windows. O KLJetTool satisfaz o desejo de haver também software
para plataformas Unix. Deve funcionar com qualquer impressora que perceba
a PJL (Printer Job Language) da Hewlett Packard. Contudo algumas características podem
não ter efeito no teu modelo particular.</para>

<para>Espero que gostes desta pequena ferramenta.</para>

<para><literal remap="tt">Bernd Johannes Wuebben</literal></para>

<para><ulink url="mailto:wuebben@kde.org">wuebben@kde.org</ulink></para>
</chapter>

<chapter id="installation">
<title>Instalação</title>

<sect1 id="howtoobtainkljettool">
<title>Como Obter o KLJetTool</title>

<para>O KLJetTool faz parte do projecto KDE <ulink url="http://www.kde.org">http://www.kde.org</ulink>. 
O kljettool pode ser encontrado no pacote do kdeutils em <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, 
o site ftp do projecto KDE.</para>
</sect1>

<sect1 id="requirements">
<title>Requisitos</title>

<para>Para que o KLJetTool seja compilado com sucesso, necessitas das últimas versões das 
bibliotecas KDE. Todas as bibliotecas requeridas, tal como o o kljettool, podem ser encontradas 
em <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>. </para>
</sect1>

<sect1 id="compilationandinstallation">
<title>Compilação e Instalação</title>

<para>Para que o KLJetTool seja compilado e instalado com sucesso no teu sistema, escreve as seguintes linhas na 
directoria base da distribuição do KLJetTool: 
<screen>% ./configure 
% make 
% make install 
</screen> 
</para> 
 
<para>Como o KLJetTool usa o <literal remap="tt">autoconf</literal> não deverás ter nenhum problema a compilá-lo. 
Se tiveres problemas reporta-os, por favor, para as mailing lists do KDE.</para>
</sect1>
</chapter>

<chapter id="gettingkljettooltowork">
<title>Pondo o KLJetTool a Trabalhar</title>

<para>Algumas distribuições de Linux têm um subsistema de impressão demasiado ganancioso
que não respeita os ficheiro PJL gerados pelo LJetTool. 
O subsistema de impressão dessas distribuições não reconhece
um ficheiro PJL e tenta transformá-lo usando os seus filtros.
Isto faz com que o KLJetTool funcione mal.</para>

<para>Esta secção descreve os passos necessários para pôr o LJetTool a 
trabalhar num sistema RedHat Linux 5.0 (o KLJetTool não deve trabalhar correctamente nas
distribuições baseadas no RedHat linux 5.0). Eu penso que em outros sistemas,
os passos sejam similares. Estes passos que necessitam
de ser executados não são difíceis. Tudo o que é necessário fazer é
obrigar o teu subsistema de impressão a mandar ficheiros PJL
sem estarem modificados para a tua impressora.</para>

<para>Um sistema RedHat Linux não reconhece um ficheiro PJL,
e tenta modificá-lo e manda-o modificado para a
impressora; portanto temos que ensiná-lo a lidar 
com um ficheiro PJL. Contudo, antes de fazeres alguma modificação, sugiro-te 
que te certifiques que o teu sistema não é compatível com os ficheiro GPL.</para>

<para>Num sistema Redhat o script <literal remap="tt">/var/spool/lpd/lp/filter</literal>
é invocado de <literal remap="tt">/etc/printcap</literal>, e imprimido 
usando o comando 'lpr'. O filtro corre o programa 
'file' no ficheiro a ser impresso e o 'file' diz ao
script 
'filter' que tipo de documento é que estão a mexer.
Depois, dependendo do tipo do documento, o programa adequado 
executa e produz uma resposta num formato que a impressora entende. 
O programa 'file' usa o ficheiro <literal remap="tt">/etc/magic</literal>
para determinar o tipo de documento a ser impresso (ex.: PostScript,
dvi, text...)</para>

<para>Por exemplo, se eu imprimir um documento postscript, meuficheiro.ps, o 'file'
diz ao script 'filter' que estamos a lidar com um ficheiro postscript
e o 'filter' vai correr o ghostscript primeiro para converter o meuficheiro.ps
em pcl 5, uma linguagem que a impressora percebe, antes de mandar o 
ficheiro para a impressora. </para>

<para>Infelizmente um sistema RedHat não reconhece um ficheiro PJL e
tenta fazer coisas erradas com o ficheiro PJL, em vez de mandar 
logo o ficheiro para a impressora. </para>

<para>Para que o LJetTool trabalhe num sistema RedHat só precisamos de
fazer duas coisas:</para>

<para><itemizedlist>
<listitem>
<para> Acrescentar uma linha ao ficheiro <literal remap="tt">/etc/magic</literal> para que o programa 'file'
trabalhe correctamente e reconheça um ficheiro PJL como um ficheiro PJL.
   
Simplesmente basta adicionar as duas seguintes linhas no teu ficheiro /etc/magic.
O sitio onde tu insires as duas linhas no ficheiro <literal remap="tt">/etc/magic</literal> não tem importancia.
<screen># HP Printer Job Language, Bernd Wuebben (wuebben@math.cornell.edu)
0	string		\033%-12345X	 HP PJL printer commands
</screen>

</para>
</listitem>
<listitem>
<para>Agora, ensina ao script /var/spool/lpd/lp/filter o que fazer com um ficeiro PJL.
Isto pode ser feito adicionando a seguinte linha para o script 'filter':
<screen>   *pjl* )
                                              startpnt="INPUT-to-prdata";;
</screen>
		
			      
Se deres uma vista de olhos no script filter será fácil veres onde colocar
esta linha (cerca da linha 220 na minha versão). Estas linhas
simples dizem ao script para deixar um ficheiro PJL sózinho e não
o modificar.</para>
</listitem>
</itemizedlist>
</para>

<para>Este programa inclui uma cópia do meu script de filter tal como o meu /etc/magic. Podes
usá-los se tiveres problemas a fazer estas modificações.
Deves encontrá-lo no mesmo directório que a documentação do KLJetTool.</para>

<para>Adoraria ouvir instruções (se as houver) acerca do que deveria ser feito para que o KLJetTool trabalhasse 
noutros sistemas que usem um subsistema de filtro de impressão.</para>
</chapter>

<chapter id="usage">
<title>Utilização</title>

<para>O KLJetTool é muito fácil de usar. De facto a maioria das suas funções devem ser,
por si só, explicativas. Contudo, nesta altura, não tenho tempo para escrever um manual longo. 
Por favor contacta-me se o quiseres escrever (em inglês).</para>
</chapter>

<chapter id="copyright">
<title>Copyright</title>

<para><screen>                          KLJetTool 

Copyright 1997  Bernd Johannes Wuebben,  &lt;wuebben@math.cornell.edu&gt;

Este programa é software gratuito. Pode ser redistribuído e/ou 
moficado ao abrigo da General Public License, tal como 
está publicada pela Free Software Foundation, quer se trate da 
versão 2 da licença, ou (por opção do utilizador) de uma versão 
mais recente.

Este programa é distribuído com o propósito de vir a ser útil, mas 
SEM QUALQUER GARANTIA; nem mesmo as garantias implicitas 
de FORNECIMENTO DE COMPONENTES E/OU ACESSÓRIOS 
ou de AJUSTE PARA UM FIM ESPECÍFICO. Para mais 
pormenores, consultar a GNU General Public License.

Deverá ter sido distribuída uma cópia da GNU General Public 
License juntamente com este programa. Se não, contactar Free 
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

</screen>
</para>

<para>
Tradução da documentação por Ricardo Cruz <email>rick2@ricjoa.fe.up.pt</email>
</para>

</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
<!-- actualizado para a versão CVS :1.1: --> 
