summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/c-pascal/readme.pol
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-09 00:56:57 +0000
committerKarl Berry <karl@freefriends.org>2006-01-09 00:56:57 +0000
commitf07bb53970ee2ecc53f81a206a3d3a67ef665e4a (patch)
tree6f57a1d62971db79e5ff023bdfd83b22cb971dc9 /Master/texmf-dist/doc/generic/c-pascal/readme.pol
parent007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (diff)
doc 6
git-svn-id: svn://tug.org/texlive/trunk@85 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/c-pascal/readme.pol')
-rw-r--r--Master/texmf-dist/doc/generic/c-pascal/readme.pol92
1 files changed, 92 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/c-pascal/readme.pol b/Master/texmf-dist/doc/generic/c-pascal/readme.pol
new file mode 100644
index 00000000000..baa1bb3c1f5
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/c-pascal/readme.pol
@@ -0,0 +1,92 @@
+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. \InsertC{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. \InsertPascal{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ć.
+
+
+ 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