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
