<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kljettool "<application>kljettool</application>">
 <!ENTITY % addindex "IGNORE">
 <![ %addindex; [ <!ENTITY docindex SYSTEM "docindex.docbook"> ]]>
]>
<book lang="pt-BR">
<bookinfo>
<title>Manual do KLJetTool</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>2 Novembro 1997</date>
<releaseinfo>Versão 0.2</releaseinfo>
<abstract>
<para>Este manual descreve o utilitário KLJetTool versão 0.2</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>KLjettool</keyword>
<keyword>printer</keyword>
<keyword>HP</keyword>
<keyword>Laserjet</keyword>
</keywordset>
</bookinfo>

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

<para>O KlJetTool é um programa que lhe permite ajustar os parâmetros de 
operação de sua HP LaserJet. Algumas das impressoras HP como a 5L e a
6L não têm mais um painel de controle; a impressora só pode ser
configurada por software. No entanto esse software está disponível apenas
para a plataforma Windows. O KLJetTool procura preencher essa lacuna na
plataforma Unix. Ele deve funcionar com qualquer impressora que entenda
o protocolo Hewlett Packard PJL (Printer Job Language). No entanto,
alguns recursos podem não fazer efeito em certos modelos.</para>

<para>Espero que você goste 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="instalao">
<title>Instalação</title>

<para><emphasis remap="sf">N do T: O utilitário KlJetTool vem com o pacote <literal remap="tt">kdeutils</literal>, que é
bem provável que você já tenha obtido e instalado. Se você já tem o
KDE instalado mas faltam-lhe os utilitários como KlJetTool, basta obter o
pacote <literal remap="tt">kdeutils</literal> e instalá-lo. Dificilmente você vai precisar obter o
KlJetTool em avulso, e portanto dificilmente precisará seguir
as instruções abaixo. Elas foram mantidas para que este documento fique
congruente com a versão original do autor.</emphasis></para>

<sect1 id="como-obter-o-kljettool">
<title>Como obter o KLJetTool</title>

<para>O KLJetTool é parte do projeto KDE
<ulink url="http://www.kde.org">http://www.kde.org</ulink>.
Ele pode ser encontrado em 
<ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, que é
o principal site FTP do projeto KDE.</para>
</sect1>

<sect1 id="pr-requisitos">
<title>Pré-requisitos</title>

<para>Para compilar o KLJetTool, você precisa das últimas versões de
<literal remap="tt">libkdecore</literal> e <literal remap="tt">libkfm</literal>. Todas as bibliotecas necessárias
bem como o KLJetTool em si podem ser encontrados em
<ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>. </para>
</sect1>

<sect1 id="compilao-e-instalao">
<title>Compilação e Instalação</title>

<para>Para compilar e instalar o KLJetTool em seu sistema, digite os seguintes
comandos no diretório-base da distribuição do KLJetTool:</para>

<para><screen>% ./configure
% make
% make install
</screen>
</para>

<para>Como o KLJetTool usa o <literal remap="tt">autoconf</literal>, você não deve ter nenhum problema
em compilá-lo. Se tiver algum problema, notifique as listas de discussão
do KDE.</para>
</sect1>
</chapter>

<chapter id="fazendo-o-kljettool-trabalhar">
<title>Fazendo o KLJetTool trabalhar</title>

<para>Algumas distribuições do Linux têm um subsistema de impressão egoísta
que não respeita os arquivos PJL gerados pelo KLJetTool; ele tenta
transformá-los usando filtros. Isto fará o KLJetTool funcionar mal.</para>

<para>Esta seção descreve os passos necessários para fazer o KLJetTool
trabalhar sob versões do RedHat anteriores à 5.0. (O KLJetTool
deve funcionar sem qualquer alteração em distribuições baseadas em
RedHat Linux 5.0 ou maior). Eu acredito que passos similares devem ser
necessários em outros sistemas. No entanto, as tarefas que precisam ser
executadas não são difíceis. Tudo que precisa ser feito é ter certeza
que o subsistema de impressão manda arquivos PJL para a impressora sem
qualquer modificação.</para>

<para>Um sistema RedHat não reconhece <emphasis>a priori</emphasis> o formato PJL,
e tenta fazer coisas feias com ele ao invés de mandá-lo direto
para impressora; então precisamos ensiná-lo como lidar com o formato
PJL. No entanto, antes que você faça as mudanças sugeridas aqui,
teste se o KLJetTool realmente não funciona em seu sistema. Se
funcionar, não há o que alterar.</para>

<para>Acredito que outras distribuições que usem subsistemas de impressão
'sofisticados' como o do RedHat devam ter problemas semelhantes.</para>

<para>Num sistema RedHat, o script
<literal remap="tt">/var/spool/lpd/lp/filter</literal>
é invocado de
<literal remap="tt">/etc/printcap</literal>, 
a cada vez que algo é impresso via o comando <literal remap="tt">lpr</literal>. O filtro aciona o
programa <literal remap="tt">file</literal> que analisa o arquivo a ser impresso, e <literal remap="tt">file</literal> dirá
ao script <literal remap="tt">filter</literal> que tipo de documento é aquelo.
Então, dependendo do tipo de documento, o programa certo é chamado para
produzir saída num formato que a impressora pode entender. O programa
<literal remap="tt">file</literal> usa o programa
<literal remap="tt">/etc/magic</literal>
para determinar o tipo de documento a ser impresso (exemplos: Postscript,
dvi, texto, etc.)</para>

<para>Por exemplo, se eu imprimo um documento postscript, <literal remap="tt">arquivo.ps</literal>, o 
utilitário <literal remap="tt">file</literal> diz ao script <literal remap="tt">filter</literal> que estamos lidando
com um arquivo Postscript, e <literal remap="tt">filter</literal> acionará o <emphasis>Ghostscript</emphasis>
para converter <literal remap="tt">arquivo.ps</literal> para <emphasis>PCL 5</emphasis>, uma linguagem que a
minha LaserJet entende, antes de mandá-lo para a impressora.</para>

<para>Infelizmente um sistema RedHat não reconhece arquivos PJL e tenta
fazer a coisa errada com eles ao invés de mandá-lo direto para
a impressora.</para>

<para>Para fazer o KLJetTool funcionar em um sistema RedHat, precisamos
fazer apenas duas coisas:</para>

<para><itemizedlist>
<listitem>
<para> Adicione uma linha ao arquivo <literal remap="tt">/etc/magic</literal> de modo que o
programa <literal remap="tt">file</literal> reconheça corretamente um arquivo PJL como tal:

<screen># HP Printer Job Language, Bernd Wuebben (wuebben@math.cornell.edu)
0	string		\033%-12345X	 HP PJL printer commands
</screen>

</para>
</listitem>
<listitem>
<para> ensine o script /var/spool/lpd/lp/filter script a agir corretamente
com arquivos PJL, adicionando duas linhas a ele:
<screen>   *pjl* )
                                              startpnt="INPUT-to-prdata";;
</screen>
		
			      
Se você der uma olhada no script de filtro, ficará claro onde adicionar
as linhas (mais ou menos na linha 220 da versão 1 que eu tenho). Estas
linhas instruem ao script deixar em paz os arquivos PJL e mandá-los
direto para a impresssora.</para>
</listitem>
</itemizedlist>
</para>

<para>Eu incluí uma cópia de meu script de filtragem, bem como meu arquivo
<literal remap="tt">/etc/magic</literal>. Você pode usá-los se tiver problemas ao tentar
realizar as modificações sugeridas mais acima. Você deve ser capaz
de encontrá-los no mesmo diretório em que você encontrou a documentação
do KLJetTool.</para>

<para>Eu adoraria receber instruções sobre o que precisa ser feito para que
o KLJetTool funcione em outros sistemas que usem subsistemas elaborados
de filtragem de impressão.</para>
</chapter>

<chapter id="uso">
<title>Uso</title>

<para>O KLJetTool é muito simples de usar. De fato, muitas de suas funções
devem ser auto-explicativas. Isso é bom, pois eu realmente não tenho 
tempo de escrever um manual mais longo para ele. Por favor contacte-me
se você gostaria de escrevê-lo.</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; você pode redistribuí-lo e/ou
modificá-lo sob os  termos  da  GNU General Public License  como
publicado  pela Free Software Foundation;  qualquer uma das duas
versões de Licença, ou (em sua opinião) alguma versão anterior.

Este  programa é distribuído com  a esperança de que seja  útil,
mas SEM NENHUMA GARANTIA;  sem conformidade com implicações    e
garantias de ACEITAÇÃO NO MERCADO  ou  AJUSTES  PARA  PROPÓSITOS
PARTICULARES.   Veja  a  GNU  General  Public License para  mais
detalhes.

Você  deveria  ter  recebido  uma  cópia  da GNU  General Public
License junto com este programa; se não recebeu, escreva para  a
Free   Software  Foundation,  Inc.,   675  Mass Ave,  Cambridge, 
MA 02139, USA.

</screen>
</para>
</chapter>
<![ %addindex; [ &docindex; ]]>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->
