Polskie robaczki w standardzie ISO-Latin2.
=======================================================================

   CAP (C albo Pascal)  ---  makra do sk�adu program�w w C i Pascalu

=======================================================================


 Zawarto��
-----------
Ten pakiet makr sk�ada si� z trzech plik�w:
  cap_c.tex     ---  makra do sk�adu program�w w j�zyku C
  cap_pas.tex   ---  makra do sk�adu program�w w Pascalu
  cap_comm.tex  ---  pomocnicze makra i deklaracje u�ywane do sk�adania
                     program�w w obu j�zykach; ten plik nie zawiera
                     �adnych makr po�ytecznych dla u�ytkownika


 Programy w C
--------------
W pliku cap_c.tex znajduj� si� definicje dw�ch makr:

  1. \BeginC ... \EndC
       Pomi�dzy te komendy nale�y wstawi� dowolny program �r�d�owy
       w j�zyku C. Tre�� programu zostanie sformatowana z wykorzystaniem
       odpowiednich czcionek. Rozpoznawane s� nast�puj�ce elementy
       programu:
        * s�owa kluczowe --- domy�lnie wyr�niane s� pogrubieniem
        * teksty --- wszystko to, co wewn�trz apostrof�w; domy�lnie pochylone
        * komentarze --- zar�wno /*takie...*/ jak i  //takie... ,
          ale nie zagnie�d�one; kursywa typewriter
        * symbole --- operatory, nawiasy, itp.; typewriter
        * dyrektywy kompilatora --- sk�adane pochylon� czcionk� typewriter
        * identyfikatory --- wszystko, co nie jest �adnym z powy�szych;
          kursywa
       Makro nie ingeruje w uk�ad programu. Wci�cia s� pozostawione takie,
       jakie s� w programie �r�d�owym. Podzia� na linie r�wnie� nie jest
       zmieniany.
       UWAGA: W trakcie kompilacji makro \BeginC ... \EndC wczytuje ca�y
       program do pami�ci TeXa. Z tego powodu mo�na spodziewa� si� k�opot�w
       sk�adaj�c tym makrem bardzo du�y program. W mojej konfiguracji
       (emTeX pod DOSem) wszystko dzia�a bez zarzutu je�li program jest
       nie wi�kszy ni� oko�o 15KB. Je�li NAPRAWD� konieczne jest wstawnienie
       ogromnego programu bezpo�rednio do pliku TeXowego, konieczny b�dzie
       podzia� programu na mniejsze cz�ci, z kt�rych ka�da b�dzie uj�ta
       w komendy \BeginC ... \EndC.

  2. \InputC{nazwapliku}
       Wstawia program w j�zyku C z pliku zewn�trznego. Program zostanie
       sformatowany jak w poprzednim przypadku. Przypomnienie dla pracuj�cych
       pod DOSem: w nazwie pliku wszystkie wty�ciachy nale�y zast�pi�
       ciachami.
       To makro nie nak�ada �ADNYCH ogranicze� na rozmiar programu --- czyta
       wskazany plik linia po linii, wi�c nie grozi mu wyczerpanie pami�ci.

Lista s��w kluczowych znajduje si� w pliku cap_c.tex. Nie gwarantuj�, �e
jest kompletna, wi�c w razie potrzeby mo�na j� poprawi�.


 Programy w Pascalu
--------------------
Aby sk�ada� programy w Pascalu nale�y za��czy� plik cap_pas.tex. Zawiera
on r�wnie� dwa makra:

  1. \BeginPascal ... \EndPascal

  2. \InputPascal{nazwapliku}

Dzia�aj� one analogicznie. W przypadku \BeginPascal ... \EndPascal
obowi�zuj� podobne ograniczenia na wielko�� formatowanego programu.
W programie rozpoznawane s� zar�wno {takie} jak i (*takie*) komentarze.

Lista s��w kluczowych pochodzi z Pomocy Borland Delphi. W razie potrzeby
mo�na j� zmodyfikowa�.


 Wsp�lne
---------
Czcionki u�ywane do sk�adania program�w s� zadeklarowane na pocz�tku
pliku cap_comm.tex. W razie potrzeby mo�na je �atwo przedefiniowa�.
Osoby u�ywaj�ce czcionek PL zamiast CM b�d� musia�y zmodyfikowa� dwie
linie w tym pliku. S� one wyra�nie zaznaczone.


 Uwaga
-------
Je�li modyfikujesz kt�ry� z plik�w, zaznacz wyra�nie swoje zmiany. Nie
chc� bra� odpowiedzialno�ci na modyfikacje wprowadzone przez innych.


------------

  Micha� Gulczy�ski
  mgulcz@we.tuniv.szczecin.pl